Working with Workload Objects › z/OS Jobs › Define a z/OS-Regular Job › Condition Codes

Condition Codes

Within the z/OS-Regular job definition dialog, you can use the Condition Codes page to specify the codes that indicate a successful or failed job.

You can define condition codes for jobs, steps, procedure steps, or programs as follows:

• A condition code for one number or a range of numbers between 1 and 4095 (ranges are separated by colons, such as 1:4095).
• A system abend code (Sccc), such as S0C1 or SB37.
• A user abend code (Unnnn), such as U0001 or U0462. The nnnn must be exactly four decimal digits and cannot exceed 4095.

For each condition code or range of condition codes, you can indicate whether the server is to interpret the code or range as a success or a failure. You can also indicate whether the job should continue or stop running. Each specification becomes a separate item. Together these specifications form a list of condition codes.

Example: Complete a Job Based on Specific Return Codes

Suppose that you define condition codes so that a job completes successfully only when the return code is 0, 1, 2, 3, 4, or 999.

To complete a job based on specific return codes

1. Open the z/OS-Regular job for which you want to specify condition codes.
2. Click Condition Codes in the left pane.

   The Condition Codes page opens in the right pane.

3. Click Add.

   A new row is added to the Condition code list.

4. Enter 1:4 in the Return Code field, select SUCCESS in the Interpret As drop-down list, and select CONTINUE in the Action Type drop-down list.
5. Click Add.

   A new row is added to the Condition code list.

6. Enter 999 in the Return Code field, select SUCCESS in the Interpret As drop-down list, and select CONTINUE in the Action Type drop-down list.
7. Click Add.

   A new row is added to the Condition code list.

8. Enter 5:998 in the Return Code field, select FAILURE in the Interpret As drop-down list, and select STOP in the Action Type drop-down list.
9. Click OK.