Defining the log of logs
Define a log of logs log stream, and define a JOURNALMODEL resource definition that references that log stream.
About this task
The CICS-supplied group, DFHLGMOD, includes a JOURNALMODEL for the log of logs, called DFHLGLOG, which has a log stream name of &USERID..CICSVR.DFHLGLOG. Note that &USERID resolves to the CICS® region userid, and if your CICS regions run under different RACF® user IDs, the DFHLGLOG definition resolves to a unique log of logs log stream name for each region. However, a separate log of logs is not recommended for recovery products such as CICS VSAM recovery, and you should consider defining a log stream that is shared between CICS regions within the same CICSplex. For example, you might define one log stream for all the CICS regions that are members of the same production CICSplex, and another for test regions, choosing a high-level qualifier that reflects the scope of the log of logs. Using a CICSplex-wide log stream for the log of logs is particularly important if you are using VSAM RLS and multiple CICS application-owning regions have direct access to the same data sets.
- The name of the file
- The name of the underlying VSAM data set
- The name of the forward recovery log stream
- The name of the CICS region that performed the file open.
- The name of the file
- The name of the CICS region that performed the file close.
The log of logs assists forward recovery utilities to maintain an index of log data sets.
In addition to forward recovery, the log of logs is also used for recording log stream errors. When a log stream failure occurs, CICS tries to update the log of logs with the error and diagnostic information, unless DFHLGLOG is defined as TYPE(DUMMY).