Specifying a JOURNALMODEL resource definition
During a cold start, and a warm and emergency restart, CICS® retrieves the names of its system log streams from the global catalog, ensuring that it reconnects to the same log streams that were used on the previous run.
During an initial start, CICS uses default log stream names, unless you specify otherwise on a JOURNALMODEL resource definition. The process of selecting and connecting to a system log stream is as follows:
- Without a JOURNALMODEL definition
- If CICS can't find
a JOURNALMODEL resource definition for DFHLOG and DFHSHUNT, it issues
calls to the MVS™ system logger
to connect to its system log streams using default names. These are:
region_userid.applid.DFHLOG
where region_userid is the RACF® user ID under which the CICS address space is running, and applid is the region's z/OS® Communications Server APPL name (taken from the APPLID system initialization parameter). The CICS-supplied JOURNALMODEL definitions for default DFHLOG and DFHSHUNT log streams are in the CSD group DFHLGMOD, which is included in DFHLIST.
region_userid.applid.DFHSHUNTIf you use these default log stream names, ensure that- The default log streams are defined explicitly to the MVS system logger, or
- Suitable model log streams are defined for dynamic creation.
- With a JOURNALMODEL definition
- If CICS finds a JOURNALMODEL
definition with JOURNALNAME(DFHLOG) and JOURNALNAME(DFHSHUNT), it
issues calls to the MVS system
logger to connect to the system log streams named in the definitions.
Ensure that the system log stream names are unique to the CICS region. If you define JOURNALMODEL resource definitions for your system logs, ensure that:
- The log streams named in the JOURNALMODEL are defined to the MVS system logger, or
- Suitable model log streams are defined that enable them to be created dynamically.
If you don't want to use a system log (for example, in a CICS test region), specify JOURNALMODEL resource definitions for DFHLOG and DFHSHUNT with TYPE(DUMMY). Note that running CICS with the system log defined as TYPE(DUMMY) forces you to perform an initial start, and CICS does not support dynamic transaction backout.