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 non-essential queue manager maintenance tasks.

There are two ways of specifying a target time when you use the endmqm command. The -t option allows all queue manager maintenance tasks to complete, which might prolong the phase of the queue manager ending. The -tp option interrupts non-essential queue manager maintenance tasks if necessary to comply with the specified target time.

Non-essential maintenance tasks include: queue file compaction, and persisting NPMCLASS(HIGH) messages. In the rest of this page, the word 'housekeeping' is used.

Depending on your application usage patterns, queue file compaction can take a long time, so if your primary goal is ending the queue manager quickly, then use the -tp option.

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 performs housekeeping. A time limited shutdown quits these 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.