Determining the success or failure of a job

These parameters specify how HCL Workload Automation for Z determines the next status of an operation when the job or started-task ends.

When a failing job has been obtained by restarting an operation at Step or Job level (for details, see Restart and cleanup) and the failure is determined by the EQQCLEAN step ending with RC>=8 (and causing all subsequent steps to FLUSH), then the operation status is always set to Error, overriding any completion checking logic implemented.

Table 1. Completion-checking-related parameters
Statement Parameters Description
EWTROPTS RETCODE Create job-end (3P) event with highest or last return code.
STEPEVENTS Specifies when HCL Workload Automation for Z creates events for ending job-steps.
JCCOPTS Job completion checker actions.
NOERROR LIST Error codes that are not errors.
JTOPTS NOERROR Error codes that are not errors.
HIGHRC Highest return code that is not an error.
ERRRES Reset operation status to A (arriving) for these error codes.
These job options in operation details override statement values:
  • ERROR TRACKING
  • HIGHEST RETURNCODE
HCL Workload Automation for Z processes the options in this order when a job or started task ends:
  1. EWTROPTS RETCODE - create job-end event.
  2. JCC - the event is passed to JCC if it is active. The JCC can set a new value for the return code. After JCC processing, the event passes to the controller.

    The event reaches the event queue at the controller.

  3. Return code 0 - Operation status set to C. Or continue checking.
  4. ERROR TRACKING - If operation details specify no error tracking, the operation status is set to C. Or continue checking.
  5. NOERROR - If the return code matches a NOERROR entry, the operation status is set to C. Or continue checking.

    HCL Workload Automation for Z checks all NOERROR statements and the NOERROR keyword of JTOPTS for a matching entry.

  6. HIGHRC - If the return code is less than or equal to HIGHRC, the operation status is set to C. Or continue checking.

    HCL Workload Automation for Z first uses the HIGHRC value in the operation details. If blank, JTOPTS HIGHRC is used.

  7. ERRRES - If the return code matches an ERRRES entry, the operation status is set to A.

If no match has occurred, the operation status is set to E. Recovery processing can then occur.