Define and Maintain the Workload Best Practices › Jobs › Condition Code Testing

Condition Code Testing

Successful jobs end with a 0 return code. If a job ends with a nonzero return code, it is usually a bad completion and requires a restart. You can use the DB.1 panel to set unacceptable return codes from jobs.

EXECUTION: MAINID: xxxx INSERT-RMS: x COND-CODE: nnnn RO: xx
           DONT SCHEDULE -- BEFORE: yyddd hhmm AFTER: yyddd hhmm

COND-CODE is used with RO (relational operator) to define the job-level condition codes used to determine whether a job executes successfully. If the RO field is set to 0 (zero), no condition code test is made. For the COND-CODE field, enter 1 through 4 numeric characters from 0 to 4095.

The RO field specifies the relational operator of the condition code (COND-CODE) or whether the job's JCL uses the step level #SCC statements.

This field is not required. Both parameters test the highest condition code that a job generates.

To optionally define condition code tests at the step level, use the #SCC statements after the JOB statement and before the first execute (EXEC) statement.

Note: This test is for internal use by CA7ONL only. The test simply tells CA7ONL what action to take after the job completes. CA WA CA 7 Edition does not determine or control which steps to execute.

Business Value:

The ability to determine good job completions is critical to job management.

Additional Considerations:

The easiest way to test the COND-CODE and RO field settings is to make a sentence:

COND-CODE is RO to the job's CC

And if you can answer true to the preceding sentence, the job completed abnormally.

In other words, if a job receives CC of 4 and DB.1 panel states 0 - GT

Then the preceding sentence would read:

0 is GREATER THAN 4

Because the statement is false, the job completed typically (a good execution).

This logic is the same logic that IBM uses in condition code checking.

COND-CODE and RO are not applicable to agent jobs.

More Information:

For more information about COND-CODE, RO, or #SCC statements, see the Database Maintenance Guide. For more information about condition code processing in agent jobs, see the EXITCODE statement in the CA Integrated Agent Services User Guide.