MQTMC2 (Trigger message 2 - character format) on IBM i

When a trigger-monitor application retrieves a trigger message (MQTM) from an initiation queue, the trigger monitor might need to pass some or all of the information in the trigger message to the application that is started by the trigger monitor.

Overview

Purpose: Information that may be needed by the started application includes TC2QN, TC2TD, and TC2UD. 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.

This structure is part of the IBM MQ Trigger Monitor Interface (TMI), which is one of the IBM MQ framework interfaces.

Character set and encoding: Character data in MQTMC2 is in the character set of the local queue manager; this is given by the CodedCharSetId queue manager attribute.

• On IBM i, the trigger monitor application provided with IBM MQ passes an MQTMC2 structure to the started application.

• Fields
• Initial values
• RPG declaration

Fields

The MQTMC2 structure contains the following fields; the fields are described in alphabetical order:

TC2AI (256-byte character string)

Application identifier.

See the TMAI field in the MQTM structure.

TC2AT (4-byte character string)

Application type.

This field always contains blanks, whatever the value in the TMAT field in the MQTM structure of the original trigger message.

TC2ED (128-byte character string)

Environment data.

See the TMED field in the MQTM structure.

TC2PN (48-byte character string)

Name of process object.

See the TMPN field in the MQTM structure.

TC2QMN (48-byte character string)

Queue manager name.

This is the name of the queue manager at which the trigger event occurred.

TC2QN (48-byte character string)

Name of triggered queue.

See the TMQN field in the MQTM structure.

TC2SID (4-byte character string)

Structure identifier.

The value must be:

TCSIDV

Identifier for trigger message (character format) structure.

TC2TD (64-byte character string)

Trigger data.

See the TMTD field in the MQTM structure.

TC2UD (128-byte character string)

User data.

See the TMUD field in the MQTM structure.

TC2VER (4-byte character string)

Structure version number.

The value must be:

TCVER2

Version 2 trigger message (character format) structure.

The following constant specifies the version number of the current version:

TCVERC

Current version of trigger message (character format) structure.

Initial values

RPG declaration

     D*..1....:....2....:....3....:....4....:....5....:....6....:....7..
     D* MQTMC2 Structure
     D*
     D* Structure identifier
     D  TC2SID                 1      4
     D* Structure version number
     D  TC2VER                 5      8
     D* Name of triggered queue
     D  TC2QN                  9     56
     D* Name of process object
     D  TC2PN                 57    104
     D* Trigger data
     D  TC2TD                105    168
     D* Application type
     D  TC2AT                169    172
     D* Application identifier
     D  TC2AI                173    428
     D* Environment data
     D  TC2ED                429    556
     D* User data
     D  TC2UD                557    684
     D* Queue manager name
     D  TC2QMN               685    732