日志管理器域出口 XLGSTRM
在日志管理器域中有一个出口点:XLGSTRM。 您可以使用 XLGSTRM 修改对 MVS 的请求以创建新日志流。 您可以先更改模型日志流名称和其他参数,然后再将其传递给 MVS 系统记录器。
如果由于未向 MVS 定义日志流而导致从 CICS® 到 MVS 系统记录器的日志流连接请求失败,那么 CICS 将使用模型日志流定义向 MVS 系统记录器发出请求以动态创建日志流。
- CICS 系统日志
- &sysname.LSN_last_qualifier。模型
&sysname 是解析为 MVS 映像的系统名称的 MVS 符号。 LSN_last_qualifier 是 JOURNALMODEL 资源定义中指定的日志流名称的最后一个限定符。
如果没有为 DFHLOG 和 DFHSHUNT 提供 JOURNALMODEL 资源定义,或者如果使用组 DFHLGMOD 中提供的 CICS 定义,那么模型日志流名称缺省为 &sysname.DFHLOG.MODEL 和 &sysname。DFHSHUNT.MODEL。
例如,如果 CICS 区域发出为其主系统日志创建日志流的请求,并且 CICS 正在 sysid 为 MV10 的 MVS 映像中运行并且使用缺省 JOURNALMODEL 定义,那么 MVS 系统记录器期望找到名为 MV10.DFHLOG.MODEL。
如果 MVS 映像的系统名称以数字字符开头,并且长度小于 8 个字符,那么 CICS 将以 "C" 作为前缀,以便模型日志流名称变为 C&sysname。LSN_last_qualifier 这是因为 MVS 系统记录器拒绝以数字开头的日志流名称。 如果 MVS 映像的系统名称以数字开头,但长度已为 8 个字符 (最大值) ,那么 CICS 不会添加 "C" 前缀,这意味着 MVS 系统记录器将拒绝缺省模型日志流名称。 但是,全局用户出口程序可以更改模型日志流名称。
- CICS 常规日志
- LSN_qualifier_1.LSN_qualifier2.MODEL. 这两个限定符的缺省值是 CICS 区域用户标识和 CICS 区域 APPLID ,但它们可以是 JOURNALMODEL 资源定义中指定的用户定义值。
例如,如果 CICS 区域用户标识为 CICSHT## 且 APPLID 为 CICSHTA1,那么缺省模型名称为 CICSHT##.CICSHTA1.MODEL。
- 要定义的日志流的名称
- 缺省模型日志流名称
- 系统日志标志
- MVS 系统记录器 IXGINVNT 参数列表。
L R3,UEPMLSN R3 = address of stream name
MVC 0(26,R3),=CL26'NEW.MODEL.NAME' L R9,UEPIXG
IXGINVNT REQUEST=DEFINE,
TYPE=LOGSTREAM,
STRUCTNAME=NEW_STRUCTURE,
MF=(M,(R9),NOCHECK)
...
NEW_STRUCTURE DC CL16'LOG_SYSTEST_009' 您不需要对 IXGINVNT 宏的列表和执行格式进行编码,或者在出口中包含 IXGCON 或 IXGANSAA 宏-这些宏由发出 DEFINE 请求的 CICS 代码提供。
有关 IXGINVNT 服务的信息,请参阅 z/OS MVS Programming: Assembler Services Guide。
XLGSTRM 全局用户出口程序可以设置日志流定义的显式属性,还可以设置导致绕过日志流定义的返回码。
XLGSTRM 的样本全局用户出口程序
DFH$LGLS 是用于 XLGSTRM 出口点的样本全局用户出口程序。 它说明如何访问和更改传递到 XLGSTRM 出口程序的一些参数。 有关更多信息,请参阅 日志管理器域样本出口程序 :DFH$LGLS。