WebSphere® Application Server for z/OS®
提供对设置优化本地适配器跟踪级别以帮助应用程序、连接或服务器诊断的支持。可设置三个跟踪级别以捕获详细数据、粗略数据或不捕获任何跟踪数据。它们分别被指定为跟踪级别 2、1 和 0。
开始之前
优化本地适配器中的动态跟踪支持提供一些方法以设置或更改现有跟踪级别而不重新启动服务器,包括:
- 在属性文件中预定义服务器范围跟踪。这允许您在服务器启动时定义一组跟踪,以便启用了跟踪的优化本地适配器处理立即就绪。可使用
WebSphere Application
Server for z/OS 管理控制台和 SETOLATRACEPROPS
系统修改命令来指定属性文件并使其生效。
- 定义跟踪级别。您可以使用跟踪属性文件同时为已向优化本地适配器注册的连接指定服务器范围缺省跟踪级别和个人跟踪级别。可以为属性文件中的每一个条目将跟踪级别设置为 0、1 或 2。
- 使用 z/OS SETOLATRACE 操作员修改命令对现有注册设置特定跟踪级别。该命令还可对注册名称、作业名称或服务器控制的存储器中的特定注册条目控制块 (RGE) 设置跟踪级别。
- 在跟踪属性文件和 SETOLATRACE 修改命令中使用星号 (*) 作为通配符来指示多组连接的设置。通配符功能可在属性文件中指定多个注册名称或用于指定系统缺省设置,并可在 SETOLATRCE 修改命令中设置多个注册名称和作业名称。
- 注册完成时,使用优化本地适配器的应用程序的开发人员还可通过在 BBOA1REG 调用中设置跟踪标志来设置程序连接有效时段的跟踪。
过程
- 预定义跟踪级别。 预定义跟踪级别可帮助您在优化本地适配器初始化时就准备好捕获注册和连接跟踪数据。它还可帮助您准备好跟踪针对尚未注册的连接的活动;进行所指示的注册时,跟踪会自动进行。按如下所示预定义跟踪级别:
- 在 HFS 中创建跟踪属性文件。 此文件应使用 EBCDIC 编码并可供 WebSphere Application Server for z/OS 守护程序访问。
跟踪属性文件语法遵循 WebSphere Application
Server 属性文件语法:<
keyword>=<
parameter>。在此情况下,该属性的语法如下所示:
<registration_name>=<trace_level>
其中:
<registration_name> 是字母数字字符串
<trace_level> 为 0、1 或 2
为清晰起见,指示注册名称时可使用单引号或双引号样式语法,例如:
MYREGNAME=1 "CICSREG"=2 'SHORTREG'=0
还可通过使用星号作为通配符将名称相似的注册组合到一行中,例如:
REGNAME*=1 *NAME=2 "REG*NAME"=0
前导 # 字符指示注释开头,在带引号字符串中时除外。
要点: - 任何无效跟踪级别都被视为 0。例如,REGNAME=ALL 被视为跟踪级别 0。
- 注册名称“*”被视为缺省跟踪级别,例如,如果指定了 *=1,那么任何新注册的缺省跟踪都是粗略级别跟踪。
- 该属性文件最多可指定 1,024 个跟踪设置。
SETOLATRACEPROPS 命令发出响应消息,该消息显示针对注册处理的不同于系统缺省设置的跟踪定义数。
- 在管理控制台中创建环境变量 WAS_DAEMON_ONLY_ola_trace_settings_file。
- 将该变量设置为字符串以表示 HFS 中跟踪属性文件的标准路径和文件名,并激活该变量。
如果在
WebSphere Application
Server 配置中设置并保存了此环境变量,那么会在服务器初始化时处理该属性文件。可通过发出 SETOLATRACEPROPS 修改命令来更新跟踪属性文件并激活新定义,新跟踪属性会影响新注册。语法为:
F daemonname,SETOLATRACEPROPS
注意: 激活跟踪设置属性文件会取消激活任何当前生效的跟踪属性。
- 修改现有连接的跟踪设置。 对于使用优化本地适配器的当前连接,可使用 SETOLATRACE 修改命令开启或关闭跟踪。该命令有以下形式:
F servername,SETOLATRACE=tracelevel,REGNAME=namestring
F servername,SETOLATRACE=tracelevel,JOBNAME=namestring
F servername,SETOLATRACE=tracelevel,RGE=hexaddress
跟踪级别可为 0、1 或 2,分别表示:不进行跟踪、粗略级别跟踪和详细跟踪。namestring 指定要修改的现有注册的注册名称或作业名。可使用匹配的单引号或双引号来对 namestring 定界。同样,可使用星号作为通配符来修改多个名称相似的作业或注册。单个星号影响每个现有注册。可使用下列任一命令关闭当前注册的所有跟踪:
F servername,SETOLATRACE=0,REGNAME=*
F servername,SETOLATRACE=0,JOBNAME=*
如果您要通过服务器控制的存储器中的 RGE 地址以将特定注册作为目标,那么可使用该命令的 RGE=hexaddress 形式。十六进制地址是不带引号的十六进制数字字符串。IBM® 支持团队可能会指示您使用此方法。
SETOLATRACE
命令显示一条响应消息,该消息指示受影响的注册数。
- 对注册指定跟踪设置。 可在调用 BBOA1REG API 以向优化本地适配器创建注册的代码中请求跟踪。BBOA1REG
的接口包含名为 registerflags 的参数。可以通过将下列一个或多个值设置到 registerflags 参数中来修改注册的跟踪级别设置:
reg_flag_trcmod EQU X'80000000' modify trace level
reg_flag_trcmore EQU X'40000000' trace level=2
reg_flag_trcsome EQU X'20000000' trace level=1
如果要修改注册的跟踪设置,请设置 reg_flag_trcmod。如果您不设置此标志,那么不会对跟踪设置进行更改,而是使用系统缺省值或者使用预定义的适用于注册名称或作业名的跟踪设置。
如果希望进行详细跟踪或粗略级别跟踪,请设置 reg_flag_trcmore
或 reg_flag_trcsome。不管预定义设置或缺省设置如何,将它们都设置为“off”会强制不进行跟踪。