Usage notes
- The queues involved must not be in use when the function is invoked.
- This function operates only on local queues.
- If you want to operate on a range of page sets, repeat the EMPTY function for each page set.
- We cannot empty the system-command input queue (SYSTEM.COMMAND.INPUT).
- An EMPTY PSID function is considered successful only if it successfully empties all the queues on the page set.
- 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.
- If EMPTY fails or is forced to take a syncpoint, no further CSQUTIL functions are attempted.
- 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.