SET MQIMONITOR

Use the SET MQIMONITOR statement with the SET APPL statement to activate the application debugging and application statistics features.

Parameters

STATUS(INSTALL|REMOVE|FREMOVE)

This parameter is required. It specifies whether monitoring for the z/OS® system applications, CICS® transactions, and IMS™ programs that are identified on the SET APPL statement is turned on.

• INSTALL

  Application monitoring is turned on for the z/OS system applications, CICS transactions, and IMS programs that are identified on the SET APPL statement. (If no SET APPL statement is specified, no data is collected.)

• REMOVE

  Application monitoring is turned off for the applications that are identified on the SET APPL statement. If monitoring is not activated by a previous SET MQIMONITOR STATUS(INSTALL) statement, this request is ignored.

• FREMOVE

  Use the FREMOVE option only when you are instructed to do so by IBM® Software Support. This parameter removes and stops application monitoring.

MGRNAME(manager-name)

Application monitoring is turned on or off for the queue manager that is identified by a previous SET MANAGER statement. The name must exactly match the name that is specified on a previous SET MANAGER statement. This parameter is required if the GROUP parameter is not specified.

GROUP(group-name)

Application monitoring is turned on or off for the group of queue managers that are identified by a previous SET GROUP statement. The name must exactly match the name that is specified on a previous SET GROUP statement. This parameter is required if the MGRNAME parameter is not specified.

BUFFERSIZE(initial-buffer-space)

Applies only when the STATUS(INSTALL) statement is also specified. This parameter specifies the initial buffer size (in MBs) of buffer data space for monitoring MQ applications.

This parameter is optional. The default value, if BUFFERSIZE is not specified on the SET MQIMONITOR command, is 32.

The maximum value is 2048 (2 GB of buffer storage).

BUFFERSIZEMAX(max-buffer-space)

This parameter specifies the maximum buffer size (in MBs) of buffer data space for monitoring MQ applications. This parameter is optional.

The default value, if BUFFERSIZEMAX is not specified on the SET MQIMONITOR command, is 128 or the value of BUFFERSIZE, whichever is greater.

The maximum value is 2048 (2 GB of buffer storage). When the maximum data space size that is available is reached, the applications monitoring is temporarily disabled, and enabled again when the data space is available.

BUFFERINCREMENTSIZE(increment-buffer-size)

This parameter specifies the increment buffer size (in MBs) of buffer data space to be expanded when the data space usage reaches the threshold (75%). This parameter is optional.

The default value, if BUFFERINCREMENTSIZE is not specified on the SET MQIMONITOR command, is 32.

The maximum value is 2048 (2 GB of buffer storage).

AUTORESTART(NO|YES)

This parameter determines whether MQI monitoring will be restarted for a queue manager covered by this SET MQIMONITOR statement if the maximum buffer space allowed is filled up such that MQI monitoring is deactivated with message KMQMQ206E.

YES will cause the agent to restart MQI monitoring automatically in this case, and it will be restarted using the BUFFERSIZEMAX allocation at the next sample interval after the deactivation occurred.

NO is the default setting in which the agent behaves as in the past with no restart occurring automatically, since this AUTORESTART functionality is new with APAR OA63182.