Modify 命令

您可以从 MVS™ 控制台发出 modify 命令,以便动态地修改产品操作。

可使用 modify 命令来显示各种服务器组件和活动的状态,其中包括下列组件:
  • 活动的控制器
  • 跟踪设置
  • 服务方
  • 会话
  • Java™ 虚拟机 (JVM) 堆
  • Java 跟踪

输入 modify 命令时,请使用以下格式。

f <server>, parameters

servermodify 命令指向的服务器的短名称。此参数是必需的。

参数

modify 命令的有效参数如下所示:

DISABLEFAILOVER,'<JNDI Name>'
用于手动对提供的 JNDI 名称所标识的资源禁用资源故障转移支持。提供的 JNDI 名称用于标识主资源,并且必须将该名称用单引号引起来以保持其大小写。
ENABLEFAILOVER,'<JNDI Name>'
用于手动对提供的 JNDI 名称所标识的资源启用资源故障转移支持。提供的 JNDI 名称用于标识主资源,并且必须将该名称用单引号引起来以保持其大小写。
FAILOVER,'<JNDI Name>'
用于手动将对主资源指定的请求路由至主资源的已配置备用资源。提供的 JNDI 名称用于标识主资源,并且必须将该名称用单引号引起来以保持其大小写。要将请求故障回退到主资源,请发出带有参数 FAILBACK,'<JNDI name>'modify 命令。
FAILBACK,'<JNDI Name>'
用于手动将请求路由至提供的 JNDI 名称所标识的已配置主资源。提供的 JNDI 名称用于标识主资源,并且必须将该名称用单引号引起来以保持其大小写。此命令自动启用自动故障转移。如果不希望在故障回退后启用自动故障转移,请发出带有参数 DISABLEFAILOVER,'<JNDI Name>'modify 命令。
注意: 输入的 JNDI 名称区分大小写。
CANCEL
用于取消指定的服务器。

可以对 CANCEL 参数指定下列选项:

ARMRESTART
指定您是否正在使用应用程序响应管理 (ARM) 代理程序并要让 ARM 在服务器终止时将其重新启动。如果未对 CANCEL 参数指定 ARMRESTART 选项,那么 ARM 不会重新启动服务器。
HELP
指定您想要查看帮助信息,该信息将描述 CANCEL 语法。
避免故障 避免故障: 不能使用 CANCEL 参数从 MVS 控制台取消集群。您必须逐个地取消每一个组成集群的服务器。gotcha
DPM,[IIOP=nnn | HTTP=nnn | HTTPS=nnn | MDB=nnn | SIP=nnn | CRA=nnn | SIPS=nnn | OLA=nnn | INTERVAL=nnn | dump_action={SVCDUMP|JAVACORE|HEAPDUMP|TRACEBACK|JAVATDUMP|NONE|RESET} | clear_all | reset_all]

nnn 占位符指定特定协议类型的时间间隔长度(以秒计)。nnn 占位符的值必须是 0255 之间的整数或 reset。值 0 表示协议没有时间间隔并且将对使用该协议的请求禁用 DPM。值 reset 表示对 DPM 时间间隔的控制权将返回给工作负载分类文件中的 dpm_interval 分类属性。

DPM INTERVAL modify 命令将覆盖 dpm_interval 分类属性。DPM dump_action modify 命令将覆盖 dpm_dump_action 分类属性和服务器范围的 server_region_dpm_dump_action 属性。

对转储操作指定 RESET 会取消激活 modify 命令的转储操作。dpm_dump_action 分类属性和服务器范围的 server_region_dpm_dump_action 属性的设置将再次生效。

INTERVAL 参数上指定的值将所有六个协议的 DPM 时间间隔设置为相同值。

clear_all 值会将所有相关请求协议的时间间隔设置为 0 并将转储操作设为 None

reset_all 值会复位所有 DPM 时间间隔和 dump_action 参数。对 DPM 时间间隔和转储操作的控制权将返回给 WLM 分类文件。

HEAPDUMP
用于为控制器以及所有与该控制器相关联的服务方生成 JVM 堆转储。
JAVACORE
用于为控制器以及所有与该控制器相关联的服务方生成 JVM 核心转储。
JAVATDUMP
用于为所有服务方地址空间生成由 JVM 启动的 TDUMP。还可以使用 JAVA_DUMP_TDUMP_PATTERN 本机环境变量来指定 TDUMP 数据集名称。
JAVAOOM,[INTERVAL=nnn | ACTION=xxx | RESET]
用于对此服务器中发生 Java 虚拟机 (JVM) 内存不足情况时将执行的诊断操作进行动态修改。它还用于对重复该诊断操作的时间间隔进行动态修改。

指定 INTERVAL 可设置不重复诊断操作的时间段(以秒计)。此属性将覆盖为 ras_java_oom_interval 环境变量指定的值。

指定 ACTION 可设置此服务器中发生 JVM 内存不足情况时将执行的诊断操作。此属性将覆盖为 ras_java_oom_action 环境变量指定的值。可以将以下某个值指定为 xxx 的值:

NONE
不执行任何诊断操作。
WTO
向硬拷贝中写入 BBOO0404E 错误消息。
SVCDUMP
对受影响的地址空间执行 SVCDUMP,并且次代码为 C9C2704B。

