endmqm (end queue manager)
Stop a queue manager.
Purpose
You can use the endmqm command to stop a queue manager. This command stops a
queue manager in one of three modes:
- Controlled or quiesced shutdown
- Immediate shutdown
- Preemptive shutdown
Syntax
Parameters
- QMgrName
- Specifies the name of the message queue manager that you want to stop.
- -c
- Specifies that the queue manager ends in a controlled (or quiesced) shutdown.
- -i
- Specifies that the queue manager ends in an immediate shutdown.
- -p
- Specifies that the queue manager ends in a preemptive shutdown.
- -r
- Specifies that client connectivity can be re-established with other queue managers in their queue manager group.
- -w
- Specifies that the queue manager ends in a wait shutdown.
Usage notes
- This command must be run from the IBM® MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes
mqa(mqcli)#
. To enter the IBM MQ administration mode, entermqcli
on the command line. To exit the IBM MQ administration mode, enterexit
on the command line. - This command does not affect the attributes of the queue manager.
- The endmqm command affects any client application that is connected to the
queue manager by a server-connection channel. The effect is equivalent to a STOP CHANNEL command in
one of the following modes:
- If the -c, or -w parameters are used, the mode is QUIESCE.
- If the -i parameter is used, the mode is FORCE.
- If the -p parameter is used, the mode is TERMINATE.
- If an dspmq command is entered in the time between the applications disconnecting and the queue manager stopping, the dspmq command might report the status as Ending immediately, even if a controlled shutdown was requested.
- For more information about this command in IBM MQ, see endmqm in the IBM MQ documentation.
Examples
- The following command ends the queue manager that is named
QM1
in a controlled way:endmqm QM1
- The following command ends the queue manager that is named
QM2
immediately:endmqm -i QM2