Ending a queue manager within a target time
You can end the queue manager within a target time of a number of seconds that you specify, either with or without interrupting essential queue manager maintenance tasks.
There are two ways of specifying a target time when you use the endmqm command. The -t option allows essential queue manager maintenance tasks to complete, which might prolong the phase of the queue manager ending. The -tp option interrupts essential queue manager maintenance tasks if necessary to comply with the specified target time.
When you specify a target time, the shutdown type of -w,
-i, or -p indicates the starting shutdown type.
Note: An
immediate
shutdown is still orderly, differing from a controlled
shutdown primarily in the way that any running applications are quiesced. An
immediate
shutdown still takes housekeeping actions such as queue compaction, and
persisting NPMCLASS(HIGH) messages that could be time consuming, whereas a time limited shutdown
quits these additional actions when they interfere with meeting the target time.The queue manager escalates the shutdown type as necessary, in an attempt to meet the target
time. For example:
- A 10 second -t target starting at -w might be seven
seconds quiescing, two seconds immediate shutdown of the queue manager, including housekeeping, then
immediate shutdown without further
housekeeping:
endmqm -w -t 10 queue_manager
- A 10 second -tp target might be seven seconds quiescing, two seconds
immediate shutdown of the queue manager, including housekeeping, one second immediate shutdown
without further housekeeping, then start ending IBM® MQ
processes:
endmqm -c -tp 10 queue_manager
- A two second -tp target at -i might be one second
immediate shutdown of the queue manager, including housekeeping, one second immediate shutdown
without further housekeeping, then start ending IBM MQ
processes:
endmqm -i -tp 2 queue_manager
- A one second target at -w could be 0.1 seconds at
wait
, for example, just long enough to send out IBM MQ return codes to connected applications, 0.9 seconds immediate shutdown of the queue manager, including housekeeping, then immediate shutdown without further housekeeping; then start ending IBM MQ processes.