Model log streams for CICS system logs
If CICS® fails to connect to its system log streams because they have not been defined, CICS attempts to have them created dynamically using model log streams.
To create a log stream dynamically, CICS must specify to the MVS™ system logger all the log stream attributes needed for a new log stream. To determine these otherwise unknown attributes, CICS requests the MVS system logger to create the log stream using attributes of an existing model log stream definition. If you decide to allow CICS to create log streams dynamically, you are responsible for creating the required model log stream definitions to ensure that dynamic creation succeeds.
- Each model log stream will be used to create several log streams
- Each log stream created using a model log stream has similar characteristics consistent with the use of the same coupling facility structure
- You don't know in advance how many CICS regions are going to run in a given MVS image (for example, in a development and test environment).
Otherwise, it is probably less work to define the log streams explicitly using IXCMIAPU. Generally, dynamic creation using model log streams is best suited for test and development purposes, and explicit definition for production regions.
- &sysname is the MVS symbol that resolves to the system name of the MVS image
- LSN_last_qualifier is the last qualifier of the log stream name as specified on the JOURNALMODEL resource definition.
Example: If a CICS region issues a request to create a log stream for its primary system log, and CICS is running in an MVS image with a sysid of MV10 and using the default JOURNALMODEL definition, the system logger expects to find a model log stream named MV10.DFHLOG.MODEL.
CICS invokes the XLGSTRM global user exit immediately before calling the MVS system logger to create a log stream. If you don't want to use CICS default values for the creation of a log stream, you can write an XLGSTRM global user exit program to modify the request details, including the model log stream name (in parameter UEPMLSN).