Tivoli Workload Scheduler for z/OS performance data

You can automatically receive performance information from IBM Tivoli Workload Scheduler for z/OS using the STATMSG keyword of the JTOPTS initialization statement. Three values are supported for STATMSG:

CPLOCK
The event-manager subtask issues messages EQQE004 and EQQE005, which describe how often different tasks have referenced the current-plan data set. The SYSZDRK/ssnameCP enqueue is taken by the subtasks that access the current plan. In most cases the enqueue is taken exclusively. Only the general service subtask, which handles requests from host dialog users, PIF, the API, enqueues against the resource shared. A degree of contention on the resource is expected, because the subtasks continually take the lock, process work, and release the lock. If there is resource contention for more than 50% of the time during a measured interval, review the tuning recommendations.

IBM Tivoli Workload Scheduler for z/OS issues these messages when the number of events that it has processed is greater than approximately half the value of the BACKUP keyword. If you specified BACKUP(NO), IBM Tivoli Workload Scheduler for z/OS uses the default value of the BACKUP keyword (400) to calculate when to issue messages for CPLOCK. The number of events processed includes all events that IBM Tivoli Workload Scheduler for z/OS processes, and not just those events for operations in the current plan.

EVENTS
The event-manager subtask issues messages EQQE000I, EQQE006I, and EQQE007I, which describe how many events were processed and provide statistics for the different event types. IBM Tivoli Workload Scheduler for z/OS issues these messages when the number of events that it has processed is greater than approximately half the value of the BACKUP keyword. If you specified BACKUP(NO), IBM Tivoli Workload Scheduler for z/OS uses the default value of the BACKUP keyword (400) to calculate when to issue messages for EVENTS. The number of events processed includes all events that IBM Tivoli Workload Scheduler for z/OS processes, and not just those events for operations in the current plan.
WSATASK
The event manager task issues messages EQQE008I and EQQE009I, which describe statistic information collected by the WSA task.

All these messages are issued according to the following criteria:

  • If STATIM has been set to a value different from 0 (by specifying STATIM(n) in the JTOPTS keyword, or by using the modify command /F subsys,STATIM=n), the message is issued approximately every n minutes, if any events have been processed.
  • Otherwise, if EVELIM has been set to a nonzero value (by specifying EVELIM(n) in the JTOPTS keyword, or by using the modify command /F subsys,EVELIM=n), the message is issues approximately every n events.
  • Otherwise, the message is issued approximately once every n events, where n is half the JTOPTS BACKUP keyword value (default BACKUP value is 400).
GENSERV
The general-service subtask issues messages EQQG010 to EQQG011, which describe how often different request types have been processed, and how long the general-service queue has been. IBM Tivoli Workload Scheduler for z/OS issues these messages every 30 minutes if any requests have been processed.

Performance information for the JCC subtask can be obtained from the SYSOUT-archiving exit (EQQUX005).