SET (Set Processing Options)

To change the installation defaults that apply to all users and batch jobs, see the File Manager Customization Guide.

system

Default. This option can be set as part of the customization options for your site. If you do not specify the ABENDCC parameter in the SET function, the installation setting is used. The installation setting defaults to NONE, but if it is set as an integer, that integer becomes the default setting for File Manager batch processing.

NONE

The job step is finished with a non-zero return code.

num

Must be specified as an integer, from 1 to 32767 (0 is treated as NONE).

Use this parameter to transform an original or customized non-zero return code to an abend. If the return code is greater than or equal to num, File Manager abends with U999, Reason Code=888 (hex: 378). Abnormal termination of a File Manager step prevents the execution of successors (steps and/or jobs). You can specify the num value appropriately to suit the customized return codes issued by File Manager functions.

Note: In addition, specification of any non-zero integer prevents File Manager from intercepting abnormal terminations (system abends).

BOTH

Translates tape input from ASCII format to EBCDIC format, and translates tape output from EBCDIC format to ASCII format.

IN

Translates tape input from ASCII format to EBCDIC format.

NO

Does not translate data.

OUT

Translates tape output from EBCDIC format to ASCII format.

This processing option applies to all tape input and output functions except: Initialize Tape, Tape Browse, Tape Label Display, and Tape Update. For Tape Label Display, ASCII translation is automatically performed when needed. For Initialize Tape and Tape Browse, you can specify ASCII input or output when invoking the function. For the other (non-tape) functions, ASCII translation is not supported by FMN.

NO

Fields starting beyond the record’s boundary are not suppressed.

YES

Fields starting beyond the record’s boundary are suppressed.

NO

Default. A period character is used as the decimal separator.

YES

A comma character is used as the decimal separator when processing numeric values with the following exceptions where a period character (.) is always used instead:

• Numeric edited fields. (Type ZE and ZA).
• External floating-point fields. (Type FE).
• Any numeric value specified in a template. For example: Criteria or data create.

ABSOLUTE

File Manager interprets cylinder-head and track-number values as actual physical addresses.

RELATIVE

File Manager interprets cylinder-head and track-number values as relative to the start of the data set.

The DATAHDR setting affects only DSP and FCH processing.

NO

Record header information is not included in character-format output. Specify DATAHDR=NO to left-justify the data in the print output, without header information.

YES

Record header information is included in character-format output.

Specifies whether additional data set information for input and output sources should be produced in batch reports for the DSP, DSM, DSC, and FCH commands.

NO

No additional data set information is generated.

YES

Generates data set information including DSORG, RECFM, LRECL, BLKSIZE, and VSAM attributes including average record length, maximum record length, key offset, key length and reuse, for input and output data sets when applicable.

ACROSS

The hexadecimal digits are displayed as 2 groups of 4 full words resulting in 32 hexadecimal digits followed by the EBCDIC character display to the right of the hexadecimal display.

UPDOWN

The two digits making up the hexadecimal representation of each EBCDIC character are displayed vertically directly under that character.

delimiter

A 1- to 8-character delimiter. For character data, enclose the string in quotation marks if it contains blanks, commas, or lowercase letters. For hexadecimal data, enter an X followed by the string enclosed in quotation marks (for example, X'04').

For some tape functions, you specify the number of files to process in an NFILES keyword. If you specify NFILES=EOD, then files are processed until the first record that begins with the EOD delimiter. However, there is no default EOD delimiter for tape input. So, if you want to specify NFILES=EOD, then you must first use the SET function to specify an EOD delimiter; otherwise, File Manager issues an error.

NO

A header page is not included in print output.

Note: For the HEADERPG=NO setting to be effective for the duration of the entire batch processing, you must specify it as the first File Manager control statement. The HEADERPG=NO setting also suppresses the output of the message "FMN0062I current SET function values" as long as it is active.

YES

A header page is included in print output.

• A prior SET function set USEIOX to YES.
• The current SET function is setting USEIOX to YES.

sysexit

Default. If you specify USEIOX=YES and do not supply a user I/O exit name, File Manager uses the name of the exit provided by either a prior SET function in the current job step, or the installation customization options. If you specify USEIOX=YES and no installation default has been provided, you must specify IOX=ioxname.

Note: If you have selected batch processing in an online panel, the generated JCL statements use the default name provided in your Set System Processing Options panel.

ioxname

The name of a PDS(E) member of a data set that has been provided to File Manager in the STEPLIB concatenation.

COMPAT

File Manager reformats the physical JCL records into a single logical JCL statement for processing and then builds a new set of physical JCL records.

RECORD