指定 RESET 可将诊断操作和时间间隔重置为对 ras_java_oom_action 和 ras_java_oom_interval 环境变量指定的值。

MSGROUTE,{ERRORLOG|HARDCOPY|CONSOLE|COPYERRORLOG|COPYHARDCOPY|COPYCONSOLE|NONE}{[=xxx][,RESET][,CLEAR]}
用于动态地改变消息标识的输出位置。

xxx 占位符是应用程序服务器要路由的产品消息标识的逗号定界列表。可以将消息路由至多个位置。

首次对一个位置和一组消息发出该命令时,该位置的消息列表是第一个命令的消息列表。如果该位置的环境变量已定义了消息,那么那些消息将追加到该位置的消息列表。以后对同一位置和另一组消息发出该命令时,应用程序服务器会将后续命令的消息追加到现有的消息列表。

指定 ERRORLOG 会将消息路由至错误日志而不是缺省位置。

指定 HARDCOPY 会将消息路由至 SYSLOG 系统日志(也称为硬拷贝)而不是缺省位置。

指定 CONSOLE 会将消息路由至 MVS 操作员控制台而不是缺省位置。

指定 COPYERRORLOG 会将消息复制到错误日志以及缺省位置。

指定 COPYHARDCOPY 会将消息复制到 SYSLOG 系统日志(又称为硬拷贝)以及缺省位置。

指定 COPYCONSOLE 会将消息复制到 MVS 操作员控制台以及缺省位置。

指定 NONE 会阻止路由这些消息。值 NONE 优先于将消息路由至错误日志、系统日志或 MVS 操作员控制台。

RESETERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLENONE 一起指定表示路由或阻止的消息来自 was.env 文件而不是 MSGROUTE modify 命令。
  • RESETERRORLOG 一起指定会将 ras_message_routing_errorlog 环境变量中指定的消息路由至错误日志而不是缺省位置。
  • RESETHARDCOPY 一起指定会将 ras_message_routing_hardcopy 环境变量中指定的消息路由至 SYSLOG 系统日志而不是缺省位置。
  • RESETCONSOLE 一起指定会将 ras_message_routing_console 环境变量中指定的消息路由至 MVS 操作员控制台而不是缺省位置。
  • RESETCOPYERRORLOG 一起指定会将 ras_message_routing_copy_errorlog 环境变量中指定的消息复制到错误日志以及缺省位置。
  • RESETCOPYHARDCOPY 一起指定会将 ras_message_routing_copy_hardcopy 环境变量中指定的消息复制到 SYSLOG 系统日志以及缺省位置。
  • RESETCOPYCONSOLE 一起指定会将 ras_message_routing_copy_console 环境变量中指定的消息复制到 MVS 操作员控制台以及缺省位置。
  • RESETNONE 一起指定会阻止路由 ras_message_routing_hardcopy 环境变量中指定的消息。
CLEARERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE 或者 NONE 一起指定表示消息将路由至缺省位置或者不再阻止路由这些消息。
  • CLEARERRORLOGHARDCOPYCONSOLECOPYERRORLOGCOPYHARDCOPYCOPYCONSOLE 或者 NONE 一起指定表示消息将路由至缺省位置或者不再阻止路由这些消息。
  • CLEARERRORLOGCOPYERRORLOG 一起指定会将消息路由至缺省位置而不是错误日志。
  • CLEARHARDCOPYCOPYERRORLOG 一起指定会将消息路由至缺省位置而不是 SYSLOG 系统日志。
  • CLEAR 与 CONSOLE 或 COPYCONSOLE 一起指定会将消息路由至缺省位置而不是 MVS 操作员控制台。
  • CLEARNONE 一起指定会取消阻止消息。
RECLASSIFY[,FILE=['/path/to/file.xml']]
用于动态地重新装入工作负载分类文档而不必重新启动服务器。重新装入的工作负载分类设置将立即生效。

指定 RECLASSIFY 会使用 wlm_classification_file 变量中指定的工作负载分类文件执行重新分类。

将文件名与 reclassify 参数一起指定(例如 RECLASSIFY,FILE='/path/to/newfile.xml')会使用指定的分类文件执行重新分类。wlm_classification_file 变量的值更改为 FILE 选项中指定的文件。使用 wlm_classification_file 变量的任何后续 reclassify modify 命令将重新装入该变量中指定的新文件而不是重新装入原始文件。

指定 RECLASSIFY,FILE= 将禁用分类。wlm_classification_file 变量将设置为 null。因为 wlm_classification_file 变量没有值,所以使用该变量的任何后续 reclassify modify 命令都不会影响服务器。

注意: 如果无法装入新的工作负载分类文件,那么应用程序服务器将废弃重新装入的分类设置。在发出 reclassify modify 命令之前,应用程序服务器继续使用生效的分类设置运行。
提示: 无论何时成功装入工作负载分类文件,应用程序服务器都会对系统日志 SYSLOG 发出一条类似于以下消息的消息。该消息还会显示在操作员控制台上以响应 DISPLAY,WORK,CLINFO display 命令。
BBOJ0129I: The /tmp/wlm4.class.xml workload classification file 
was loaded at 2009/07/14 19:33:35.297 (GMT)
ROLL_LOGS
用于将服务方输出日志的重定向重新发出到 USS 文件系统。将在相同输出目录下创建一组新的输出日志文件,且会保留较旧的日志文件。消息将写入先前日志的结尾以及新日志的开头,因此,这会在文件之间创建逻辑链路。
STACKTRACE
用于将服务器中所有 Java 线程的 Java 堆栈跟踪记录到错误日志。
SMF,REQUEST,{ON|OFF|RESET}
用于控制是否创建 SMF 120-9 记录。

