IMS log utilities

DBCTL enables you to use the following IMS log utilities: the log archive utility, the log recovery utility, and the file select and formatting print utility.

The IMS log utilities are as follows:

The log archive utility, DFSUARC0

This utility produces a system log data set (SLDS) from a filled OLDS. DBCTL can automatically invoke DFSUARC0 to archive the OLDS when an OLDS switch occurs.

You use the ARC= parameter in the DBC procedure to control automatic archiving. See System definition in IMS product documentation for further guidance on specifying ARC, and Database utilities in IMS product documentation for guidance on setting up the skeleton JCL needed.

Alternatively, you can use the DBRC command GENJCL.ARCHIVE to initiate manually an archive if you did not specify the automatic archive option, or if an automatic archive fails. See Operations and automation in IMS product documentation for further guidance about automatic archiving.

The log archive utility runs as a batch job, and you can run multiple log archive jobs concurrently. The SLDS it creates can be on DASD, MSS, or tape. DFSUARC0 is the preferred utility for archiving logs in a CICS-IMS environment.

The log recovery utility, DFSULTR0

This utility produces a usable log data set from one that contains read errors or could not be closed properly. You can recover both system log data sets (SLDSs) and online log data sets (OLDSs) with this utility.

The file select and formatting print utility, DFSERA10

This utility enables you to display and examine data from the IMS log data set in the following ways:

• Print or copy a whole log data set.
• Print or copy from multiple log data sets based on control statement input.
• Select and print log records according to their sequential position in the data set.
• Select and print log records based upon data contained within the record itself, such as the contents of a time, date or identification field.
• Enable your exit routines to do special processing on selected log records.

See Database utilities in IMS product documentation for further guidance on using these utilities.