runmqtmc (start client trigger monitor)

Start the trigger monitor on a client.

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.

Syntax

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, we can send a user ID and password, and have the password encrypted, using the mqccred security exit.

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.

Examples

For examples of using this command, see The Triggering sample programs.