The change log inventory utility (CSQJU003) on z/OS
The IBM MQ change log inventory utility runs as a z/OS batch job to change the bootstrap data set (BSDS).
Through this utility, we can invoke these functions:
- NEWLOG
- Add active or archive log data sets.
- DELETE
- Delete active or archive log data sets.
- ARCHIVE
- Supply passwords for archive logs.
- CRESTART
- Control the next restart of IBM MQ.
- CHECKPT
- Set checkpoint records.
- HIGHRBA
- Update the highest written log RBA.
Only run this utility when IBM MQ is stopped. This is because the active log data sets named in the BSDS are dynamically added for exclusive use to IBM MQ and remain allocated exclusively to IBM MQ until it terminates. We can add new active log data sets to an active queue manager with the DEFINE LOG on z/OS command.
The DEFINE LOG command can be used to update a BSDS of any version. However, we must use the CSQJUCNV utility to convert the BSDS from version 1 to version 2. A version 1 BSDS has space for up to 31 active log data sets in each log copy ring, whereas a version 2, or higher, BSDS has space for up to 310 active log data sets in each log copy ring.
- Invoking the CSQJU003 utility on z/OS
Use this topic to understand how to invoke the CSQJU003 utility. - Adding information about a data set to the BSDS (NEWLOG) on z/OS
We can use the NEWLOG function of CSQJU003 to add information about a data set to BSDS. - Delete information about a data set from the BSDS (DELETE) on z/OS
We can use the DELETE function of CSQJU003 to delete all information about a specified log data set or data set volume from the bootstrap data sets. - Supplying a password for archive log data sets (ARCHIVE) on z/OS
We can use the ARCHIVE function of CSQJU003 to assign a password to all archive data sets created after this operation. - Control the next restart (CRESTART) on z/OS
We can use the CRESTART function of CSQJU003 to control the next restart of the queue manager, either by creating a new conditional restart control record or by canceling the one currently active. - Set checkpoint records (CHECKPT) on z/OS
We can use the CHECKPT function of CSQJU003 to add or delete a record in the BSDS checkpoint queue. - Updating the highest written log RBA (HIGHRBA) on z/OS
We can use the HIGHRBA function of CSQJU003 to update the highest written log RBA recorded in the BSDS for either the active or archive log data sets.
Parent topic: Use the IBM MQ utilities on z/OS