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

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

Return code Description
0 Not used. The trigger monitor is designed to run continuously and therefore not to end. Hence a value of 0 would not be seen. The value is reserved.
10 Trigger monitor interrupted by an error.
20 Error; trigger monitor not run.