+

Search Tips | Advanced Search

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:
  1. Sign on to a new interactive IBM MQ for IBM i session, ensuring that you are not accessing any objects.
  2. Ensure that we have:

    • *ALLOBJ authority , or object management authority for the QMQM library
    • Sufficient authority to use the ENDSBS command
  3. Advise all users that you are going to stop IBM MQ for IBM i.
  4. 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.