runmqtrm (start trigger monitor)

Start the trigger monitor on a server.

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.

Syntax

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 Version 9.1.3 and earlier, and for LTS before Version 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.