runmqtmc (start client trigger monitor)

Purpose

Use the runmqtmc command to start a trigger monitor for a client. For further information about using trigger monitors, see Trigger monitors.

When a trigger monitor starts, it continuously monitors the specified initiation queue. The trigger monitor does not stop until the queue manager ends, see endmqm (end queue manager). While the client trigger monitor is running it keeps the dead letter queue open.

Optional parameters

-m QMgrName

The name of the queue manager on which the client trigger monitor operates, by default the default queue manager.

-q InitiationQName

The name of the initiation queue to be processed, by default SYSTEM.DEFAULT.INITIATION.QUEUE.

-r

Specifies that the client trigger monitor automatically reconnects.

-u UserId

The ID of the user authorized to get the triggered message.

Note that using this option does not affect the authority of the triggered program, that might have its own authentication options.

Note: As the runmqtmc command makes a standard client connection, you can send a user ID and password, and have the password encrypted, using the mqccred security exit.

Return codes

For IBM® MQ 9.1.3 and earlier, and for LTS before IBM MQ 9.2.0, the value of 0 is not used and the value is reserved. The trigger monitor is designed to run continuously and therefore not to end.

Table 1. Return code identifiers and descriptions

Return code	Description
0	From IBM MQ 9.1.4, client trigger monitor interrupted because the queue manager is ending, or the channel is stopped.
10	Trigger monitor interrupted by an error.
20	Error; client trigger monitor not run.