Workitem Queue Monitoring

Timeout messages (ING008I) can be the result of the fact that more work items are received than the automation manager is able to process. To better understand the nature of received timeout messages, you can now monitor the workitem input queue. This can be achieved with the INGAMS STARTMON/STOPMON parameter.

When the automation manager workitem queue monitoring routine detects that more work items are arriving than can be processed within the monitoring interval, message INGX1011I is issued.

In addition, INGRYAMD traps message INGX1011I with the NetView automation table and saves the relevant data. On request, INGRYAMD creates a file that contains the collected data. The data is separated by semicolons so that the file can be easily imported into a spreadsheet.

The syntax of the INGRYAMD command is as follows:

REQ

Specifies the function to be performed. Valid values are:

REPORT: Generates a report file that contains the captured data.
RESET: Resets the captured data.

OUTDSN

Specifies the name of the data set that contains the report file. The data set must exist. The minimum record length should be 80.

The report file contains one record for each message that is captured. The format of the records is:

Column #	Description
1	Timestamp when INGX1011I message was captured. The format is yyyy-mm-dd hh:mm:ss
2	(DIF) The number of work items that were not processed within the last monitoring cycle. It is the number of work items in the queue at the current monitoring time minus the number of work items in the queue at the last monitoring period.
3	(ABS) The total number of work items in the input and output queue. This also includes the work items that have been processed but not yet run through the cleanup phase.
4	(QUE) The number of work items in the input queue.
5	(EXP) The number of expired work items in the input queue.
6	(CPU) The CPU time of the automation manager.
7	(OUT) The number of entries in the output queue.
8	(RSP) The number of response entries in the input queue (for example, Query).
9	(FAF) The number of fire and forget entries in the input queue.