2161 (0871) (RC2161): MQRC_Q_MGR_QUIESCING

Explanation

An MQI call was issued, but the call failed because the queue manager is quiescing (preparing to shut down).

When the queue manager is quiescing, the MQOPEN, MQPUT, MQPUT1, and MQGET calls can still complete successfully, but the application can request that they fail by specifying the appropriate option on the call:
  • MQOO_FAIL_IF_QUIESCING on MQOPEN
  • MQPMO_FAIL_IF_QUIESCING on MQPUT or MQPUT1
  • MQGMO_FAIL_IF_QUIESCING on MQGET
Specifying these options enables the application to become aware that the queue manager is preparing to shut down.
  • On z/OS®:
    • For batch applications, this reason can be returned to applications running in LPARs that do not have a queue manager installed.
    • For CICS® applications, this reason can be returned when no connection was established.
  • On IBM® i for applications running in compatibility mode, this reason can be returned when no connection was established.

Completion Code

MQCC_FAILED

Programmer response

The application should tidy up and end. If the application specified the MQOO_FAIL_IF_QUIESCING, MQPMO_FAIL_IF_QUIESCING, or MQGMO_FAIL_IF_QUIESCING option on the failing call, the relevant option can be removed and the call reissued. By omitting these options, the application can continue working to complete and commit the current unit of work, but the application does not start a new unit of work.