Selection parameters

When a job ends in error, this information is available:

Job name
Abend code, if job abended
Return code, if job did not abend

The selection parameters use this information:

JOBCODE

The code can be an abend code, an error code set by HCL Workload Automation for Z or JCC, a case code, a return code, or a return code range. The values are those given as the error code on the Handling Operations Ended in Error panel in the Modify Current® Plan panel.

The JOBCODE keyword values are:

Sxxx: Specifies a system abend code.
Uxxx: Specifies a user abend code.
xxxx: Specifies a case code or an error code set by HCL Workload Automation for Z, either directly or by using the job completion checker.
n: Specifies a return code.
x-y: Specifies a return code range, where x and y represent positive decimal values.

The codes specified in the JOBCODE parameter are tested against the job code as set by HCL Workload Automation for Z when the job ends.

You can also specify abend codes in generic form. Therefore, an asterisk (*) can represent any character, or any group of characters, in those positions where it is placed. A code can contain more than one asterisk only if each asterisk is separated from the next by another character.

Note: The JOBCODE=* notation covers all possible user and system abend codes; it does not cover return codes. To cover all possible return codes, specify a return code range in the form:

JOBCODE=x-y

where x and y represent positive decimal values.

A return code cannot be greater than 4095. To specify a range of values, set x to the lower value and y to the higher value. To specify all return codes greater than or equal to a certain value, set x to that value and y to 4095.

TIME

The time is specified in the form hhmm, where hh is the hour from 00 to 24, and mm is the minute from 00 to 60. This is the time when the recovery is automatic.

For example:

TIME=0700-1600: No recovery actions occur between 4 p.m. and 7 a.m.
TIME=2200-0800: HCL Workload Automation for Z does automatic recovery only between 22.00 and 8.00.
TIME=0000-2400: Recovery can be automatic at any time.
TIME=0000-0000: Recovery is not started unless there is manual intervention.

The recovery actions for a job that remains in the ended-in-error list can be manually started up later. Such requests override any TIME value specified.

Default: The recovery specification is for the time range specified by the STARTIME and ENDTIME keywords of the AROPTS automatic recovery options statement. For more details, see Customization and Tuning.