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.
This diagram shows a graphical representation of the mapping process for general logs as described above.


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