ApplicationTrace stanza of the mqat.ini file

The mqat.ini configuration file can contain multiple ApplicationTrace stanzas. Each one these stanzas defines a rule for the trace behavior for one or more connections, based on matching the application name of the connections to the rule.

You can set the following values for the ApplicationTrace stanza:

Trace

Activity trace switch that can be set to ON or OFF. The Trace parameter is a required parameter with no default value. It can be used in the application-specific stanza to determine whether activity trace is active for the scope of the current application stanza. Note that this value overrides the ACTVTRC and ACTVCONO settings for the queue manager.

ApplName

The ApplName parameter is specified as a character string and is a required parameter with no default. This value is used to determine which applications the ApplicationTrace stanza applies to. It is matched to the ApplName value from the API exit context structure (which is equivalent to the MQMD.PutApplName). The content of the ApplName value varies according to the application environment.

On Multiplatforms, only the filename portion of the MQAXC.ApplName is matched to the value in the stanza. Characters to the left of the rightmost path separator are ignored when the comparison is made.

A single wildcard character (*) can be used at the end of the ApplName value to match any number of characters after that point. If the ApplName value is set to a single wildcard character (*) then the ApplName value matches all applications.

ApplFunction

The ApplFunction parameter is specified as a character string. The default value is *. The value of this parameter is used to qualify which application programs the ApplicationTrace stanza and the ApplName value applies to.

The stanza is optional, and is only valid for IBM® i queue managers. A single wildcard character (*) can be used at the end of the ApplName value to match any number of characters. For example, an ApplicationTrace stanza specifying ApplName = * and ApplFunction = AMQSPUT0 applies to all invocations of the AMQSPUT0 program from any job.

ApplClass

The ApplClass parameter defines the class of an application and can be set to the following values:

USER
MCA
ALL (This is the default value)

For an explanation of how the AppType values correspond to IBM MQ connections, see Table 3 in Configuring activity trace behavior using mqat.ini.

Optionally, the global trace level and frequency settings under the AllActivityTrace stanza can be overridden for those connections matching an ApplicationTrace stanza.

The following parameters can be set under an ApplicationTrace stanza. If they are not set, the value is inherited from the AllActivity trace stanza settings:

ActivityInterval: The time interval in seconds between trace messages. Activity trace does not use a timer thread, so the trace message is not written at the exact instant that the time elapses, it is written when the first MQI operation is executed after the time interval elapses. If this value is 0, the trace message is written when the connection disconnects (or when the activity count is reached). Defaults to 1.
ActivityCount: The number of MQI operations between trace messages. If this value is 0, the trace message is written when the connection disconnects (or when the activity interval elapses). Defaults to 100.
TraceLevel: The amount of parameter detail that is traced for each operation. The description of individual operations details which parameters are included for each trace level. Set to LOW, MEDIUM, or HIGH. Defaults to MEDIUM.
TraceMessageData: The amount of message data that is traced in bytes for MQGET, MQPUT, MQPUT1, and Callback operations. Defaults to 0.
StopOnGetTraceMsg: Can be set to ON or OFF. Defaults to ON.