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 you 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 you are going to stop IBM MQ for IBM i.
- How you then proceed depends on whether you 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 ).
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 our applications for you.
On IBM MQ for IBM i V6.0 or later, when you specify ENDCCTJOB(*YES), our applications are not terminated but are instead disconnected from the queue manager.
If you specify ENDCCTJOB(*YES) and we 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.