SMF,REQUEST modify 命令将覆盖 SMF_request_activity_enabled 分类属性和服务器范围的 server_SMF_request_activity_enabled 属性。

指定 ON 将打开 SMF 120-9 记录创建功能。

指定 OFF 将关闭 SMF 120-9 记录创建功能。

指定 RESET 将取消激活 modify 命令中关于是否创建 SMF 120-9 记录的设置。SMF_request_activity_enabled 分类属性和服务器范围的 server_SMF_request_activity_enabled 属性在复位时的设置将生效。

SMF,REQUEST,ASYNC,{ON|OFF|RESET}
用于在创建了 SMF 120-9 记录时收集该记录的“格式化异步部分”数据。

SMF,REQUEST,ASYNC modify 命令将覆盖服务器范围的 server_SMF_request_activity_async 属性。

指定 ON 将打开该数据的收集功能。

指定 OFF 将关闭该数据的收集功能。如果指定了此值,那么在创建的记录中,记录顶部的位置三元组中的此部分将包含零。

指定 RESET 将取消激活 modify 命令中关于是否收集该数据的设置。服务器范围的 server_SMF_request_activity_async 属性在复位时的设置将生效。

SMF,REQUEST,CPU,{ON|OFF|RESET}
用于在创建了 SMF 120-9 记录时收集该记录的“CPU 使用情况细目部分”数据。

SMF,REQUEST,CPU modify 命令将覆盖 SMF_request_activity_CPU_detail 分类属性和服务器范围的 server_SMF_request_activity_CPU_detail 属性。

指定 ON 将打开该数据的收集功能。

指定 OFF 将关闭该数据的收集功能。如果指定了此值,那么在创建的记录中,记录顶部的位置三元组中的此部分将包含零。

指定 RESET 将取消激活 modify 命令中关于是否收集该数据的设置。SMF_request_activity_CPU_detail 分类属性和服务器范围的 server_SMF_request_activityCPU_detail 属性在复位时的设置将生效。

SMF,REQUEST,SECURITY,{ON|OFF|RESET}
用于在创建了 SMF 120-9 记录时收集该记录的“安全性数据部分”数据。

SMF,REQUESTSECURITY modify 命令将覆盖 SMF_request_activity_security 分类属性和服务器范围的 server_SMF_request_activity_security 属性。

指定 ON 将打开该数据的收集功能。

指定 OFF 将关闭该数据的收集功能。如果指定了此值,那么在创建的记录中,记录顶部的位置三元组中的此部分将包含零。

指定 RESET 将取消激活 modify 命令中关于是否收集该数据的设置。SMF_request_activity_security 分类属性和服务器范围的 server_SMF_request_activity_security 属性在复位时的设置将生效。

SMF,REQUEST,TIMESTAMPS,{ON|OFF|RESET}
用于在创建了 SMF 120-9 记录时收集该记录的“格式化时间戳记部分”数据。

SMF,REQUEST,TIMESTAMPS modify 命令将覆盖 SMF_request_activity_timestamps 分类属性和服务器范围的 server_SMF_request_activity_timestamps 属性。

指定 ON 将打开该数据的收集功能。

指定 OFF 将关闭该数据的收集功能。如果指定了此值,那么在创建的记录中,记录顶部的位置三元组中的此部分将包含零。

指定 RESET 将取消激活 modify 命令中关于是否收集该数据的设置。SMF_request_activity_timestamps 分类属性和服务器范围的 server_SMF_request_activity_timestamps 属性在复位时的设置将生效。

SMF,OUTBOUND,ON
用于打开 SMF 120-10 记录创建功能。
SMF,OUTBOUND,OFF
用于关闭 SMF 120-10 记录创建功能。
SMF,OUTBOUND,RESET
用于使 SMF 120-10 记录创建功能受为 server_SMF_outbound_enabled 环境变量指定的值控制。
TIMEOUT_DELAY=n
用于动态地将超时延迟选项变量 control_region_timeout_delay 更改为 n 秒。通过将此 modify 命令与 TIMEOUTDUMPACTION modify 命令配合使用,可以设置超时延迟,以允许发生超时的时候完成所指定的转储操作(例如 JAVACORE)。TIMEOUTDUMPACTION modify 命令中指定的转储操作需要一个超时延迟,以便服务方能够在终止前完成转储操作。

在处理指定的转储之后,您可以重新发出此命令以便将 control_region_timeout_delay 变量重新更改为先前设置,而不必重新启动服务器。