File Manager processes each physical JCL record as is, unless it contains a parameter field enclosed in apostrophes. If this parameter continues across multiple records, the records are flowed together to join the parameter before processing.

For instructions on installing translated messages and panels, and the keyword values that you can specify for the LANGUAGE processing option, see the File Manager Customization Guide.

OFF

No optimization is performed.

ON

This option is designed to improve performance when scrambling large amounts of data where the Repeat or Random option has been specified for various fields.

MAX

This option is designed to provide the maximum performance improvement.

Note: If Repeat or Random has been specified for a field and a value list is not provided then duplicate alphanumeric characters within a field will yield the same scrambled character.

$$FILEM SET OPSCRAM=ON
$$FILEM DSC ,
$$FILEM DSNIN=FMNAPAR.PH31085.DATA,
$$FILEM MEMBER=RFTEST,
$$FILEM TCIN=FMNAPAR.PH31085.TEMPLATE(RFTEST),
$$FILEM DISP=OLD,
$$FILEM TCOUT=FMNAPAR.PH31085.TEMPLATE(RFTEST),
$$FILEM MEMOUT=RFTEST,
$$FILEM DSNOUT=FMNAPAR.PH31085.DATAO.REPEAT.FIELD

OFF

Records are not padded with blanks or a specified character, except where required by the output record format. If the output records are fixed format, they are padded with nulls ('00'x), as required to match the output record length. Variable and undefined format outputs are not padded.

Output records are always truncated if they exceed the maximum record length (for fixed or variable) or maximum block length (for undefined formats). However, trailing blanks that fit within the maximum length are not stripped from the record.

ON

Records are modified, depending on the output record format. For fixed-format output, input records that do not fit are truncated or padded with blanks. For variable or undefined output, trailing blanks are stripped from the input record. (For reasonable results, do not try to deblock and pad in one run.)

c

The value used for padding records. This can be a single character or a hexadecimal value. For example, you can enter an X followed by two hexadecimal characters enclosed in quotation marks (X'00'). In addition, for variable or undefined output, a trailing series of the specified character is stripped from the input record. Essentially, this option has the same effect as PAD=ON except that the specified character c is used for padding or truncation instead of blanks.

NO

Print output from each function does not begin on a new page.

YES

Print output from each function begins on a new page.

To browse this data set, enter PB on any File Manager Command line. Then, to forward the contents of the data set to PRTCLASS class, enter PRINT. For details, see Printing from File Manager.

80

The line length of print output is 80 characters, suitable for a terminal.

132

The line length of print output is 132 characters, suitable for a printer.

SYSPRINT

Send print output to the current SYSPRINT allocation.

TERMINAL

Send print output to the TSO terminal.

PRINTDSN

Output is accumulated in the print data set specified in the Data set name field (PRINTDSN). This data set can browsed using the PB command or sent for printing to the JES spool queue with class specified in the Output class field using the PRINT command while browsing.

REXX

Send output to a REXX stem variable. Each line corresponds to a variable named FILEM.nnn. FILEM.0 contains the line count.

When you use the PRINT primary command in Print Browse (option 3.9), or if you specify batch execution in a File Manager panel, then print output is always sent to a JES class.

OLD

The print data set is cleared before each print operation, and print output is written from the beginning of the data set.

MOD

Default setting. Print output is appended to the existing print data set.

OFF

No translation performed. Use PRTTRANS=OFF to support special print chains. This might make printing faster.

ON

Non-printable characters translated to blanks using a translate table.

For instructions on altering the print translate table, see the File Manager Customization Guide.

(n,m)

Print output is limited to the data from columns (bytes) n through m. An asterisk (*) specified for m indicates the end of the record.

(1,*)

The entire record (or block) is printed.

AL

ANSI Version 3 labels are created. (“Version 3” refers to ANSI X3.27–1978, ISO 1001–1979, and FIPS 79 standards.)

AL4

ANSI Version 4 labels are created. (“Version 4” refers to ANSI X3.27–1987 level 4 and ISO 1001–1986(E) standards.)

SL

EBCDIC labels are created.

For detailed information about ANSI tape labels, see z/OS DFSMS: Using Magnetic Tapes.

This parameter only affects Initialize Tape (option 4.12).

Example 1

If the userid is XXXX, then specifying &USER.1.TEMP results in a high-level-qualifier of XXX1.TEMP

Example 2

If the userid is ZZZZ then specifying FMN.&USER..ABCD results in a high-level-qualifier of FMN.ZZZZ.ABCD

NO

Do not invoke a user I/O exit.

YES

Invoke a user I/O exit. This option is only effective if your site customization for File Manager allows user I/O exits on a site-wide basis.