Overview

Purpose: The MQTM structure describes the data in the trigger message that is sent by the queue manager to a trigger-monitor application when a trigger event occurs for a queue. This structure is part of the WebSphere MQ Trigger Monitor Interface (TMI), which is one of the WebSphere MQ framework interfaces.

Format name: FMTM.

Character set and encoding: Character data in MQTM is in the character set of the queue manager that generates the MQTM. Numeric data in MQTM is in the machine encoding of the queue manager that generates the MQTM.

The character set and encoding of the MQTM are given by the MDCSI and MDENC fields in:

• The MQMD (if the MQTM structure is at the start of the message data), or

• The header structure that precedes the MQTM structure (all other cases).

Usage: A trigger-monitor application may need to pass some or all of the information in the trigger message to the application which is started by the trigger-monitor application. Information which may be needed by the started application includes TMQN, TMTD, and TMUD. The trigger-monitor application can pass the MQTM structure directly to the started application, or pass an MQTMC2 structure instead, depending on what is permitted by the environment and convenient for the started application. For information about MQTMC2, see MQTMC2 - Trigger message 2 (character format).

• On i5/OS, the trigger-monitor application provided with WebSphere MQ passes an MQTMC2 structure to the started application.

For information about triggers, see the WebSphere MQ Application Programming Guide.

MQMD for a trigger message: The fields in the MQMD of a trigger message generated by the queue manager are set as follows:

Field in MQMD	Value used
MDSID	MDSIDV
MDVER	MDVER1
MDREP	RONONE
MDMT	MTDGRM
MDEXP	EIULIM
MDFB	FBNONE
MDENC	ENNAT
MDCSI	Queue manager's CodedCharSetId attribute
MDFMT	FMTM
MDPRI	Initiation queue's DefPriority attribute
MDPER	PENPER
MDMID	A unique value
MDCID	CINONE
MDBOC	0
MDRQ	Blanks
MDRM	Name of queue manager
MDUID	Blanks
MDACC	ACNONE
MDAID	Blanks
MDPAT	ATQM, or as appropriate for the message channel agent
MDPAN	First 28 bytes of the queue manager name
MDPD	Date when trigger message is sent
MDPT	Time when trigger message is sent
MDAOD	Blanks

An application that generates a trigger message is recommended to set similar values, except for the following:

• The MDPRI field can be set to PRQDEF (the queue manager will change this to the default priority for the initiation queue when the message is put).

• The MDRM field can be set to blanks (the queue manager will change this to the name of the local queue manager when the message it put).

• The context fields should be set as appropriate for the application.