TIMEOUTDUMPACTION=n
用于指示如果 control_region_timeout_delay 属性设置为非零值,那么对于分派给服务方的工作,在超时发生时应该执行下列哪一项操作:
  • 如果指定了 NONEnone,那么不执行任何转储。
  • 如果指定了 JAVACOREjavacore,那么执行 Java 核心转储。
  • 如果指定了 SVCDUMPsvcdump,那么执行 SVC 转储。
  • 如果指定了 JAVATDUMPjavatdump,那么执行 JVM 启动的 TDUMP。
    注: 必须将 control_region_timeout_delay 属性配置为足够长的时间长度,以使服务方能够在被控制器终止前收集 JAVATDUMP。TIMEOUT_DELAY modify 命令可用于动态地更改 control_region_timeout_delay 属性的值。
TIMEOUTDUMPACTIONSESSION=n
用于指示如果相应恢复属性设置为 SESSION,那么对于分派给服务方的 HTTP、HTTPS、SIP 或 SIPS,要在超时发生时执行下列哪一项操作:
  • 如果指定了 NONEnone,那么不执行任何转储。
  • 如果指定了 JAVACOREjavacore,那么执行 Java 核心转储。
  • 如果指定了 SVCDUMPsvcdump,那么执行 SVC 转储。
  • 如果指定了 JAVATDUMPjavatdump,那么执行 JVM 启动的 TDUMP。
以下是相应恢复属性的列表:
  • protocol_http_timeout_output_recovery
  • protocol_https_timeout_output_recovery
  • protocol_sip_timeout_output_recovery
  • protocol_sips_timeout_output_recovery
TRACEALL=n
用于确定服务器的常规跟踪级别。
下列值是有效的跟踪级别。通常应该指定值 1
  • 0:不执行任何跟踪
  • 1:发生异常时执行跟踪
  • 2:执行基本跟踪
  • 3:对所有组件执行详细跟踪
避免故障 避免故障: 使用级别 3 时应格外小心,这是因为,此跟踪级别可能会生成过多的数据,导致您查看这些数据并不可行。gotcha
TRACEBASIC=n
用于指定要对其打开基本跟踪级别的产品组件。
此命令可以覆盖 TRACEALL 为那些组件确定的其他跟踪级别。
避免故障 避免故障: 除非得到 IBM® 技术支持的指示,否则不要更改此变量。gotcha

下表包含了可以对此参数指定的值。您可以对 TRACEBASIC 或 TRACEDETAIL 指定下列一个或多个值:

产品组件
0 RAS
1 公共实用程序
3 COMM
4 ORB
6 OTS
7 Shasta
9 z/OS® 包装器
A 守护程序
E 安全性
F 外部化
J(只应该在 IBM 技术支持的指导下使用) JRas
L Java EE
TRACEDETAIL=n
用于指定要对其打开详细跟踪级别的产品组件。
此命令将对指定的产品组件激活最详细的跟踪并覆盖 TRACEALL 中的不同设置。所选组件由其组件标识所标识,这些标识就是 TRACEBASIC 参数所列示的标识。按编号指定的子组件将受到详细跟踪。产品的其他部件将受到 TRACEALL 参数所指定的跟踪。
避免故障 避免故障: 除非得到 IBM 技术支持的指示,否则不要更改此变量。gotcha
TRACESPECIFIC=xxyyyzzz
用于指定特定产品跟踪点的跟踪覆盖。
跟踪点由 8 位的十六进制数字指定。要指定多个跟踪点,请使用括号并用逗号分隔各个数字。另外,还可以通过用单引号括起名称来指定环境变量名称。将对该环境变量的值进行处理,就像在 TRACESPECIFIC 参数中指定了该值一样。
避免故障 避免故障: 除非得到 IBM 技术支持的指示,否则不要使用 TRACESPECIFICgotcha
TRACE_EXCLUDE_SPECIFIC=xxyyyzzz
用于指定要排除的产品跟踪点。
要排除的跟踪点由 8 位的十六进制数字指定。要指定多个跟踪点,请使用括号并用逗号分隔各个数字。另外,还可以通过用单引号括起名称来指定环境变量名称。将对该环境变量的值进行处理,就像在 TRACE_EXCLUDE_SPECIFIC 参数中指定了该值一样。您可以使用 TRACE_EXCLUDE_SPECIFIC 参数作为掩码来关闭当前打开的跟踪。例如,使用 TRACESPECIFIC 参数对整个产品的打开跟踪,然后使用 TRACE_EXCLUDE_SPECIFIC 参数在该部分的产品中关闭一个跟踪。
避免故障 避免故障: 除非得到 IBM 技术支持的指示,否则不要使用 TRACE_EXCLUDE_SPECIFIC 参数。gotcha
TRACEINIT
用于复位为初始跟踪设置。
TRACENONE
用于关闭所有跟踪设置。
TRACETOSYSPRINT={YES|NO}
用于选择是否将跟踪发送到 SYSPRINT。

指定 YES 会将跟踪发送到 SYSPRINT,而指定 NO 会停止将跟踪发送到 SYSPRINT。

TRACETOTRCFILE={YES|NO}
用于指定是否要将跟踪定向至 TRCFILE DD 卡。

指定 YES 会将跟踪发送到 TRCFILE DD 卡,而指定 NO 会停止将跟踪发送到 TRCFILE DD 卡。

TRACEJAVA
修改 Java 跟踪字符串。

Java 跟踪规范用于控制 Java 跟踪,并且符合 Java 跟踪规范规则。*=all=enabled 表示对所有已注册的跟踪组件启用所有类型的跟踪。

