Defining JOURNALMODELs

CICS uses JOURNALMODEL definitions to resolve 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 (excluding log streams defined in the ICF catalog)
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 (excluding those defined in the ICF catalog)
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 8).

Figure 8. 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.
[[ Contents Previous Page | Next Page Index ]]