[UNIX, Linux, Windows, IBM i]

runmqtrm (start trigger monitor)

Use the runmqtrm command to start a trigger monitor on a server. When a trigger monitor starts, it continuously monitors the specified initiation queue. The trigger monitor does not stop until the queue manager ends. While the trigger monitor is running it keeps the dead-letter queue open.

For more information about using trigger monitors, see Initiation queue processing by trigger monitors.

Syntax

Read syntax diagramSkip visual syntax diagram runmqtrm  -m QMgrName -q InitiationQName -u UserId

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

Table 1. Return code identifiers and descriptions
Return code Description
0 Not used but reserved as the client trigger monitor is designed to run continuously without ending
10 Trigger monitor interrupted by an error
20 Error; trigger monitor not run