Controlling activity recording

Enable activity recording at the queue manager level. To enable an entire queue manager network, individually enable every queue manager in the network for activity recording. If you enable more queue managers, more activity reports are generated.

About this task

To generate activity reports for a message as it is routed through a queue manager: define the message to request activity reports; enable the queue manager for activity recording; and ensure that applications performing activities on the message are capable of generating activity reports.

If you do not want activity reports to be generated for a message as it is routed through a queue manager, disable the queue manager for activity recording.

Procedure

  1. Request activity reports for a message
    1. In the message descriptor of the message, specify MQRO_ACTIVITY in the Report field.
    2. In the message descriptor of the message, specify the name of a reply-to queue in the ReplyToQ field.
    Warning: Avoid enabling all messages in a queue manager network for activity recording. Messages enabled for activity recording can have many activity reports generated on their behalf. If every message in a queue manager network is enabled for activity recording, the queue manager network traffic can increase to an unacceptable level.
  2. Enable or disable the queue manager for activity recording.
    Use the MQSC command ALTER QMGR, specifying the parameter ACTIVREC, to change the value of the queue manager attribute. The value can be:
    MSG
    The queue manager is enabled for activity recording. Any activity reports generated are delivered to the reply-to queue specified in the message descriptor of the message. This is the default value.
    QUEUE
    The queue manager is enabled for activity recording. Any activity reports generated are delivered to the local system queue SYSTEM.ADMIN.ACTIVITY.QUEUE. The system queue can also be used to forward activity reports to a common queue.
    DISABLED
    The queue manager is disabled for activity recording. No activity reports are generated while in the scope of this queue manager.
    For example, to enable a queue manager for activity recording and specify that any activity reports generated are delivered to the local system queue SYSTEM.ADMIN.ACTIVITY.QUEUE, use the following MQSC command: 
    
ALTER QMGR ACTIVREC(QUEUE)
    Remember: When you modify the ACTIVREC queue manager attribute, a running MCA does not detect the change until the channel is restarted.
  3. Ensure that your application uses the same algorithm as MCAs use to determine whether to generate an activity report for a message:
    1. Verify that the message has requested activity reports to be generated
    2. Verify that the queue manager where the message currently resides is enabled for activity recording
    3. Put the activity report on the queue determined by the ACTIVREC queue manager attribute