![[z/OS]](../images/ngzos.gif)
使用 Modify 命令来显示优化本地适配器状态
您可以从 MVS™ 控制台发出 modify 命令,以便动态地修改产品操作。本主题说明显示优化本地适配器状态时要与 modify 命令配合使用的语法和参数。本主题还提供了一个示例,以便说明如何使用 modify 命令。
- 活动的控制器
- 跟踪设置
- 服务方
- 会话
- Java™ 虚拟机 (JVM) 堆
- Java 跟踪
f <server>, parameters
server 是 modify 命令指向的服务器的短名称。此参数是必需的。
参数
ADAPTER 是 DISPLAY modify 命令上的参数。您可以在“Modify 命令”主题中查看 DISPLAY modify 命令参数的完整列表。下列参数用于通过 modify 命令来显示优化本地适配器的状态。如果您想阅读更多有关此命令的信息,请参阅“Modify 命令”主题。
- STATUS
显示优化本地适配器组件的状态。
- REGISTRATIONS
显示连接到此服务器的优化本地适配器客户机的列表。
- DAEMONRGES
显示连接到此守护程序组中任何服务器的优化本地适配器客户机的列表。
- SEARCHRGES
显示连接到此守护程序组中任何服务器并与搜索条件匹配的优化本地适配器客户机的列表。
- OTMANAMES
显示该 WebSphere® 守护程序组使用开放式事务管理器访问 (OTMA) 连接到的信息管理系统 (IMS™) 以及用于连接的客户机名称。
OLATRACE 是一个带有参数的关键字,该参数指定与优化本地适配器开发程序(具有要显示的跟踪记录)相关联的作业名。此作业名可以是特定作业,也可以是单个星号以抽取所有适配器跟踪记录。设置优化本地适配器跟踪记录的格式并显示给 WebSphere Application Server 系统输出(如果已启用跟踪)。要为特定注册或者广泛情况启用适配器跟踪,请参阅主题“使用优化本地适配器诊断信息”。
示例 1
- 显示作业 WOLAJOB1 的所有可用跟踪数据:
F BBOS001, DISPLAY, OLATRACE=WOLAJOB1
- 显示所有可用的优化本地适配器数据:
F BBOS001, DISPLAY, OLATRACE=*
******** OLATRACE modify command output start ****************************\n";
******** Trace records for jobname: <jjjjjjjjj>
< formatted trace records > ******** End of OLATRACE modify command output ***************************
要显示优化本地适配器的运行状态,请发出以下命令:f 服务器,display,adapter,status
BBOA0005I: STATUS: VER:1 MAX-CONN:100 DAEMON-GRP-NAME:SY1
VER:1 表示已安装版本为 1
的优化本地适配器。MAX-CONN:100 报告 WebSphere 变量 WAS_DAEMON_ONLY_adapter_max_conn
的设置值。DAEMON-GRP_NAME:SY1 表示此服务器所连接的守护程序组名为 SY1。要显示与此服务器相连接的优化本地适配器客户机,请发出以下命令:f 服务器,display,adapter,registrations
BBOA0006I: SHOWING REGISTRATIONS FOR SERVER:
BBOA0000I: TYPE: s JOBNAME: BBOS001 NAME: *WASCTL*
BBOA0001I: JOBNUM: 0 ACTIVE: true ACTIVE-CONNECTIONS: 0
BBOA0002I: MIN-CONN: 0 MAX-CONN: 0 STATE: 00 TRACELEVEL: 00
BBOA0023I: THIS REGISTRATION DOES NOT HAVE ANY CONNECTION HANDLES
BBOA0026I:
BBOA0003I: Name Jobname SWT TL Min Max Act State
BBOA0004I: USSREGISTER1 IBMUSER5 000 02 0001 0005 0001 00
- 消息 BBOA0000I 显示对其发出 Display 命令的服务器的作业名。
- 消息 BBOA0003I 标识消息 BBOA0004I 显示的列。
- 对于每个与此服务器相连接的优化本地适配器客户机,都将发出一次消息 BBOA0004I:
- Name 标识客户机的注册名称(通过 BBOA1REG 提供)。
- Jobname 表示客户机地址空间的作业名。
- SWT 表示一些标志,这些标志描述客户机的安全性和事务环境。
- 如果执行 BBOA1REG 调用时已通过设置 reg_flag_W2Cprop 启用了安全性,那么 S 将设置为 1。
- 如果执行 BBOA1REG 调用时已通过设置 reg_flag_trans 启用了事务支持,那么 T 将设置为 1。
- W 始终设置为 0。
- TL 表示此注册的跟踪级别。缺省值是 02。
- Min 表示执行 BBOA1REG 调用时指定的最小连接数。
- Max 表示执行 BBOA1REG 调用时指定的最大连接数。
- Act 表示此注册的连接池中的当前连接数。
- State 供 IBM® 支持人员使用。
要显示与此守护程序组中的另一服务器相连接的优化本地适配器客户机,请发出以下命令:f 服务器,display,adapter,registrations,servername
要显示与此守护程序组中的任何服务器相连接的优化本地适配器客户机,请发出以下命令:f 服务器,display,adapter,daemongres
- NAME=注册名
显示注册名称与“注册名”匹配的注册
- JOBNUM=作业号
显示 MVS 作业号与“作业号”匹配的注册
- JOBNAME=作业名
显示 MVS 作业名与“作业名”匹配的注册
- SERVER=值
如果值为 1 或 TRUE,那么显示类型为“server”的注册;或者,如果值为 0 或 FALSE,那么显示类型不是“server”的注册。类型为“server”的注册表示与守护程序组相连接的 WebSphere Application Server for z/OS® 实例。
- EXTADDR=值
如果值为 1 或 TRUE,那么显示类型为“external address space”的注册;或者,如果值为 0 或 FALSE,那么显示类型不是“external address space”的注册。外部地址空间是已通过 BBOA1REG 调用向优化本地适配器注册的地址空间。
- SEC=值
如果值为 1 或 TRUE,那么显示已在执行 BBOA1REG 调用时通过设置 reg_flag_W2Cprop 启用了安全性的注册;或者,如果值为 0 或 FALSE,那么显示未启用安全性的注册。
- TRANS=值
如果值为 1 或 TRUE,那么显示已在执行 BBOA1REG 调用时通过设置 reg_flag_trans 启用了事务的注册;或者,如果值为 0 或 FALSE,那么显示未启用事务的注册。
- MINCONN=值
显示最小连接数为 值 的注册,其中 值 是大于或等于 0 的整数。
- MAXCONN=值
显示最大连接数为 值 的注册,其中 值 是大于或等于 0 的整数。
- ACTCONN=值
显示最大连接数为 值 的注册,其中 值 是大于或等于 0 的整数。
- VERSION=值
显示优化本地适配器版本级别为 值 的注册。
例如,要显示所有已禁用安全性和事务并且作业名为 BBOCLIEN 的客户机注册,请发出以下命令:f 服务器,display,adapter,searchrges,sec=0,trans=0,extaddr=1,jobname=bboclien
对于任何 display registrations、daemonrges 或 searchrges 命令,可以追加自变量详细信息以获取详细输出。例如,要获取与此服务器相连接的注册的详细列表,请发出以下命令:f 服务器,display,adapter,registrations,details
BBOA0006I: SHOWING REGISTRATIONS FOR SERVER:
BBOA0000I: TYPE: s JOBNAME: BBOS001 NAME: *WASCTL*
BBOA0001I: JOBNUM: 0 ACTIVE: true ACTIVE-CONNECTIONS: 0
BBOA0002I: MIN-CONN: 0 MAX-CONN: 0 STATE: 00 TRACELEVEL: 00
BBOA0023I: THIS REGISTRATION DOES NOT HAVE ANY CONNECTION HANDLES
BBOA0026I:
BBOA0000I: TYPE: e JOBNAME: IBMUSER5 NAME: BBOAUSSREGISTER1
BBOA0001I: JOBNUM: 0 ACTIVE: true ACTIVE-CONNECTIONS: 1
BBOA0002I: MIN-CONN: 1 MAX-CONN: 5 STATE: 00 TRACELEVEL: 02
BBOA0024I: ID LSCB State
BBOA0025I: 0x00000200065048e0 0x7f6ba0c8 Pooled
消息 BBOA0000I 列示类型为“e”(表示外部地址空间,即优化本地适配器客户机)的地址空间以及它们的 MVS 作业名和优化本地适配器注册名称。消息 BBOA0001I 显示此注册的活动连接数。
消息 BBOA0002I 显示此注册的最小连接数和最大连接数。
消息 BBOA0024I 是随后的连接列表的头。
对于此注册中的每个连接,都将发出一次消息 BBOA0025I。对于消息 BBOA0001I 中报告的每个活动连接,都应该有一条 BBOA0025I 消息。ID 和 LSCB 是此连接的唯一标识。State 表示连接的状态。Pooled 表示此连接当前未被任何应用程序线程使用,但可供请求使用。Err 表示此连接正在处理错误情况。状态 Ready、RegSent、RspRcvd、RegRcvd 和 DataRcvd 全都描述优化本地适配器客户机与 WebSphere Application Server for z/OS 服务器实例之间的交互的各种状态。