System Automation for z/OS® user exit (EQQUXSAZ)

About this task

The system automation exit EQQUXSAZ is called every time an operation defined on a general and automatic workstation, with the Automation option enabled, is scheduled. The exit cannot modify any parameters received or other HCL Workload Automation for Z data or resources. EQQUXSAZ can examine the parameters and take some actions external to HCL Workload Automation for Z, based on the parameter information.

You can use EQQUXSAZ to send the command request to System Automation for z/OS®, through the NetView® PPI interface.

The HCL Workload Automation for Z sample library that was created during installation contains a sample EQQUXSAZ exit, written in assembler language. This exit does not submit the command to System Automation for z/OS®, it only receives the input parameters and stores them in a local variables area. You can modify the sample exit to create your own submission procedure. You need to compile and link-edit the HCL Workload Automation for Z exit only if you customized the submission part. The EQQUXSAZ exit that actually submits the command is provided with System Automation for z/OS®. You find it defined in the System Automation for z/OS® library SINGMOD1, as alias of EVJUXSAZ. You must concatenate that library in the STEPLIB of the controller startup procedure.

For details about the System Automation EQQUXSAZ, refer to System Automation for z/OS® publications.
Note:
  1. HCL Workload Automation for Z does not perform any validity or syntax checking on the request to be routed to System Automation for z/OS®.
  2. In case of System Automation timeouts, the operation could be marked with error OAUT on the HCL Workload Automation for Z side, even if it completes successfully later, on the System Automation side.
  3. For operations defined on automation workstations, the EQQUX007 exit is not invoked; only EQQUXSAZ is invoked.
  4. You can disable the loading of the EQQUXSAZ exit by setting CALL12(NO) in the EXIT initialization statement. This setting prevents message EQQN102W AN OPC USER EXIT LOAD MODULE, EQQUXSAZ, COULD NOT BE LOADED from being issued. However, it also prevents you from using any System Automation function.