utility programs, introduction, CSQUTIL (WebSphere MQ utility program), utility program (CSQUTIL), utility functions, page sets, issuing commands, from CSQUTIL, issuing, commands, queue management utility functions, messages from a queue (COPY), copying, restoring messages to a queue" /> WebSphere MQ utility program (CSQUTIL)

 

WebSphere MQ utility program (CSQUTIL)

 

The CSQUTIL utility program is provided with WebSphere MQ to help you to perform backup, restoration, and reorganization tasks, and to issue WebSphere MQ commands. Through this utility program, we can invoke functions in these groups:

Page set management

These functions enable you to manage WebSphere MQ page sets. We 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 WebSphere MQ

  • Produce a list of DEFINE, ALTER or DELETE commands for your WebSphere 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, we can:

  • Copy messages from a queue to a data set

  • Delete messages from a queue

  • Restore previously copied messages to their respective 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 WebSphere MQ program, issuing commands through the command server and using the WebSphere 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 WebSphere MQ DISPLAY commands, and to use the WebSphere MQ API to access any queues that you want to manage. See the usage notes for each function for more information.