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.

Through this utility program, we can invoke functions in these groups:

    Page set management
    These functions enable you to manage IBM 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 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, we 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 we 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 to manage. See the usage notes for each function for more information.

Attention: If we use CSQUTIL to define a channel, and the connection name contains two parts (the host name and port number) you must enclose the host name and port number within single quotation marks to maintain the limit on the number of permissible parameters. Similarly, if your connection name consists of an IP address and port number, you must enclose these parameters within single quotation marks.