Usage notes

  1. The queues involved must not be in use when the function is invoked.

  2. This function operates only on local queues.

  3. If you want to operate on a range of page sets, repeat the EMPTY function for each page set.

  4. We cannot empty the system-command input queue (SYSTEM.COMMAND.INPUT).

  5. An EMPTY PSID function is considered successful only if it successfully empties all the queues on the page set.

  6. If you empty a queue that is already empty (either explicitly by EMPTY QUEUE or because there are one or more empty queues on a page set that you are emptying), the EMPTY function is considered to be a success. However, if you attempt to empty a nonexistent queue, or a page set containing no queues, the EMPTY function fails.

  7. If EMPTY fails or is forced to take a syncpoint, no further CSQUTIL functions are attempted.

  8. You need the necessary authority to use the command server queues (SYSTEM.COMMAND.INPUT, SYSTEM.COMMAND.REPLY.MODEL, and SYSTEM.CSQUTIL.*), to use the DISPLAY QUEUE and DISPLAY STGCLASS MQSC commands, and to use the WebSphere MQ API to get messages from the queues that you want to empty.