Configuring trace levels
You configure trace levels for a queue manager on the IBM® MQ Appliance by using the setmqini command.
You use the setmqini command to set values in the mqat.ini file for the queue manager. See Adding a value to the configuration file for details of how to use the setmqini command.
You can set the following values for the AllActivityTrace stanza:
- ActivityInterval
- 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
- 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
- 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
- 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.
- SubscriptionDelivery
- Can be set to BATCHED or IMMEDIATE. Determines whether the ActivityInterval and ActivityCount parameters are to be used when one or more activity trace subscriptions are present. Setting this parameter to IMMEDIATE results in the ActivityInterval and ActivtyCount values being overridden with effective values of 1 when the trace data has a matching subscription. Each activity trace record is not batched with other records from the same connection and instead delivered to the subscription immediately with no delay. The IMMEDIATE setting increases the performance overhead of collecting activity trace data. The default setting is BATCHED.