STOP QUEUEMANAGER: Put a queue manager in drain state

Summary

Privileges

System manager or User 0

Function

Places a queue manager in a drain state.

Syntax

STOP {QUEUEMANAGER | QM} name

Where:

name identifies a queue manager created with a DEFINE QUEUEMANAGER command.

Usage

If the queue manager does not exist, or has not been started, an error message is issued. If it has already been stopped, the command is ignored.

Once the command is issued, you cannot open any queues for this queue manager. Attempts to open such queues fail with a $STATUS return code of six (6). However, any current users with open connections to the queue manager are not impacted. You can make the queue manager available again by issuing the START QUEUEMANAGER command.