Event message format

Event messages are standard IBM MQ messages containing a message descriptor and message data.

Table 1 shows the basic structure of event messages and, in the Event data column, the names of the fields in an event message for queue service interval events.

Message descriptor Message data
MQMD structure PCF header
MQCFH structure
 Event data 1

Structure identifier
Structure version
Report options
Message type
Expiration time
Feedback code
Encoding
Coded character set ID
Message format
Message priority
Persistence
Message identifier
Correlation identifier
Backout count
Reply-to queue
Reply-to queue manager
User identifier
Accounting token
Application identity data
Application type
Application name
Put date
Put time
Application origin data
Group identifier
Message sequence number
Offset
Message flags
Original length
Structure type
Structure length
Structure version
Command identifier
Message sequence number
Control options
Completion code
Reason code
Parameter count
  
Queue manager name
Queue name
Time since last reset
Maximum number of
messages on queue
Number of messages
put to queue
Number of messages
retrieved from queue
  
Note:
  1. The parameters shown are those returned for a queue service interval event. The actual event data depends on the specific event.

In general, we need only a subset of this information for any system management programs that you write. For example, the application might need the following data:

  • The name of the application causing the event
  • The name of the queue manager on which the event occurred
  • The queue on which the event was generated
  • The event statistics

Parent topic: Event message reference