Using the WebSphere MQ utilities
This chapter introduces the WebSphere MQ utility programs that are provided to help you perform various administrative tasks. The utility programs are described in the following chapters. Table 6, Table 7, Table 8, Table 10, and Table 11, summarize what we can do with these utilities.
Table 6. The WebSphere MQ CSQUTIL utility program: Managing page sets Purpose Function See topic Format VSAM data sets as WebSphere MQ page sets. FORMAT Formatting page sets (FORMAT) Control recovery processing used for WebSphere MQ page sets. FORMAT Formatting page sets (FORMAT) Extract page set information. PAGEINFO Page set information (PAGEINFO) Copy WebSphere MQ page sets. COPYPAGE Expanding a page set (COPYPAGE) Copy WebSphere MQ page sets and reset the log information. RESETPAGE Copying a page set and resetting the log (RESETPAGE)
Table 7. The WebSphere MQ CSQUTIL utility program: Issuing commands Purpose Function See topic Issue WebSphere MQ commands. COMMAND Issuing commands to WebSphere MQ (COMMAND) Produce a set of DEFINE, ALTER or DELETE commands for objects. COMMAND Making a list of DEFINE commands Produce a client channel definition file. COMMAND Making a client channel definition file Produce a set of DEFINE commands for objects (offline). SDEFS Producing a list of WebSphere MQ define commands (SDEFS)
Table 8. The WebSphere MQ CSQUTIL utility program: Managing queues Purpose Function See topic Copy contents of a queue to a data set. COPY Copying queues into a data set while the queue manager is running (COPY) Copy contents of a queue to a data set (offline). SCOPY Copying queues into a data set while the queue manager is not running (SCOPY) Delete contents of a queue. EMPTY Emptying a queue of all messages (EMPTY) Restore contents of a queue. LOAD Restoring messages from a data set to a queue (LOAD)
Table 9. The WebSphere MQ CSQUTIL utility program: Migrating CSQXPARM Purpose Function See topic Produce an ALTER QMGR command from a channel initiator parameter module. XPARM Migrating a channel initiator parameter module (XPARM)
Table 10. The WebSphere MQ CSQJU003 Change log inventory utility Purpose Function See topic Add active or archive log data sets. NEWLOG Adding information about a data set to the BSDS (NEWLOG) Delete active or archive log data sets. DELETE Delete information about a data set from the BSDS (DELETE) Supply passwords for archive logs. ARCHIVE Supplying a password for archive log data sets (ARCHIVE) Control the next restart of the queue manager. CRESTART Controlling the next restart (CRESTART) Set checkpoint records. CHECKPT Set checkpoint records (CHECKPT) Update the highest written log RBA. HIGHRBA Updating the highest written log RBA (HIGHRBA)
Table 11. The remaining WebSphere MQ utilities Name Purpose See topic CSQJU004 (Print log map utility) List information about the log. The print log map utility (CSQJU004) CSQ1LOGP (Log print utility) Print the log. Extract log records into sequential files.
The log print utility (CSQ1LOGP) CSQ5PQSG (WebSphere MQ table update utility) Add and remove queue-sharing group and queue manager entries in the WebSphere MQ tables held in the shared DB2 data-sharing group. The queue-sharing group utility (CSQ5PQSG) CSQJUFMT (Active log preformat utility) Preformat log data sets The active log preformat utility (CSQJUFMT) CSQUDLQH (Dead-letter queue handler utility) Process messages on the dead-letter queue. The dead-letter queue handler utility (CSQUDLQH) CSQUCVX (Data conversion exit utility) Generate data conversion exit routines. For information about the CSQUCVX utility, see the WebSphere MQ Application Programming Guide.
These utilities are located in the thlqual.SCSQAUTH or thlqual.SCSQLOAD WebSphere MQ load libraries. Include the appropriate WebSphere MQ language load library thlqual.SCSQANLx (where x is the language letter) in the STEPLIB concatenation before thlqual.SCSQAUTH or thlqual.SCSQLOAD. The utility control statements are available only in U.S. English. In some cases, the DB2 library db2qual.SDSNLOAD is also needed.