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.