Format of trigger messages
The format of a trigger message is defined by the MQTM structure. This
has the following fields, which the queue manager fills when it creates the
trigger message, using information in the object definitions of the application
queue and of the process associated with that queue:
- StrucId
- The structure identifier.
- Version
- The version of the structure.
- QName
- The name of the application queue on which the trigger event occurred.
When the queue manager creates a trigger message, it fills this field using
the QName attribute of the application queue.
- ProcessName
- The name of the process definition object that is associated with the
application queue. When the queue manager creates a trigger message, it fills
this field using the ProcessName attribute of the application
queue.
- TriggerData
- A free-format field for use by the trigger monitor. When the queue manager
creates a trigger message, it fills this field using the TriggerData attribute of the application queue. On any WebSphere MQ product except WebSphere MQ for z/OS,
this field can be used to specify the name of the channel to be triggered.
- ApplType
- The type of the application that the trigger monitor is to start. When
the queue manager creates a trigger message, it fills this field using the ApplType attribute of the process definition object identified
in ProcessName.
- ApplId
- A character string that identifies the application that the trigger
monitor is to start. When the queue manager creates a trigger message, it
fills this field using the ApplId attribute of the process
definition object identified in ProcessName. When you
use trigger monitor CKTI or CSQQTRMN supplied by WebSphere MQ for z/OS, the ApplId attribute of the process definition object is a CICS(R) or IMS(TM) transaction identifier.
- EnvData
- A character field containing environment-related data for use by the
trigger monitor. When the queue manager creates a trigger message, it fills
this field using the EnvData attribute of the process
definition object identified in ProcessName. The WebSphere MQ for z/OS-supplied
trigger monitors (CKTI or CSQQTRMN) do not use this field, but other trigger
monitors might choose to use it.
- UserData
- A character field containing user data for use by the trigger monitor.
When the queue manager creates a trigger message, it fills this field using
the UserData attribute of the process definition object
identified in ProcessName. This field can be used to specify
the name of the channel to be triggered.
There is a full description of the trigger message structure in WebSphere MQ Application Programming Reference.