TRACERECORD,{ON|OFF|RESET}
用于控制是否写入跟踪记录。该参数将与工作负载分类文件中定义的 classification_only_trace 属性配合使用。

指定 ON 将导致根据当前跟踪规范来写入跟踪记录。将忽略任何 classification_only_trace 属性。

指定 OFF 将阻止写入跟踪记录。
警告:
将不写入基于当前跟踪规范的跟踪记录或作为常规运行时处理的一部分而生成的跟踪记录。
指定 RESET 将导致按如下方式针对当前跟踪规范来写入跟踪记录:
  • 如果未定义 classification_only_trace 属性,那么将写入所有处理线程的跟踪记录。此情形在功能上等同于将 TRACERECORD 设置为 ON
  • 如果定义了一个或多个 classification_only_trace 属性,那么将仅写入其分类包含 classification_only_trace 属性 1 的处理线程的跟踪记录。

缺省值为 RESET

HELP
用于显示所有可以与 modify 命令配合使用的关键字的列表。

您也可以在 CANCEL 后面使用 HELP 参数以及使用 DISPLAY 参数来显示所有可以与这些参数中的任何一个配合使用的关键字的列表。

PAUSELISTENERS
用于防止工作被接受到服务器中。使用此参数来关闭通信侦听器并清除工作注册表中的任何暂挂工作。
避免故障 避免故障: MODIFY server,PAUSELISTENERS 命令可停止控制器侦听所有端口,但 IIOP(ORB_TCP_SECURE 和 ORB_TCP_LISTENER)除外。对于 IIOP,当发出此 modify 命令时,守护程序会停止向 IIOP 传输渠道发送请求。但是,如果正在运行执行高速缓存(例如,Bean 高速缓存)的客户机应用程序,那么可能会将来自这些应用程序的请求直接发送到打开的 IIOP 端口。会发生此情形的原因是,IIOP 侦听器的启动时间较早,是在服务器启动进程中启动的,因此可能在发出此 modify 命令之前打开了 IIOP 端口。gotcha
WLM_MIN_MAX=min,max
用于动态地修改最小服务方数和最大服务方数设置(wlm_minimumSRCount 和 wlm_maximumSRCount)。WLM 将动态地调整当前的活动服务方数,以使其与新约束相符。新设置不一定立即生效;WLM 将在考虑诸如资源可用性和工作负载之类的因素的情况下尽快实现新的最小目标数和最大目标数。
避免故障 避免故障: 对于已配置单一服务器动态应用程序环境(即,wlm_dynapplenv_single_server 属性设置为 1)的服务器而言,将忽略 WLM_MIN_MAX 命令。gotcha
WORKERTHREADMAX=n
用于提高控制器区域工作程序线程池最大值。修改命令上指定的值将覆盖针对 control_region_thread_pool_maximum_size 环境变量指定的值。最大值只能提高。降低最大值的请求将被拒绝。指定最大值时,应确保有足够资源可用于支持指定最大值。例如,JVM 堆大小是要一个考虑的资源。
RESUMELISTENERS
用于在发出包含 PAUSELISTENERS 参数的 modify 命令之后重新启动通信侦听器。此参数允许将新工作接受到服务器中。
DISPLAY
用于显示服务器的名称、运行服务器的系统的名称以及当前代码级别。

