Quiescing IBM MQ for IBM i
This section explains how to quiesce (end gracefully) IBM MQ for IBM i.
To quiesce IBM MQ for IBM i:
- Sign on to a new interactive IBM MQ for IBM i session, ensuring that we are not accessing any objects.
- Ensure that we have:
- *ALLOBJ authority, or object management authority for the QMQM library
- Sufficient authority to use the ENDSBS command
- Advise all users that we are going to stop IBM MQ for IBM i.
- How you then proceed depends on whether we want to shut down (quiesce) a single queue manager (where others might exist) (see Shutting down a single queue manager for IBM MQ for IBM i ) or all the queue managers (see Shutting down all queue managers for IBM MQ for IBM i ).
- Shutdown the mqweb server by entering the following command in qshell:
/QIBM/ProdData/mqm/bin/endmqweb
ENDMQM parameter ENDCCTJOB(*YES)
The ENDMQM parameter ENDCCTJOB(*YES) works differently in IBM MQ for IBM i V6.0 and later compared to previous versions.
On previous versions, when you specify ENDCCTJOB(*YES), MQ forcibly terminates the applications for you.
On IBM MQ for IBM i V6.0 or later, when you specify ENDCCTJOB(*YES), the applications are not terminated but are instead disconnected from the queue manager.
If you specify ENDCCTJOB(*YES) and you have applications that are not written to detect that a queue manager is ending, the next time a new MQI call is issued, the call will return with a MQRC_CONNECTION_BROKEN (2009) error.
As an alternative to using ENDCCTJOB(*YES), use the parameter ENDCCTJOB(*NO) and use WRKMQM option 22 (Work with jobs) to manually end any application jobs that will prevent a queue manager restart.
- Shutting down a single queue manager for IBM MQ for IBM i
Use this information to understand the three types of shutdown.- Shutting down all queue managers for IBM MQ for IBM i
Use this information to understand the three types of shutdown.Parent topic: Administer IBM MQ for IBM i