Return Codes of z/OS Jobs

The z/OS Agent logs all errors that occur in the report (SREP) of the corresponding Job. Depending on how the Job has ended, the Agent also sets a return code.

Notes:

You can set the return code that defines that the Job should abort on the Runtime page in the Job object properties.
You can define value ranges for the steps instead of individual return codes. The Agent compares the result of a step execution with the defined step list. For more information, see the Return Code Handling section on the Runtime page. If you select Completion Code, additional options display where you can specify a return code for each step in the Job.

For more information, see Runtime Page.

z/OS distinguishes between the following types of return codes:

Condition Code
Z/OS: 0 to 4095
AE: 0000 - 0FFF (0 to 4095)
User Abend
z/OS: U0000 to U4095
AE: 1000 - 1FFF (4096 to 8191)
System Abend
z/OS: S000 to SFFF
AE: 2000 - 2FFF (8192 to 12287)

The Agent uses number ranges of 4 KB each to assign the return codes.

Important! The return code of a Job object must be specified as a decimal number. Therefore, you must convert User and System Abends to decimal numbers.

Example

Return code SB37 indicates a full volume while a file is being written. The corresponding decimal number is 11063.