Supplying event information to Tivoli Workload Scheduler for z/OS

You can report event information to Tivoli Workload Scheduler for z/OS, both manually and automatically, by establishing procedures that use Tivoli Workload Scheduler for z/OS TSO commands and Tivoli Workload Scheduler for z/OS subroutines. You can:

• Request a backup of a Tivoli Workload Scheduler for z/OS data set using the BACKUP TSO command, or EQQUSIN or EQQUSINB subroutine.
• Make a special resource available or unavailable using the SRSTAT TSO command, or EQQUSIN or EQQUSINS subroutine.
• Change the status of an operation using the OPSTAT TSO command, or EQQUSIN or EQQUSINT subroutine.
• Update the user data field of an operation in the current plan using the OPINFO TSO command, or EQQUSIN or EQQUSINO subroutine.
• Generate a workstation status event for a current plan workstation that specifies a user-defined destination using the WSSTAT TSO command, or EQQUSIN or EQQUSINW subroutine.

If you plan to issue the TSO commands many times per day from a long-running non-TSO address space, for example NetView®, it is recommended that you use an IBM Tivoli Workload Scheduler for z/OS subroutine instead. When you issue the commands from TSO or as input to the EQQEVPGM program, a TSO environment must be established each time, and some of the resources remain allocated until the task ends, which might lead to a storage shortage if the commands are issued many times.

For more information about IBM Tivoli Workload Scheduler for z/OS TSO commands, refer to Managing the Workload The remainder of this chapter describes how you use IBM Tivoli Workload Scheduler for z/OS subroutines.

Diagnosis Guide and Reference describes in detail how events are created and then processed by IBM Tivoli Workload Scheduler for z/OS.