Archive log management reports
PACLOG provides the following management reports for log data sets, all of which are generated by DD statements in the JCL.
The figures in Processed archive log data set report provide samples of these reports.
The processed archive log data set report provides lists of archive log data sets that have been processed by the most recently completed PACLOG job.
PACLOG generates two lists: one of all primary copies of the log data sets that have been processed, and a second of all secondary copies processed. These lists are written to the data sets that are specified by the ALMLIST1, ALMLIST2, ALMLIST3, and ALMLIST4 DD statements, which must be included in your PACLOG JCL.
The expired archive log data set report lists all archive log data sets (found by the most recently completed PACLOG job) in the BMC archive history file that have been dropped from the BSDS since the prior PACLOG job.
These archive log data sets are also removed from the archive history file. This list is written to the data set that is specified by the ALMXPIRE DD statement, which you must include in your PACLOG JCL.
You can also use the output from all reports as input to other tools to facilitate further processing of the data sets that are included in the reports.
Processed archive log data set report
The following figure shows a sample processed primary archive log data set report.
Three archive log data sets were processed, and the lists were written to the file specified by the ALMLIST1 statement.
ALMLIST1 DB21CAT.ARCHLOG1.A0003766 PROCESSED ALMLIST1 DB21CAT.ARCHLOG1.A0003767 PROCESSED ALMLIST1 DB21CAT.ARCHLOG1.A0003768 PROCESSED
The following figure shows a sample processed secondary archive log data set report.
ALMLIST2 DB21CAT.ARCHLOG2.A0003766 PROCESSED ALMLIST2 DB21CAT.ARCHLOG2.A0003767 PROCESSED ALMLIST2 DB21CAT.ARCHLOG2.A0003768 PROCESSED
For more information, see Specifying the PACLOG data set DD statements. Similar reports are available for the offsite copies by specifying the by ALMLIST3 and ALMLIST4 DD statements.
Expired archive log data sets report
The following figure shows a sample of an expired archive log data set report.
It shows six archive log data sets that are no longer in the BSDS. The list is written to the file that is specified by the ALMXPIRE DD statement (see Specifying the PACLOG data set DD statements).
ALMXPIRE DB21CAT.ARCHLOG1.A0003264 NO LONGER IN ARCHIVE HISTORY ALMXPIRE DB21CAT.ARCHLOG2.A0003264 NO LONGER IN ARCHIVE HISTORY ALMXPIRE BMCARM.DB21CY3I.A0003264 NO LONGER IN ARCHIVE HISTORY ALMXPIRE BMCARM.DB21CY4I.A0003264 NO LONGER IN ARCHIVE HISTORY ALMXPIRE DB21CAT.ARCHLOG1.A0003265 NO LONGER IN ARCHIVE HISTORY ALMXPIRE DB21CAT.ARCHLOG2.A0003265 NO LONGER IN ARCHIVE HISTORY
Using output from the reports
You can use the output from the processed log data set reports and the expired log data set report to perform further processing of the data sets that have been reported.
For example, you might want to delete the data sets that were reported by the expired log data set report.
To allow you to process the output from these reports, PACLOG writes a unique message for each completed report to the PACLOG messages file. You can customize this message to initiate further processing by the tool you want to use.
The following table shows the messages and how you can use them. You can find the messages in the file indicated by the ALMMSGS DD statement, which is delivered as .DBCNTL(ALMMSGS). The listed messages are identified as 00651I, 00652I, 00663I, 00664I, and 00654I in the ALMMSGS member.
ALMLIST1 report postprocessing
ALMLIST2 report postprocessing
ALMLIST3 report postprocessing
ALMLIST4 report postprocessing
ALMXPIRE report postprocessing
You can customize the contents of each message to create appropriate syntax for post-processing of the reports.
It is important that you maintain the original number of % symbols in the message. These terms are used for variable substitution (such as data set name).