Mapping of general log streams
CICS® uses the default log stream names unless you provide a JOURNALMODEL resource definition for the journal or log.
If there is a JOURNALMODEL definition for the log, CICS attempts to connect to the log stream named in the definition.
If you define JOURNALMODEL resource definitions for your system
logs, ensure that:
- The log streams named in the definition are defined to the MVS™ system logger, or
- Suitable model log streams are defined so that they can be created dynamically.
If CICS cannot connect to the log stream named in the JOURNALMODEL
definition, it attempts to connect to a log stream, using the default
name:
userid.applid.journalname
Before you try to use this default log stream name, ensure that
- The default log stream is defined explicitly to the MVS system logger, or
- A suitable model log stream is defined so that it can be created dynamically.
If the log stream is not available (perhaps it has not been defined
to MVS) or the definition is not found (perhaps
it has not been installed), CICS attempts to create a log stream using
the default name:
LSN_QUALIFIER1.LSN_QUALIFIER2.MODEL
where
the qualifier fields are based on the JOURNALMODEL definition streamname
attribute, as follows: - If the log stream being created has a qualified name consisting of only two names (qualifier1.qualifier2) or has an unqualified name, CICS constructs the model name as qualifier1.MODEL or name.MODEL.
- If the log stream being created has a qualified name consisting of 3 or more names (qualifier1.qualifier2....qualifier_n), CICS constructs the model name as qualifier1.qualifier2.MODEL.
Once the log stream has been created, CICS connects to it.
Figure 1 shows a graphical representation of the mapping process for general logs.
Figure 1. How a CICS journal is mapped
to its log stream name (LSN). The name is DFHJ02, used
here for user journaling and file control autojournaling.
