SET APPL

Use the SET APPL statement must be used in combination with the SET MQIMONITOR statement to activate the application debugging and application statistics features. See SET MQIMONITOR for a description of SET MQIMONITOR.

Parameters

NAME(application-name)

A 1- through 8-character name of the z/OS system application to be monitored. To specify a generic name, enter a character string followed by an asterisk (*).

The application name format differs, depending on the monitored applications:

• For batch applications, it is the 1- through 8-character job name.
• For TSO applications it is the 1- through 7-character user ID of the TSO session.
• For CICS applications it is the 1- through 8-character VTAM® applid.
• For IMS applications it is the 1- through 4-character IMS subsystem ID that is prefixed with the characters IMS and padded with a blank.

This parameter is required.

TRANPGM(program-name)

Further identifies one or more programs to monitor, as follows:

• The 1- through 4-character name of the CICS transaction to monitor in the VTAM applid that is identified by the NAME parameter.
• The 1- through 8-character name of the IMS program in the IMS subsystem that is identified by the NAME parameter.
• The 1- through 8-character name of the batch or TSO program in the address space that is identified by the NAME parameter.

To specify a generic name, enter a character string followed by an asterisk (*). This parameter is optional. The default value is an asterisk (*).

MGRNAME(manager-name)

The name of one or more z/OS system queue managers with applications that are to be monitored. To specify a generic name, enter a character string followed by an asterisk (*). The name must exactly match the name specified on the corresponding SET MANAGER statement. This parameter is optional. The default value is an asterisk (*).

TRACE(NO|YES)

Specifies whether to record IBM MQ tracing information for this application. This parameter is optional. The default value is NO.

TRACELIMIT(1000|number-of-trace-records)

Specifies the number of trace records to save for later viewing. After this value is reached, trace recording for this application is stopped. The maximum value is 12000; the default value is 1000. You can issue the SET APPL statement again with this parameter to resume trace recording after saving the maximum number of records. This parameter is optional.

STATISTICS(NONE|NOQDATA|NODYNAMQ|ALL|SUMREMOTE|SUMDYNAMIC)

Specify the level of statistical information to collect for the applications that is identified by the NAME parameter, as follows:

• NONE

  No statistical information is collected for this application.

• NOQDATA

  Application statistical information is not collected at the queue level; however, statistical information is still collected at the application and transaction levels.

• NODYNAMQ

  Application statistical information is not collected for dynamic queues (temporary and permanent); however, statistical information is still collected for predefined queues. Specifying NODYNAMQ activates Application Queue Statistics monitoring. Specifying NODYNAMQ does not affect the collection of application statistics at the application and transaction level.

• ALL

  Statistical information is collected at the application, transaction, and queue levels.

• SUMREMOTE

  This value is applicable for queue level data collection. Specify this value in addition to ALL or NODYNAMQ. For example, STATISTICS(NODYNAMQ,SUMREMOTE).

  When specified, the statistics about MQPUT and MQPUT1 activity for remote queues are aggregated.

• SUMDYNAMIC

  This value is applicable for queue level data collection. Specify this value in addition to ALL. For example, STATISTICS(ALL,SUMREMOTE,SUMDYNAMIC).

  When specified, the statistics about the activity for dynamic queues with the same prefix are aggregated.

This parameter is optional. The default value is NODYNAMQ.

STATUS(ADD|DELETE)

Specifies what to do if this SET APPL statement was previously specified with the same name.

If this parameter is omitted, the application definition is added if it is a new name, it is modified if the same name was specified previously.

• ADD

  Creates a new application definition. If this SET APPL statement was previously specified with the same name, it is modified and an error message is issued.

• DELETE

  Deletes the application definition and all its associated historical data.