The print log map utility (CSQJU004) on z/OS
CSQJU004 is the batch utility program used to print log data information from the BSDS.
The IBM MQ print log map utility runs as a z/OSĀ® batch program to list the following information:- The BSDS version
- Log data set name and log RBA association for both copies of all active and archive log data sets
- Active log data sets available for new log data
- Contents of the queue of checkpoint records in the bootstrap data set (BSDS)
- Contents of the quiesce history record
- System and utility time stamps
- Passwords for the active and archive log data sets, if provided
We can run the CSQJU004 program regardless of whether the queue manager is running. However, if the queue manager is running, consistent results from the utility can be ensured only if both the utility and the queue manager are running under control of the same z/OS system.
For further information, see- Invoking the CSQJU004 utility
- Data definition statements required for the CSQJU004 utility
To use this utility, the user ID of the job must have the requisite security authorization, or, if the BSDS is password protected, the appropriate VSAM password for the data set.
Invoking the CSQJU004 utility
The following example shows the JCL used to invoke the CSQJU004 utility:
The EXEC statement can use an optional parameter TIME(RAW) which changes the way timestamps are formatted.//JU004 EXEC PGM=CSQJU004,PARM='TIME(RAW)'
This parameter causes timestamps to be formatted without applying timezone or leap second offsets for the formatting system. We can use this mode of operation when formatting a BSDS created at a remote site, or before a daylight saving time change, for example. The default, no parameter specified, is to format timestamps using the current formatting system's timezone and leap second corrections.
Formatted times affected by this parameter are:- highest RBA written
- archive log command times
- checkpoint times
- conditional restart record times
- Data definition statements
-
The CSQJU004 utility requires DD statements with the following DDnames:
- SYSUT1
- This statement is required to specify and allocate the bootstrap data set. If the BSDS must be shared with a concurrently running queue manager subsystem, use DISP=SHR on the DD statement.
- SYSPRINT
- This statement is required to specify a data set or print spool class for print output. The logical record length (LRECL) is 125 and the record format (RECFM) is VBA.
Finding out what the BSDS contains describes the output.