DFSORT messages and return codes

You can determine, during installation or run-time, whether DFSORT writes messages to the message data set, to the master console, or to both. You can also direct an Extended Function Support program to write messages to the message data set.

Messages written to the message data set can be either critical error messages, informational error messages, or diagnostic messages, as determined during installation or run-time.

Messages written to the master console can be either critical error messages or informational error messages, as determined during installation.

See z/OS DFSORT Messages, Codes and Diagnosis Guide for complete information about DFSORT messages.

For successful completion, DFSORT 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, DFSORT passes back a return code of 24 to the operating system or the invoking program.

For unsuccessful completion with NOABEND in effect, DFSORT passes back a return code of 16, 20 or 28 to the operating system or the invoking program.

For unsuccessful completion with ABEND in effect, DFSORT issues a user abend with the appropriate code as specified by the ABCODE installation option (either the error message number or a number between 1 and 99).

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

0

Successful completion. DFSORT completed successfully.

4

Successful completion. DFSORT completed successfully, and:

OVFLO=RC4 was in effect and summary fields overflowed, or
PAD=RC4 was in effect and the SORTOUT LRECL was larger than the SORTIN/SORTINnn LRECL (LRECL padding), or
TRUNC=RC4 was in effect and the SORTOUT LRECL was smaller than the SORTIN/SORTINnn LRECL (LRECL truncation), or
SPANINC=RC4 was in effect and one or more incomplete spanned records was detected, or
NULLOUT=RC4 was in effect and there were no records for the SORTOUT data set, or
NULLOFL=RC4 was in effect and there were no data records for an OUTFIL data set.

16

Unsuccessful completion. DFSORT detected an error that prevented it from completing successfully.

20

Message data set missing. Installation option NOMSGDD=QUIT was in effect and neither a message data set DD statement nor a SYSOUT DD statement was provided.

24

Unsupported operating system. This release of DFSORT does not support this operating system.

28

Wrong entry name. DFSORT detected one of the following errors related to the program entry name that prevented it from completing successfully:

DFSORT was invoked directly with PGM=ICEMAN64 or PGM=SORT64 (instead of with PGM=ICEMAN or PGM=SORT).
DFSORT was invoked from a program using entry name ICEMAN64 or SORT64, and an extended invocation parameter list, or a 24-bit invocation parameter list (instead of a 64-bit invocation parameter list).
DFSORT was invoked from a program using an entry name other than ICEMAN64 or SORT64 (for example, ICEMAN or SORT) and a 64-bit invocation parameter list.