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 log of logs contains records that are written each time a file is opened or closed. At file-open time, a tie-up record is written that identifies:
  • 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.
At file-close time, a tie-up record is written that identifies:
  • 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).



dfht24x.html | Timestamp icon Last updated: Sunday, 4 June 2017