日志管理器域出口 XLGSTRM

在日志管理器域中有一个出口点:XLGSTRM。 您可以使用 XLGSTRM 修改对 MVS 的请求以创建新日志流。 您可以先更改模型日志流名称和其他参数,然后再将其传递给 MVS 系统记录器。

如果由于未向 MVS 定义日志流而导致从 CICS® 到 MVS 系统记录器的日志流连接请求失败,那么 CICS 将使用模型日志流定义向 MVS 系统记录器发出请求以动态创建日志流。

CICS 传递给 MVS 的模型日志流名称取决于日志名称是指系统日志还是指 CICS 常规日志,如下所示:
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&sysnameLSN_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。

以下信息将传递到 XLGSTRM 全局用户出口程序:
  • 要定义的日志流的名称
  • 缺省模型日志流名称
  • 系统日志标志
  • MVS 系统记录器 IXGINVNT 参数列表。
出口程序可以通过更新 UEPMLSN 出口特定参数所指向的字段来修改模型流名称。 以下是出口程序如何更改模型流名称的示例:
          L     R3,UEPMLSN          R3 = address of stream name
          MVC   0(26,R3),=CL26'NEW.MODEL.NAME'
通过更新 UEPIXG 参数指向的字段,出口程序可以修改 MVS 系统记录器用于定义日志流的 IXGINVNT 宏参数列表。 使用宏的 IXGINVNT MF=M 格式,这允许出口指定要使用的日志流属性。 以下是出口程序如何更改结构名称的示例:
          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 拦截 CICS 系统日志的连接,那么必须在第一阶段 PLT 程序中启用出口程序。

XLGSTRM 的样本全局用户出口程序

DFH$LGLS 是用于 XLGSTRM 出口点的样本全局用户出口程序。 它说明如何访问和更改传递到 XLGSTRM 出口程序的一些参数。 有关更多信息,请参阅 日志管理器域样本出口程序 :DFH$LGLS