An overview of the job control language (JCL) statements for ICETOOL is in Table 1 followed by discussions of each ICETOOL DD statement and the use of reserved DD statements and ddnames.

TOOLMSG DD Statement

Defines the ICETOOL message data set for all operations. ICETOOL messages and statements appear in this data set. ICETOOL uses RECFM=FBA, LRECL=121 and the specified BLKSIZE for the TOOLMSG data set. If the BLKSIZE you specify is not a multiple of 121, ICETOOL uses BLKSIZE=121. If you do not specify the BLKSIZE, ICETOOL selects the block size as directed by the SDBMSG installation option (see z/OS DFSORT Installation and Customization).

The TOOLMSG DD statement must be present.

DFSMSG DD Statement

Defines the DFSORT message data set for all operations. The DFSORT messages and control statements from all ICETOOL calls to DFSORT appear in this data set. Refer to the discussion of SYSOUT in System DD statements for details.

Either a DFSMSG DD statement or an SSMSG DD statement must be present. If both are present, ICETOOL uses DFSMSG as the DFSORT message data set. If a DFSMSG DD is not present, but an SSMSG DD is present, ICETOOL uses SSMSG as the DFSORT message data set.

Note: A SYSOUT data set should be used for the DFSORT message data set (for example, //DFSMSG DD SYSOUT=*). If you define the DFSORT message data set as a temporary or permanent data set, you will only see the DFSORT messages from the last call to DFSORT, unless you allocate a new data set using a disposition of MOD.

//SYMNAMES DD

Defines the SYMNAMES data set containing statements to be used for symbol processing. See Using symbols for fields and constants for complete details.

//SYMNOUT DD

Defines the data set in which SYMNAMES statements and the symbol table are to be listed. See Using symbols for fields and constants for complete details.

TOOLIN DD statement

Defines the ICETOOL statement data set that must have the following attributes: RECFM=F or RECFM=FB and LRECL=80.

If the TOOLIN Interface is used, the TOOLIN DD statement must be present. If the Parameter List Interface is used, the TOOLIN DD statement is not required and is ignored if present.

indd DD Statement

Defines an input data set for an operation. Refer to SORTIN DD statement (copy or sort) or SORTINnn DD statement (merge) for details. ICETOOL imposes the additional restriction that the LRECL of this data must be at least 4.

An indd DD statement must be present for each unique indd name specified in each FROM operand.

outdd DD Statement

Defines an output data set for a COPY, DATASORT, MERGE, RESIZE, SELECT, SORT, SPLICE or SUBSET operation. Refer to SORTOUT and OUTFIL DD statements for details.

An outdd DD statement must be present for each unique outdd name specified in each TO operand.

savedd DD Statement

Defines an output data set for a SELECT or SUBSET operation. Refer to SORTOUT and OUTFIL DD statements for details.

A savedd DD statement must be present for each unique savedd name specified in each DISCARD operand.

listdd DD Statement

Defines the list data set for a DEFAULTS, DISPLAY, or OCCUR operation. For each listdd data set, ICETOOL uses RECFM=FBA (or RECFM=FB for DISPLAY or OCCUR with the NOCC operand specified), LRECL=121 (for DEFAULTS) or the LRECL specified in the WIDTH operand or calculated as needed if WIDTH is not specified (DISPLAY and OCCUR), and the specified block size. If the BLKSIZE you specify is not a multiple of the LRECL, ICETOOL uses BLKSIZE=LRECL. If you do not specify BLKSIZE, ICETOOL selects the block size as directed by the LISTSDB or LISTNOSDB option if specified, or otherwise as directed by the SDBMSG installation option (see z/OS DFSORT Installation and Customization).

A listdd DD statement must be present for each unique listdd name specified in each LIST operand.

countdd DD Statement

Defines the output data set for a COUNT operation. For each countdd data set, ICETOOL uses RECFM=FB, the LRECL specified in the WIDTH operand or calculated if WIDTH is not specified, and the specified block size. If the BLKSIZE you specify is not a multiple of the LRECL, ICETOOL uses BLKSIZE=LRECL. If you do not specify BLKSIZE, ICETOOL uses the system-determined optimum block size.

A countdd DD statement must be present for each unique countdd name specified in each WRITE operand.

xxxxCNTL DD Statement

Defines the DFSORT control statement data set for a COPY, COUNT, DATASORT, MERGE, RESIZE, SELECT, SORT, SPLICE or SUBSET operation. Refer to SORTCNTL DD statement for more details.

An xxxxCNTL DD statement must be present for each unique xxxx specified in each USING operand.