IBM MQ utility program (CSQUTIL) on z/OS
The CSQUTIL utility program is provided with IBM® MQ to help you to perform backup, restoration, and reorganization tasks, and to issue IBM MQ commands.
- Page set management
- These functions enable you to manage IBM MQ page sets. You can format data sets as page sets, change the recovery processing performed against page sets, extract page set information, increase the size of page sets and reset the log information contained in a page set. The page set must not belong to a queue manager that is currently running.
- Command management
-
These functions enable you to:
- Issue commands to IBM MQ
- Produce a list of DEFINE, ALTER, or DELETE commands for your IBM MQ objects
- Queue management
-
These functions enable you to back up and
restore queues and page sets, copy queues and page sets to another queue manager, reset your queue
manager, or to migrate from one queue manager to another. Specifically, you can:
- Copy messages from a queue to a data set
- Delete messages from a queue
- Restore previously copied messages to their appropriate queues
The scope of these functions can be either:- A queue, in which case the function operates on all messages in the specified queue.
- A page set, in which case the function operates on all the messages, in all the queues, on the specified page set.
Use these functions only for your own queues; do not use them for system queues (those with names beginning SYSTEM).
All the page set management functions, and some of the other functions, operate while the queue manager is not running, so you do not need any special authorization other than the appropriate access to the page set data sets. For the functions that operate while the queue manager is running, CSQUTIL runs as an ordinary z/OS® batch IBM MQ program, issuing commands through the command server, and using the IBM MQ API to access queues.
You need the necessary authority to use the command server queues (SYSTEM.COMMAND.INPUT, SYSTEM.COMMAND.REPLY.MODEL, and SYSTEM.CSQUTIL.*), to use the IBM MQ DISPLAY commands, and to use the IBM MQ API to access any queues that you want to manage. See the usage notes for each function for more information.