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.
