runmqtmc (start client trigger monitor)

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

Purpose

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

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

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; client trigger monitor not run

Examples

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