可以对此参数指定下列选项:

  • SERVERS 显示此命令所定向到的服务器的名称、系统名称以及同一单元中综合系统中的每个活动服务器的代码级别。
  • SERVANTS 显示服务方的地址空间标识 (ASID) 列表,这些服务方已连接到您对其发出 display 命令的服务器。
  • TRACE 显示服务器控制器的跟踪信息。您可以通过下列其中一个选项进一步修改此命令:
    • SRS 显示所有服务方的跟踪信息(每次一个服务方)。
    • ALL 显示控制器和所有服务方的跟踪信息(每次一个服务方)。
    • JAVA 显示服务器控制器的 Java 跟踪字符串设置。您可以通过下列其中一个选项进一步修改此命令:
      • SRS 显示所有服务方的 Java 跟踪信息(每次一个服务方)。
      • ALL 显示控制器和所有服务方的 Java 跟踪信息(每次一个服务方)。
      • HELP 显示所有可以与 modify display trace Java 命令配合使用的关键字的列表。
    • HELP 显示所有可以与 modify display trace 命令配合使用的关键字的列表。
  • JVMHEAP 显示服务器控制器的 JVM 堆信息。您可以通过下列其中一个选项进一步修改此命令:
    • SRS 显示所有服务方的 JVM 堆信息(每次一个服务方)。
    • ALL 显示控制器和所有服务方的 JVM 堆信息(每次一个服务方)。
    • HELP 显示所有可以与 modify display Javaheap 命令配合使用的关键字的列表。
  • LISTENERS 显示连接实例名称、相关联的 IP 地址和侦听端口号。相关联的 IP 地址可以显示一个星号 (*) 来作为通配符。
  • CONNECTIONS 显示每个连接实例名称以及连接数。每个连接实例都将占用单独的一行。您可以通过下列其中一个选项进一步修改此命令:
    • NAME='name' 显示与所指定的连接实例 'name' 关联的连接数。如果找到了连接名称,但是没有任何连接,那么此命令返回的计数为 0。如果未找到连接名称,那么此命令将返回错误消息。
    • LIST 显示每个连接实例的所有连接的远程主机信息。如果某个连接实例名称没有任何连接,那么此命令将只返回连接实例名称。
    • LIST, NAME='name' 显示所指定连接实例 'name' 的所有连接的远程主机信息。
  • HELP 显示所有可以与 modify 命令配合使用的关键字的列表。
  • ERRLOG 显示错误日志中的最近 10 个条目。您可以通过下列其中一个选项进一步修改此选项:
    • SRS 显示错误日志中所有服务方的最近 10 个条目(每次一个服务方)。
    • HELP 显示所有可以与 modify display error log 命令配合使用的关键字的列表。
  • MODE 显示运行位方式。
  • MSGROUTE 显示所有路由位置的消息以及要阻止的消息的列表。路由位置可以是错误日志、系统日志或 MVS 操作员控制台。
    • ERRORLOG 显示要路由至错误日志的消息的列表。
    • HARDCOPY 显示要路由至 SYSLOG 系统日志(也称为硬拷贝)的消息的列表。
    • CONSOLE 显示要路由至 MVS 操作员控制台的消息的列表。
    • NONE 显示要阻止的消息的列表。
  • SMF 显示服务器的 SMF 120-9 记录的创建状态。
    • ASYNC 显示所有服务方上异步工作的 SMF 120-9 记录的创建状态,每次一个服务方。
    • HELP 显示所有可以与 modify display SMF 命令配合使用的关键字的列表。
  • WORK 显示服务器的工作元素计数。您可以通过下列其中一个选项进一步修改此选项:
    • CRA 显示 CRA 消息驱动的 Bean (MDB) 请求计数信息。您可以通过下列其中一个选项进一步修改此命令:
      • SRS 显示所有服务方的 CRA 请求计数信息(一次显示一个服务方)。
      • HELP 显示所有可与 modify display work CRA 命令配合使用的关键字的列表。
    • ASYNCSERVLET 显示异步 servlet 请求总数和当前已处理的异步 servlet 请求数。异步 servlet 请求总数仅包括从上次启动或重新启动整个服务器以来发出的请求。但是,如果一个或多个服务方已停止或重新启动,那么该总数可能减少。
      • SRS 显示每个服务方的异步 servlet 请求总数和当前已处理的异步 servlet 请求数。该总数是从上次启动或重新启动该服务方以来的异步 servlet 请求数。
      • HELP 显示所有可以与 modify display work asyncservlets 命令配合使用的关键字的列表。
    • EJB 显示 Enterprise JavaBeans (EJB) 请求计数信息。您可以通过下列其中一个选项来修改此选项:
      • SRS 显示所有服务方的 EJB 请求计数信息(每次一个服务方)。
      • HELP 显示所有可以与 modify display work EJB 命令配合使用的关键字的列表。
    • SERVLET 显示 Servlet 请求计数信息。您可以通过下列其中一个选项来修改此选项:
      • SRS 显示所有服务方的 Servlet 请求计数信息(每次一个服务方)。
      • HELP 显示所有可以与 modify display work servlet 命令配合使用的关键字的列表。
    • MDB 显示消息驱动的 Bean (MDB) 请求计数信息。您可以通过下列其中一个选项进一步修改此命令:
      • SRS 显示所有服务方的 MDB 请求计数信息(每次一个服务方)。
      • HELP 显示所有可以与 modify display work MDB 命令配合使用的关键字的列表。
    • SIP 显示会话启动协议 (SIP) 请求计数信息。您可以通过下列其中一个选项来修改此选项:
      • SRS 显示所有服务方的 SIP 请求计数信息(每次一个服务方)。
      • HELP 显示所有可以与 modify display work SIP 命令配合使用的关键字的列表。
    • SUMMARY 显示摘要请求计数信息。
      • SRS 显示所有服务方的摘要请求计数信息(每次一个服务方)。
      • HELP 显示所有可以与 modify display work summary 命令配合使用的关键字的列表。
    • ALL 显示所有请求计数信息。
      • SRS 显示所有服务方的所有请求计数信息(每次一个服务方)。
      • STATS 显示所有详细统计信息。
      • HELP 显示所有可以与 modify display work all 命令配合使用的关键字的列表。
    • CLINFO 显示工作分类信息。
    • HELP 显示所有可以与 modify display work 命令配合使用的关键字的列表。
    • OLA 显示由服务 BBOA1INV 和 BBOA1SRQ 驱动的入站优化本地适配器 (OLA) 请求。您可以通过下列其中一个选项进一步修改此命令:
      • SRS 显示所有服务方的 OLA 请求计数信息(每次一个服务方)。
      • HELP 显示所有可以与 modify display work all 命令配合使用的关键字的列表。
  • 快速响应高速缓存加速器 (FRCA)。显示 FRCA 高速缓存统计信息,如下所示:
    • f <servername>,display,frca
    • f <servername>,display,frca,content
    • f <servername>,display,frca,stats
  • ADAPTER
    • STATUS 将显示已优化的本地适配器组件的状态。
    • REGISTRATIONS 将显示连接到此服务器的已优化的本地适配器客户机的列表。
    • DAEMONRGES 将显示连接到此守护程序组中任何服务器的已优化的本地适配器客户机的列表。
    • SEARCHRGES 将显示连接到此守护程序组中任何服务器并与搜索条件匹配的已优化的本地适配器客户机的列表。
