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