Exit XLGSTRM
Exit XLGSTRM is invoked after the CICS log manager detects that a log stream does not exist and before it calls the MVS system logger to define the log stream dynamically.
- Exit-specific parameters
-
- UEPTRANID
- The address of the 4-byte transaction id.
- UEPUSER
- The address of the 8-byte userid associated with the transaction if the current task is a user task.
- UEPTERM
- The address of the 4-byte terminal id associated with the transaction, if any.
- UEPPROG
- The address of the 8-byte application program name for this transaction, if any.
- UEPLSN
- Address of a 26-character field containing the name of the log
stream to be defined.
Your exit program should not modify the name of the logstream. On return from the exit, CICS® ignores any changes to the contents of the field addressed by UEPLSN. JOURNALMODEL definitions are provided to cater for log stream name selection.
- UEPMLSN
- Address of a 26-character field specifying the name of the model log stream to be used to provide the attributes for the new log stream. This field is modifiable to allow the global user exit program to specify a different model log stream name from the one generated by CICS.
- UEPIXG
- Address of the IXGINVNT macro parameter list for use by the MVS
system logger to define the log stream. Using the MF=M form of the
IXGINVNT macro, the global user exit program can specify the log stream
attributes to be used.
For details of the IXGINVNT macro, see the z/OS MVS Programming: Authorized Assembler Services Guide.
- UEPLGTYP
- Address of a 1-byte field indicating whether the log stream being
created is for a system log or a general log. Valid values are:
- UEPSYSLG
- The log stream is for a CICS system log.
- UEPGENLG
- The log stream is for a general log (a forward recovery log, a user journal, or auto-journal).
- Return codes
-
- UERCNORM
- CICS continues and attempts to define the log stream.
- UERCBYP
- CICS does not attempt to define the log stream. The process that was attempting to use the log stream may fail (for example, a data set open).
- XPI calls
- All can be used.
- API and SPI commands
- Must not be used.