Defining JOURNALMODELs

CICS® uses JOURNALMODEL definitions to resolve log stream names.

About this task

CICS resolves log stream names at the following times:

System log
During initialization, on an initial start only.

On a cold, warm or emergency restart, CICS retrieves the log stream name from the CICS global catalog.

General logs
When a journal name is first referenced after the start of CICS, or when it is first referenced again after its log stream has been disconnected. Log stream disconnection, requiring further reference to a matching JOURNALMODEL resource definition, occurs as follows:
User journals
As soon as you issue a DISCARD JOURNALNAME command.

Any further references to the discarded journal name means that CICS must again resolve the log stream name by looking for a matching JOURNALMODEL resource definition. You can change the log stream name for a user journal by installing a modified JOURNALMODEL definition.

Auto journals for files
All files that are using the log stream for autojournaling are closed.
Forward recovery logs
All files that are using the log stream for forward recovery logging are closed.
A JOURNALMODEL definition generally specifies a generic journal name, thereby mapping to the same MVS™ log stream any journal names that match on the generic name. JOURNALMODEL definitions can also be specific models and, using JOURNALMODEL definitions, you can map many journals or forward recovery logs to the same MVS log stream, or assign them to SMF (see Figure 1).
Figure 1. Looking for a journal model that matches a journal name. CICS searches the Table of installed journal models to find the log stream name that corresponds to the journal name, using a "best-match" algorithm.
This diagram shows a user application program that is writing a request to a journal with the name DFHJ06. The CICS log manager is accessed but the name DFHJ06 is not known. The CICS log manager links to the Table of installed journal models where the nearest match is DFHJ0*, with a log stream name CICSHT##.CICSHTA1.DFHJ0X that is returned to the CICS log manager.


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