ICETOOL return codes

ICETOOL sets a return code for each operation it performs in STOP or CONTINUE mode and passes back the highest return code it encounters to the operating system or the invoking program.

For successful completion of all operations, ICETOOL passes back a return code of 0 or 4 to the operating system or the invoking program.

For unsuccessful completion due to an unsupported operating system, ICETOOL passes back a return code of 24 to the operating system or invoking program.

For unsuccessful completion of one or more operations, ICETOOL passes back a return code of 8, 12, 16, or 20 to the operating system or the invoking program.

The meanings of the return codes that ICETOOL passes back (in register 15) are:

0

Successful completion. All operations completed successfully.

4

Successful completion. All operations completed successfully. Either:

RC4 was specified for an ICETOOL COUNT operator and the record count met the specified criteria, or
DFSORT passed back a return code of 4 for one or more operations. See DFSORT messages and return codes for details.

8

Unsuccessful completion. RC8 was specified for an ICETOOL COUNT operator and the record count met the specified criteria.

12

Unsuccessful completion. ICETOOL detected one or more errors that prevented it from completing successfully. Messages for these errors were printed in the TOOLMSG data set.

16

Unsuccessful completion. DFSORT detected one or more errors that prevented ICETOOL from completing successfully. Messages for these errors were printed in the DFSMSG data set.

20

Message data set error. The TOOLMSG DD statement was not present or the TOOLMSG data set was not opened.

24

Unsupported operating system. This operating system is not supported by this release of DFSORT.