Suspend Queue Manager on z/OS

The Suspend Queue Manager (MQCMD_SUSPEND_Q_MGR) command renders the local queue manager unavailable for the processing of IMS or Db2 messages. Its action can be reversed by the Resume Queue Manager command (MQCMD_RESUME_Q_MGR) command.

Required parameters

Facility (MQCFIN)

Facility (parameter identifier: MQIACF_FACILITY). The type of facility for which activity is to be suspended. The value can be:

MQQMFAC_DB2

The existing connection to Db2 is terminated.

Any in-flight or subsequent MQGET or MQPUT requests are suspended and applications wait until the Db2 connection is re-established by the Resume Queue Manager command, or if the queue manager is stopped.

MQQMFAC_IMS_BRIDGE

Resumes normal IMS bridge activity. Stops the sending of messages from IMS bridge queues to OTMA. No further messages are sent to IMS until one of these events occurs:

• OTMA is stopped and restarted
• IMS or IBM MQ is stopped or restarted
• A Resume Queue Manager command is processed

Messages returning from IMS OTMA to the queue manager are unaffected.

Optional parameters

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). Specifies how the command is processed when the queue manager is a member of a queue sharing group. We can specify one of the following:

• blank (or omit the parameter altogether). The command is processed on the queue manager on which it was entered.
• a queue manager name. The command is processed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment, and the command server must be enabled.

The maximum length is MQ_QSG_NAME_LENGTH.

Parent topic: Definitions of the Programmable Command Formats