Submitting and tracking the workload

Managing the Workload contains details of how HCL Workload Automation for Z selects work to be submitted at particular workstations. The following is a summary of the submission and tracking process for operations on a workstation that has a user-defined destination ID:

  • When the operation is selected as the next operation to be submitted, the status is set to SU. HCL Workload Automation for Z calls EQQUX009 and provides data stored in the EQQJSxDS or EQQJBLIB data sets. The information does not have to be stored in these libraries; the exit could locate the data elsewhere or the data might be stored at the target destination.
  • EQQUX009 transmits the data to the target destination. A good return code from the exit will leave the operation in status SU until changed through either the normal HCL Workload Automation for Z tracking routines (if the job is run on z/OS and an event writer and an event data set are present) or through the OPSTAT interface.
  • If the operation enters a queuing system in the target destination, this can be reported to HCL Workload Automation for Z through the OPSTAT command with STATUS(Q). HCL Workload Automation for Z will set the operation status to SQ.
  • When the operation actually starts to execute, this is reported using the OPSTAT command for STATUS(T). HCL Workload Automation for Z will set the operation status to SS.
  • Termination is reported using the OPSTAT command for STATUS(C), if normal, or STATUS(E), if abnormal.
It is recommended that you use the TOKEN passed to the EQQUX009 as input to OPSTAT. The TOKEN is a 4-byte value automatically generated by HCL Workload Automation for Z when the operation is selected to be scheduled. The purpose of the token is to make it easier for OPSTAT users to uniquely identify an HCL Workload Automation for Z operation.