IBM SC34-6814-04 Server User Manual


 
For information about the IXGINVNT service, see the OS/390 MVS Authorized
Assembler Services manual.
An XLGSTRM global user exit program can set explicit attributes for the log stream
definition, and can also set a return code that causes the log stream definition to be
bypassed.
Note: If you want XLGSTRM to intercept the connection of the CICS system logs,
you must enable your exit program in a first-phase PLT program.
Exit XLGSTRM
When invoked
After the CICS log manager detects that a log stream does not exist and
before calling 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 OS/390 MVS
Authorized Assembler Services manual.
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:
166 Customization Guide