DSNJU004 (print log map)

The DSNJU004 (print log map) stand-alone utility generates a variety of information that can be useful in backup and recovery situations.

The print log map (DSNJU004) utility lists the following information:

  • Log data set name, log RBA association, and log LRSN for both copy 1 and copy 2 of all active and archive log data sets
  • Active log data sets that are available for new log data
  • Status of all conditional restart control records in the bootstrap data set
  • Contents of the queue of checkpoint records in the bootstrap data set
  • The communication record of the BSDS, if one exists
  • Contents of the quiesce history record
  • System and utility timestamps
  • Contents of the checkpoint queue
  • Archive log command history
  • BACKUP SYSTEM utility history
  • System CCSID information
  • System-level backup information
  • Start of changeInformation about deactivated and destroyed data sharing membersEnd of change

In a data sharing environment, the DSNJU004 utility can list information from any or all BSDSs of a data sharing group.

Environment

The DSNJU004 program runs as a batch job.

This utility can be executed either when DB2® is running and when it is not running. However, to ensure consistent results from the utility job, the utility and the DB2 online subsystem must both be executing under the control of the same operating system.

Authorization required

The user ID of the DSNJU004 job must have requisite RACF® authorization.

Required and optional data sets

DSNJU004 recognizes DD statements with the following DD names:

SYSUT1
Specifies and allocates the bootstrap data set. This statement is required. It allocates the BSDS. If the BSDS must be shared with a concurrently executing DB2 online subsystem, use DISP=SHR on the DD statement.
SYSPRINT
Specifies a data set or print spool class for print output. This statement is required. The logical record length (LRECL) is 125.
SYSIN (optional)
Contains the control statement. If you do not specify the SYSIN DD statement, BSDS information is printed only from the BSDS data set that is identified by the SYSUT1 DD statement.
GROUP
Names a single BSDS. DB2 can use this BSDS to find the names of all BSDSs in the group. Ensure that the BSDS name that you specify is not the BSDS of a member that has been quiesced since before new members joined the group. This statement is required if the control statement specifies either of these options:
  • MEMBER *
  • MEMBER(member-name)
MnnBSDS
Names the BSDS data set of a group member whose information is to be listed. You must specify one such DD statement for each member. The statements are required if the control statement specifies MEMBER DDNAME. nn represents a two-digit number. You must use consecutive two-digit numbers from 01 to the total number of required members. If a break occurs in the sequence of numbers, any number after the break is ignored.

Running the DSNJU004 utility

Use the following EXEC statement to execute this utility: 

//   EXEC   PGM=DSNJU004

Recommendations

  • For dual BSDSs, execute the print log map utility twice, once for each BSDS, to compare their contents.
  • To ensure consistent results for this utility, execute the utility job on the same z/OS® system on which the DB2 online subsystem executes.
  • Execute the print log map utility regularly, possibly daily, to keep a record of recovery log data set usage.
  • Use the print log map utility to document changes that are made by the change log inventory utility.