ASIDX=
在 modify 命令后面添加 ASIDX= 以及您要转储的服务方区域的相应 ASID(采用十六进制)。
例如:
MODIFY server,JAVACORE,ASIDX=F4
在此示例中,该命令采用服务方区域的 JAVACORE,该服务方区域的 ASID (十六进制) 为“F4”。

示例:禁用故障转移

示例 1:以下命令将对服务器 bbos001 上由 jdbc/MySampleDataSource 标识的主资源禁用故障转移:
f bbos001,DISABLEFAILOVER,'jdbc/MySampleDataSource'

示例:使用 modify 命令来取消应用程序集群和服务器

不能从 MVS 控制台取消集群。而是,必须取消组成集群的每个服务器。

示例 1:以下命令取消 bbo6acr 服务器:
f bbo6acr,cancel
示例 2:以下命令取消 bbo6acr 服务器并指示 ARM 在终止过程完成后重新启动 bbo6acr 服务器:
f bbo6acr,cancel,armrestart

示例:使用脚本编制建立一般跟踪级别

要为服务器建立一般跟踪级别,请使用以下命令:
f server,traceall=n

有效跟踪级别是 0(无)、1(异常)、2(基本)和 3(详细跟踪)。 在正常情况下以及在生产中,使用 1(异常)。

示例:以下命令打开对 bbo6acr 服务器的异常级别跟踪:
f bbo6acr,traceall=1
这里显示了一个样本:
f bbo6acr,traceall=1
BBOO0211I MODIFY COMMAND TRACEALL=1 COMPLETED SUCCESSFULLY

示例:为 WebSphere z/OS 组件设置基本和详细跟踪级别

使用以下命令:
f server,tracebasic=(n,...)
示例 1:以下命令打开对服务器 bbo6acr 上的守护程序组件的基本级别跟踪:
f bbo6acr,tracebasic=a
这里显示了一个样本:
f bbo6acr,TRACEBASIC=A
BBOO0211I MODIFY COMMAND TRACEBASIC=A COMPLETED SUCCESSFULLY
要指定您要打开详细跟踪级别的 WebSphere® for z/OS 组件,请使用以下命令:
f server,tracedetail=(n,...)
示例 2:以下命令打开对服务器 bbo6acr 上的安全性的详细级别跟踪:
f bbo6acr,tracedetail=e
这里显示了一个样本:
f bbo6acr,TRACEDETAIL=E
BBOO0211I MODIFY COMMAND TRACEDETAIL=E COMPLETED SUCCESSFULLY

示例:使用脚本编制设置特定跟踪点

要设置特定跟踪点,请使用以下命令:
f server,tracespecific=n | (n,...)
示例 1:以下命令打开特定跟踪点 04006001:
f bbo6acr,tracespecific=04006001
示例 2:下列命令打开特定跟踪点 04006001 和 04006027:
f bbo6acr,tracespecific=(04006001,04006027)
示例 3:下列命令打开环境变量 tracepoints 中设置的特定跟踪点:
f bbo6acr,tracespecific='tracepoints'

示例:使用脚本编制排除特定跟踪点

要排除特定跟踪点,请使用以下命令:
f server,trace_exclude_specific=n | (n,...)
示例:tracespecific 命令打开对整个部件的跟踪,然后 trace_exclude_specific 关闭该部件中的跟踪点 04006031:
f bbo6acr,tracespecific=04006000

f bbo6acr,trace_exclude_specific=04006031

示例:使用脚本编制复位到初始跟踪设置

要复位到初始跟踪设置,请使用以下命令:
f server,traceinit

示例:用于使用命令行关闭跟踪的命令

要关闭跟踪,请使用以下命令:
f server,tracenone

示例:使用脚本编制将跟踪发送到 SYSPRINT

要将跟踪发送到 SYSPRINT,请使用以下命令:
f server,tracetosysprint=yes
要停止将跟踪发送到 SYSPRINT,请使用以下命令:
f server,tracetosysprint=no

示例:使用 modify 命令来取消应用程序集群和服务器

此示例说明如何使用 modify 命令来取消应用程序集群和服务器。

开始之前:您不能从 MVS 控制台取消集群。而是,必须取消组成集群的每个服务器。

示例 1:以下命令取消 bbo6acr 服务器:


f bbo6acr,cancel
示例 2:以下命令取消 bbo6acr 服务器并指示 ARM 在该服务器终止后重新启动该服务器:


f bbo6acr,cancel,armrestart

示例:获取关于 modify 命令的帮助

可以针对 modify 命令的各级别获取语法帮助。

