Job Format (for Beginners)
- ICETOOL is used to SORT, COPY and MERGE applications.
- ICETOOL can be called from a PGM, and a parameter list supplies its operators. For example -
//STEP01 EXEC PGM=ICETOOL .... .... //TOOLIN DD * parameters-list /*
- ICETOOL gives a return code for each operation and prints messages for each operation.
ICETOOL Job Format
//JOBNAME JOB JOB-CARD-PARAMETERS //* //STEP EXEC PGM=ICETOOL (or PGM=program-name) //* TOOLMSG or DFSMSG DD statements are always required //TOOLMSG DD SYSOUT=A (or DSN=...) //DFSMSG DD SYSOUT=A //* The TOOLIN DD Statement is required when ICETOOL statements coded //TOOLIN DD * ICETOOL statements /* //* Below DD statements are required according to usage in ICETOOL statements //indd DD ... . . //outdd DD ... . . //savedd DD ... . . //listdd DD SYSOUT=A (or DSN=...) . . //countdd DD ... . . //xxxxCNTL DD * DFSORT control statements /* . .
ICETOOL JCL Statements
- EXEC PGM=ICETOOL - Used to call ICETOOL utility directly.
- TOOLMSG - Specifies where to write the ICETOOL processing messages.
- DFSMSG - Specifies where to write the DFSORT processing messages.
- TOOLIN - Specifies the ICETOOL statements for DFSORT.
- indd DD - Specifies an input file for a COPY, COUNT, DATASORT, DISPLAY, MERGE, OCCUR, RANGE, RESIZE, SELECT, SORT, SPLICE, STATS, SUBSET, UNIQUE, or VERIFY operations.
- outdd DD - Specifies an output file for COPY, DATASORT, MERGE, RESIZE, SELECT, SORT, SPLICE, or SUBSET operations.
- savedd DD - Specifies an output file for a SELECT or SUBSET operations.
- listdd DD - Specifies a list file for a DEFAULTS, DISPLAY, or OCCUR operations.
- countdd DD - Specifies an output file for a COUNT operation.
- xxxxCNTL DD - Having DFSORT control statements for COPY, COUNT, DATASORT, MERGE, RESIZE, SELECT, SORT, SPLICE, or SUBSET operations.
ICETOOL Operator Statements
//JOBNAME JOB JOB-CARD-PARAMETERS //* //STEP EXEC PGM=ICETOOL (or PGM=program-name) ... ... //TOOLIN DD * ICETOOL Operator Statements /*
- Each ICETOOL operator statement represents a task that ICETOOL needs to perform.
- Any number of operators can be specified and in any order.
- The general format for all ICETOOL statements is -
operator operand ... operand
- The operator is one of the seventeen ICETOOL operators.
- One or more blanks can be used before the operator and between operands.
- Columns 1-72 are considered for coding, and columns 73-80 are ignored.
- The continuation can be indicated by a dash (-) after the operator or any operand.
- Asterisk (*) in column 1 indicates a comment statement. For example -
//STEP01 EXEC PGM=ICETOOL .... .... //TOOLIN DD * * comment line parameters-list /*
- Comment statements are printed commonly with other ICETOOL statements.
- Blank in columns 1-72 indicates a blank statement.For example -
//STEP01 EXEC PGM=ICETOOL .... .... //TOOLIN DD * icetool-statement1 icetool-statement2 /*
- Blank statements are ignored since ICETOOL prints blank lines where suitable.
ICETOOL Return Codes
ICETOOL sets a return code for each operation it performs. ICETOOL sets the return code to the highest operator return code for the step.
The return codes are –
- 0 - Successful completion. No errors were detected.
- 4 - Successful completion. DFSORT detected one or more warnings.
- 8 - Unsuccessful completion. RC8 was used for COUNT when the criteria were met.
- 12 - Unsuccessful completion. ICETOOL detected one or more errors.
- 16 - Unsuccessful completion. DFSORT detected one or more errors.
- 20 - Message data set error. The TOOLMSG DD statement was not present or the TOOLMSG data set was not opened.
- 24 - Unsupported operating system.