runmqtrm (start trigger monitor)

Purpose

Use the runmqtrm command to start a trigger monitor. 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 trigger monitor is running it keeps the dead letter queue open.

Optional parameters

-m QMgrName

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

-q InitiationQName

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

-u UserId

The ID of the user authorized to read the initiation queue, and 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.

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.2.0, trigger monitor interrupted because the queue manager is ending.
10	Trigger monitor interrupted by an error.
20	Error; trigger monitor not run.