Operation-status-change exit (EQQUX007)

The operation-status-change exit (EQQUX007) is called whenever an operation in the current plan changes status. The exit is also called when a new operation is added to the current plan by a function other than by daily planning jobs; for example, by PIF or the MCP dialog. The exit is called when the operation is added either to an existing occurrence or as a result of a new occurrence added to the current plan. EQQUX007 is not called for operations that are added at daily planning. The exit can be used to modify the USERDAT field of the OPERAREA parameter. The exit cannot modify other parameters passed to it or other Tivoli Workload Scheduler for z/OS data or resources. It can examine the parameters and take some action external to Tivoli Workload Scheduler for z/OS based on the parameter information.

You can use EQQUX007 to:

Report errors to a problem-management system, such as Information/Management
Generate a write-to-operator message. Such a message could be handled by NetView® or by a similar message-processing program to generate alerts or to trigger other processing.

The Tivoli Workload Scheduler for z/OS sample library that was created during installation contains a sample EQQUX007 exit written in assembler language. This sample exit reports batch-job errors to the Information/Management product. The sample consists of two members in the sample library:

EQQX7ASM: Sample EQQUX007 assembler language program and JCL to assemble and link it
EQQX7JOB: Sample batch-job JCL skeleton to be used by the sample EQQUX007.

Refer to the sample library members themselves for further information.

Note:

Because the same event might be processed a second time in a recovery situation and during current plan turnover, this must be considered when coding the exit. If invocation of the exit is NOT wanted during Tivoli Workload Scheduler for z/OS recovery or turnover, code the exit to check if the CALLER is NMM. The only circumstance when NMM calls EQQUX007 is during current-plan recovery and daily-plan turnover.