示例 1:输入以下命令来显示可与 modify 命令一起使用的所有关键字的列表:
f bbo6acr,help
生成的输出类似于以下示例:
F bbo6acr,HELP
BBOO0178I THE COMMAND MODIFY MAY BE FOLLOWED BY ONE OF THE FOLLOWING KEYWORDS:
BBOO0179I CANCEL - CANCEL THIS CONTROL REGION
BBOO0179I TRACEALL - SET OVERALL TRACE LEVEL
BBOO0179I TRACEBASIC - SET BASIC TRACE COMPONENTS
BBOO0179I TRACEDETAIL - SET DETAILED TRACE COMPONENTS
BBOO0179I TRACESPECIFIC - SET SPECIFIC TRACE POINTS
BBOO0179I TRACEINIT - RESET TO INITIAL TRACE SETTINGS
BBOO0179I TRACENONE - TURN OFF ALL TRACING
BBOO0179I TRACETOSYSPRINT - SEND TRACE OUTPUT TO SYSPRINT (YES/NO)
BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE DD CARD (YES/NO)
BBOO0179I DISPLAY - DISPLAY STATUS
BBOO0179I TRACE_EXCLUDE_SPECIFIC - EXCLUDE SPECIFIC TRACE POINTS
BBOO0179I TRACEJAVA - SET JAVA TRACE OPTIONS
BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE (YES/NO)   
BBOO0179I MDBSTATS - MDB DETAILED STATISTICS                       
BBOO0179I PAUSELISTENERS - PAUSE THE COMMUNICATION LISTENERS       
BBOO0179I RESUMELISTENERS - RESUME THE COMMUNICATION LISTENERS           
BBOO0179I STACKTRACE - LOG JAVA THREAD STACK TRACEBACKS              
BBOO0179I TIMEOUTDUMPACTION - SET TIMEOUT DUMP ACTION               
BBOO0179I TIMEOUTDUMPACTIONSESSION - SET TIMEOUT DUMP ACTION SESSION
BBOO0179I WLM_MIN_MAX - RESET WLM MIN/MAX SERVANT SETTINGS 
示例 2:输入以下命令来显示可与 modify display 命令一起使用的所有关键字的列表:
f bbo6acr,display,help
生成的输出类似于以下示例:
 F BBOS001,DISPLAY,HELP                                                   
 BBOO0178I THE COMMAND DISPLAY, MAY BE FOLLOWED BY ONE OF THE FOLLOWING   
 124                                                                      
 KEYWORDS:                                                                
 BBOO0179I SERVERS - DISPLAY ACTIVE CONTROL PROCESSES                     
 BBOO0179I SERVANTS - DISPLAY SERVANT PROCESSES OWNED BY THIS CONTROL 126 
 PROCESS                                                                  
 BBOO0179I LISTENERS - DISPLAY LISTENERS                                  
 BBOO0179I CONNECTIONS - DISPLAY CONNECTION INFORMATION                   
 BBOO0179I TRACE - DISPLAY INFORMATION ABOUT TRACE SETTINGS               
 BBOO0179I JVMHEAP - DISPLAY JVM HEAP STATISTICS                          
 BBOO0179I WORK - DISPLAY WORK ELEMENTS                                   
 BBOO0179I ERRLOG - DISPLAY THE LAST 10 ENTRIES IN THE ERROR LOG          
 BBOO0179I MODE - DISPLAY THE EXECUTION BITMODE                           
 BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,HELP
示例 3:输入以下命令以显示可与 modify timeoutdumpactionmodify timeoutdumpactionsession 命令一起使用的所有关键字的列表:
f bbos001,timeoutdumpactionsession=help
生成的输出类似于以下示例:
BBOO0178I THE COMMAND MODIFY TIMEOUTDUMPACTIONSESSION= MAY BE FOLLOWED BY
ONE OF the FOLLOWING KEYWORDS:   
BBOO0179I SVCDUMP - SVC DUMP  
BBOO0179I JAVACORE - JAVA CORE DUMP   
BBOO0179I NONE - NO DUMP                   
示例 4:输入以下命令以显示可与 modify display dpm 命令一起使用的所有关键字的列表:
f bbos001,dpm,help                                                  
生成的输出类似于以下示例:
BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE  
FOLLOWING KEYWORDS:    
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL       
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS     
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION    
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY 
如果您已安装 FP8.5.5.1 或更高版本,那么最终获得的输出与以下示例类似:
BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE   
FOLLOWING KEYWORDS:  
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL  
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL 
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL            
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL  
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS     
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION     
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I CRA - MDB CRA DISPATCH PROGRESS MONITOR INTERVAL 
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY        

示例:修改 Java 跟踪字符串

此示例显示如何使用控制台命令来修改 Java 跟踪字符串。

要修改 Java 跟踪字符串,请使用以下命令:
f server, tracejava='trace specification'
示例:以下命令将对所有已注册的跟踪组件启用所有类型的跟踪:
f bbo6acr,tracejava='*=all'
注: 这些引号是语法的必需部分。

示例:修改发生 JVM 内存不足情况时将执行的诊断操作

此示例显示如何使用控制台命令来修改发生 Java 虚拟机 (JVM) 内存不足情况时将执行的诊断操作。请使用以下命令:

f server,javaoom,[interval=xxx | action=xxx]
示例:以下命令的结果为:发生 JVM 内存不足情况时对受影响的地址空间执行 SVCDUMP,并且次代码为 C9C2704B。此命令还会导致在 1200 秒(20 分钟)的时间间隔内无法进行其他诊断操作。
f bbo6acr,,javaoom,[interval=1200 | action=svcdump]
注: 这些引号是语法的必需部分。

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_mvsmodify
文件名:rxml_mvsmodify.html