![[z/OS]](../images/ngzos.gif)
工作负载分类文件
工作负载分类文档是一个公共 XML 文件,它对入站 HTTP、IIOP、消息驱动的 Bean (MDB)、会话启动协议 (SIP)、优化本地适配器和 z/OS® 工作负载管理器的调解工作进行分类。
使用说明
本主题包含具有及不具有可靠性、可用性和可维护性 (RAS) 属性的工作负载分类文件的示例。RAS 属性使得 HTTP 请求、IIOP 请求、MDB 请求和优化本地适配器请求能够达到请求级别 RAS 详细程度。可以在工作负载分类文件中的 http_classification_info 元素、iiop_classification_info 元素、classificationentry 元素、sib_classification_info 元素、wmqra_classification_info 元素和 ola_classification_info 元素上指定这些属性。
完成对 z/OS 工作负载进行分类或启用请求级别 RAS 详细程度的任务时,可使用工作负载分类文件。
必需的元素
- <?xml version="1.0" encoding="UTF-8"?>
- 这表示工作负载分类文档必须保存为 ASCII 格式,应用程序服务器才能处理它。该语句是必需的。
- <!DOCTYPE Classification SYSTEM "Classifications.dtd">
- 为 XML 解析器提供产品随附并用于验证工作负载分类文档的 DTD 文档的名称。您编写的工作负载分类文档必须遵循该 DTD 文档中描述的规则。必须在工作负载分类文档中添加此语句。
- Classification
- <Classification schema_version="1.0">
表明工作负载分类文档的根。每个工作负载分类文档都必须以此元素开头,也以此元素结尾。必须提供 schema_version 属性。唯一受支持的 schema_version 为 1.0。Classification 元素包含一个或多个 InboundClassification 元素。对于入站服务集成工作,Classification 元素最多可以包含两个 SibClassification 元素。如果使用 WebSphere® MQ 消息传递提供程序激活规范对入站消息进行分类以便传送至消息驱动的 Bean,那么 Classification 元素可以包含一个或多个 WMQRAClassification 元素。
- InboundClassification
<InboundClassification type="iiop" schema_version="1.0" default_transaction_class="iiopdflt" default_iiop_application_name="application" default_iiop_module_name="module" default_iiop_component_name="component"> </InboundClassification>
使用 InboundClassification 元素时应遵循以下规则:
- 必须提供 type 属性。值必须为 internal、iiop、http、mdb、sip 或 ola。对于每种类型,InboundClassification 元素只能在该文档中出现一次。一个文档中最多可以有五个 InboundClassification 元素。在分类文档中并不一定按特定顺序来指定这些类型。
- 必须提供 schema_version 属性。必须将该属性的值设为 1.0。
- 必须指定 default_transaction_class 属性,并为指定类型的工作流定义缺省事务类。字符串值必须是有效的 WLM 事务类、空字符串(例如,"")或者是包含八个或更少空格的一个字符串(如 " ")。
- 不能嵌套 InboundClassification 元素。每个 InboundClassification 元素必须在出现下一个 InboundClassification 元素之前结束;换句话说,必须在一个 SibClassification 元素结束之后,另一个 SibClassification 元素才能开始。
- default_iiop_application_name 是可选属性,用于为不具有应用程序名称、模块名称或组件名称的 IIOP 工作流程定义缺省应用程序名称。
- default_iiop_module_name 是可选属性,用于为不具有应用程序名称、模块名称或组件名称的 IIOP 工作流程定义缺省 模块名称。
- default_iiop_component_name 是可选属性,用于为不具有应用程序名称、模块名称或组件名称的 IIOP 工作流程定义 缺省组件名称。
- CORBA 请求是不具有应用程序名称、模块名称或组件名称的 IIOP 工作流程。
- SibClassification
- <SibClassification type="jmsra | destinationmediation"
schema_version="1.0" default_transaction_class="value">
使用 SibClassification 元素时应遵循以下规则:
- 必须提供 type 属性。该属性的值必须为 jmsra 或 destinationmediation。在每种类型的文档中,最多只能有一个 SibClassification 元素。在分类文档中并不一定按特定顺序来指定这些类型。
- 必须提供 schema_version 属性。必须将该属性的值设为 1.0。
- 必须指定 default_transaction_class 属性,并为指定类型的工作流定义缺省事务类。字符串值必须是有效的 WLM 事务类、空字符串(例如,"")或者是包含八个或更少空格的一个字符串(如 " ")。
- 不能嵌套 SibClassification 元素。每个 SibClassification 元素必须在出现下一个 InboundClassification 元素之前结束;换句话说,必须在一个 SibClassification 元素结束之后,另一个 SibClassification 元素才能开始。
- WMQRAClassification
- <WMQRAClassification schema_version=”1.0”
default_transaction_class=”value”>以下规则适用于 WMQRAClassification 元素:
- 必须提供 schema_version 属性。必须将该属性的值设为 1.0。
- 必须指定 default_transaction_class 属性,并为指定类型的工作流定义缺省事务类。字符串值必须为有效的 WLM 事务类。
- 不能嵌套 WMQRAClassification 元素。每个 WMQRAClassification 元素必须在任何其他 classification 元素开始之前结束。
内部分类
具有属性 type="internal" 的 InboundClassification 元素定义文档中适用于内部工作的部分,如在服务方中分派并由所属控制器引起的请求。以下是此元素的一个示例:
<InboundClassification type="internal" schema_version="1.0"
default_transaction_class="value1">
如果未指定具有 type="internal" 属性的 InboundClassification 元素,那么将使用为 IIOP 工作指定的规则对内部工作分类。
IIOP 分类
具有属性 type="iiop" 的 InboundClassification 元素定义文档中适用于 IIOP 分类的部分。以下是此元素的一个示例:
<InboundClassification type="iiop" schema_version="1.0"
default_transaction_class="value1">
- 应用程序名
包含企业 Bean 的应用程序的名称。它是应用程序的显示名称,可能不是包含所有工件的 .ear 文件的名称。
- 模块名
包含一个或多个企业 Bean 的 Enterprise JavaBeans(EJB) .jar 文件的名称。.ear 文件中可以包含多个 EJB .jar 文件。
- 组件名
包含在模块(或 EJB .jar 文件)中的 EJB 的名称。.jar 文件中可以包含一个或多个企业 Bean。
- 方法名
EJB 上远程方法的名称。
通过使用 iiop_classification_info 元素在任何级别对各种应用程序中的 IIOP 工作进行分类。
- iiop_classification_info
<iiop_classification_info transaction_class="value1" application_name="value2" module_name="value3" component_name="value4" method_name="value5" description="value6" dispatch_timeout="value7" queue_timeout_percent ="value8" request_timeout="value9" stalled_thread_dump_action="traceback" cputimeused_limit="value11" cputimeused_dump_action="traceback" dpm_interval="value13" dpm_dump_action="traceback" SMF_request_activity_enabled="1" SMF_request_activity_timestamps="1" SMF_request_activity_security="1" SMF_request_activity_CPU_detail="1" classification_only_trace="1" message_tag="value20">
使用 iiop_classification_info 元素,您可以根据应用程序、模块、组件和方法名称来构建过滤器以将 TCLASS 值、RAS 属性或两者指定给入站请求。使用 iiop_classification_info 元素时应遵循以下规则:
- transaction_class
- transaction_class 属性是可选的。如果未定义该属性,那么它将继承其父代的事务类。字符串值必须是有效的 WLM 事务类、空字符串(例如,"")或者是包含八个或更少空格的一个字符串(如 " ")。通过指定空字符串,您可以覆盖缺省 TCLASS 设置或由更高级别的过滤器指定的 TCLASS 设置。指定空字符串意味着您没有该请求的 TCLASS 值。
- application_name、module_name、component_name 和 method_name
- 可以在需要时使用属性 application_name、module_name、component_name 和 method_name。这些属性充当选择器或过滤器,他们指定事务类或允许嵌套的 iiop_classification_info 元素指定事务类。您可以通过以下方式指定这些属性的值:
- 应用程序、模块、组件或方法的确切名称。
- 通配符值。可以将星号 (*) 置于字符串中的任意位置,用于表示以星号为前缀的字符串开头并以星号为后缀的字符串结尾的任何字符串都将视为匹配项。如果星号位于字符串末尾,那么以星号为前缀的字符串开头的任何字符串都将视为匹配项。示例:
- 字符串 Mar*61 与 Mar61、March61 和 Mar20early61 匹配,但与 March81 或 MAR61 不匹配。
- 字符串 MAR* 与 MARCH、MAR61 和 MARS 匹配,但与 Mar61 或 MAY61 不匹配。
避免故障: 进行比较的值区分大小写。gotcha
可以使用这些属性的任何组合来生成分类过滤器。但是,请仅使用必需的详细程度。例如,如果应用程序服务器上只有一个应用程序,那么分类规则不必指定 application_name 属性。
RAS 属性
您可以指定 iiop_classification_info 元素上的以下 RAS 属性。嵌套元素将继承父元素的 RAS 属性。嵌套元素可覆盖父元素的 RAS 属性。所有 RAS 属性均是可选的。
- dispatch_timeout
指定控制区域在将请求分派至 WLM 队列后等待的时间量。如果控制区域在指定时间内未接收到响应,那么它将发出超时。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_wlm_dispatch_timeout 服务器属性。
- queue_timeout_percent
将 WLM 队列超时指定为分派超时的百分比。百分比范围是 0 - 99。队列超时是请求在超时之前该请求可在 WLM 队列中保留未分派的时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_iiop_queue_timeout_percent 服务器属性。
- request_timeout
指定应用到在已分派请求下生成的出站请求的超时值(以秒计)。已分派请求是分类元素已进行过分类的请求。
此属性将覆盖 com.ibm.CORBA.RequestTimeout 服务器属性。
- stalled_thread_dump_action
指定当请求超过在 dispatch_timeout 属性上为其指定的分派超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_iiop_stalled_thread_dump_action 服务器属性。
- cputimeused_limit
指定 CPU 超时(以毫秒计)。CPU 超时是在请求超时之前允许经过的 CPU 时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 server_region_request_cputimeused_limit 服务器属性。
- cputimeused_dump_action
指定当请求超过在其 cputimeused_limit 属性上指定的 CPU 超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_cputimeused_dump_action 服务器属性。
- dpm_interval
指定分派进度监视器 (DPM) 时间间隔(以秒计)。DPM 监视器在此时间间隔对分类元素已进行分类的请求触发 DPM 转储操作。在 dpm_dump_action 属性上指定 DMP 转储操作。
此属性不会覆盖任何服务器属性。必须使用 modify 命令来启用服务器范围 DPM 时间间隔。
- dpm_dump_action
指定在每个 DPM 时间间隔对分类元素进行分类的请求执行的 DPM 转储操作。在 dpm_interval 属性上指定 DPM 时间间隔。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_dpm_dump_action 服务器属性。
- SMF_request_activity_enabled
指定是否为分类元素进行分类的请求收集系统管理设施 (SMF) 120 子类型 9 记录。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_enabled 服务器属性。
- SMF_request_activity_timestamps
指定是否将请求的 SMF 120 子类型 9 记录上的时间戳记格式化为人类可读的格式。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_timestamps 服务器属性。
- SMF_request_activity_security
指定是否为请求收集 SMF 120 子类型 9 记录的安全性数据部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_security 服务器属性。
- SMF_request_activity_CPU_detail
指定是否为请求收集 SMF 120 子类型 9 记录的 CPU 使用情况细目部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_CPU_detail 服务器属性。
- classification_only_trace
指定是否为分类元素进行过分类的请求生成跟踪记录。
有效值为 0(否)和 1(是)。
此属性不会覆盖任何服务器属性。TRACERECORD modify 命令将覆盖 classification_only_trace。
如果任何分类元素将 classification_only_trace 设为 1,那么分类级别跟踪将对应用程序服务器生效。仅生成跟踪记录的那些线程是处理分类元素已进行分类的请求的线程。该分类元素必须定义 classification_only_trace="1"。任何不处理这样的请求的线程均禁用了跟踪收集并且不会生成跟踪记录。
如果没有任何分类元素定义 classification_only_trace="1",那么分类级别跟踪将不对应用程序服务器生效。服务器不会对任何线程禁用跟踪收集。所有跟踪记录将根据跟踪规范的规定写入到输出。
classification_only_trace 属性不影响定义和激活跟踪规范的方式。该属性仅影响哪些线程写跟踪记录。
- message_tag
指定与分类元素已进行分类的请求生成的所有跟踪记录、日志消息和系统消息一起打印的字符串标记。
此属性的最大字符数为 8。
此属性不会覆盖任何服务器属性。
分类过滤器- 可以使用分层方式将 iiop_classification_info 元素进行嵌套。通过将这些元素进行嵌套,您可以创建基于属性值的分类过滤器。以下过滤器将 MyAPP1 应用程序中 EJB1 和 EJB2 企业 Bean 上的请求进行分类:
<iiop_classification_info transaction_class="FAST" application_name="MyAPP1" component_name="EJB1" /> <iiop_classification_info transaction_class="SLOW" application_name="MyAPP1" component_name="EJB2" />
以下过滤器也将 MyAPP1 应用程序中 EJB1 和 EJB2 上的请求进行分类,但还将该应用程序中任何其他 EJB 上的请求进行分类:
<iiop_classification_info transaction_class="MEDIUM" application_name="MyAPP1"> <iiop_classification_info transaction_class="FAST" component_name="EJB1" /> <iiop_classification_info transaction_class="SLOW" component_name="EJB2" /> </iiop_classification_info>
- 如果您指定与父元素的属性值有冲突的属性值,那么较低级别的过滤器会被否决。以下是与父代元素的属性值有冲突的子代值示例:
<iiop_classification_info transaction_class="FAST" application_name="MyAPP1"> <iiop_classification_info transaction_class="SLOW" application_name="MyAPP2" /> </iiop_classification_info>
在此示例中,因为较高级别的过滤器仅允许将 application_name="MyAPP1" 的 IIOP 请求传递到较低级别的过滤器,所以永远不会将 MyAPP2 中的 EJB 请求指定给事务类“SLOW”。
- 使用特定级别中与请求属性相匹配的第一个过滤器,而不是使用最好的或最符合条件的过滤器。因此,指定过滤器的顺序很重要。
<iiop_classification_info transaction_class="FAST" application_name="MyAPP" /> <iiop_classification_info transaction_class="SLOW" component_name="*" /> <iiop_classification_info transaction_class="MEDIUM" component_name="MySSB" /> </iiop_classification_info>
在上面的示例中,MyAPP 应用程序中的企业 Bean 处理的所有 IIOP 请求都被分配了一个 TCLASS 值 SLOW。对于任何对 MySSB 企业的请求也会进行此分配。即使为 MySSB 分配了事务类,但仍不会应用该过滤器,这是因为已应用了第一个过滤器且为它分配了 TCLASS 值 SLOW。将忽略同一级别的其余过滤器。
- “描述”字段是可选的。但是,您应该在所有 iiop_classification_info 元素中使用描述。描述字符串将作为操作员命令支持的一部分进行打印,所以您可以标识将使用的分类规则。因为描述显示在 MVS™ 控制台中,所以应尽量使其简短一些。
HTTP 分类
具有属性 type="http" 的 InboundClassification 元素定义文档中适用于 HTTP 分类的部分。以下是此元素的一个示例:
<InboundClassification type="http"
schema_version="1.0"
default_transaction_class="value1">
- 虚拟主机名
在 HTTP 头中指定要将入站请求发送至的主机名。
- 端口号
指定 HTTP 捕获器侦听的端口。
- URI(统一资源标识)
标识 Web 应用程序的字符串。
<http_classification_info transaction_class="value1"
host="value2"
port="value3"
uri="value4"
description="value5"
dispatch_timeout="value6"
queue_timeout_percent ="value7"
request_timeout="value8"
stalled_thread_dump_action="traceback"
cputimeused_limit="value10"
cputimeused_dump_action="traceback"
dpm_interval="value12"
dpm_dump_action="traceback"
SMF_request_activity_enabled="1"
SMF_request_activity_timestamps="1"
SMF_request_activity_security="1"
SMF_request_activity_CPU_detail="1"
classification_only_trace="1"
message_tag="value19"
timeout_recovery="value20">
使用 http_classification_info 元素,您可以根据主机、端口和 URI 来构建过滤器以将 TCLASS 值、RAS 属性或两者指定给入站请求。使用 http_classification_info 元素时应遵循以下规则:
- transaction_class
- transaction_class 属性是可选的。如果未定义该属性,那么它将继承其父代的事务类。字符串值必须是有效的 WLM 事务类、空字符串(例如,"")或者是包含八个或更少空格的一个字符串(如 " ")。通过指定空字符串,您可以覆盖缺省 TCLASS 设置或由更高级别的过滤器指定的 TCLASS 设置。指定空字符串意味着您没有该请求的 TCLASS 值。
- host、port 和 uri
- 可以在需要时使用属性 host、port 和 uri。这些属性充当选择器或过滤器,他们指定事务类或允许嵌套的 http_classification_info 元素指定事务类。您可以通过以下方式指定这些属性的值:
- 主机、端口或 URI 的确切名称。
- 任何值。要指定与任何值都匹配的值,请使用星号 (*)。
- 通配符值。可以将星号 (*) 置于字符串中的任意位置,用于表示以星号为前缀的字符串开头并以星号为后缀的字符串结尾的任何字符串都将视为匹配项。如果星号位于字符串末尾,那么以星号为前缀的字符串开头的任何字符串都将视为匹配项。示例:
- 字符串 Mar*61 与 Mar61、March61 和 Mar20early61 匹配,但与 March81 不匹配。
- 字符串 MAR* 与 MARCH、MAR61 和 MARS 匹配,但与 Mar61 或 MAY61 不匹配。
避免故障: 进行比较的值区分大小写。gotcha
使用任何或所有这些属性来生成分类过滤器。仅使用必需的详细程度。例如,如果应用程序服务器上只有一个应用程序,那么分类规则不必指定 uri 属性。
RAS 属性:
您可以指定 http_classification_info 元素上的以下 RAS 属性。嵌套元素将继承父元素的 RAS 属性。嵌套元素可覆盖父元素的 RAS 属性。所有 RAS 属性均是可选的。
- dispatch_timeout
指定控制区域在将请求分派至 WLM 队列后等待的时间量。如果控制区域在指定时间内未接收到响应,那么它将发出超时。此请求是分类元素已进行过分类的请求。
此属性将覆盖以下服务器属性:- HTTP
- protocol_http_timeout_output
- HTTPS
- protocol_https_timeout_output
- queue_timeout_percent
将 WLM 队列超时指定为分派超时的百分比。百分比范围是 0 - 99。队列超时是请求在超时之前该请求可在 WLM 队列中保留未分派的时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖以下服务器属性:- HTTP
- control_region_http_queue_timeout_percent
- HTTPS
- control_region_https_queue_timeout_percent
- request_timeout
指定应用到在已分派请求下生成的出站请求的超时值(以秒计)。已分派请求是分类元素已进行过分类的请求。
此属性将覆盖 com.ibm.CORBA.RequestTimeout 服务器属性。
- stalled_thread_dump_action
指定当请求超过在 dispatch_timeout 属性上为其指定的分派超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖以下服务器属性:- HTTP
- server_region_http_stalled_thread_dump_action
- HTTPS
- server_region_https_stalled_thread_dump_action
- cputimeused_limit
指定 CPU 超时(以毫秒计)。CPU 超时是在请求超时之前允许经过的 CPU 时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 server_region_request_cputimeused_limit 服务器属性。
- cputimeused_dump_action
指定当请求超过在其 cputimeused_limit 属性上指定的 CPU 超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_cputimeused_dump_action 服务器属性。
- dpm_interval
指定分派进度监视器 (DPM) 时间间隔(以秒计)。DPM 监视器在此时间间隔对分类元素已进行分类的请求触发 DPM 转储操作。在 dpm_dump_action 属性上指定 DMP 转储操作。
此属性不会覆盖任何服务器属性。必须使用 modify 命令来启用服务器范围 DPM 时间间隔。
- dpm_dump_action
指定在每个 DPM 时间间隔对分类元素进行分类的请求执行的 DPM 转储操作。在 dpm_interval 属性上指定 DPM 时间间隔。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_dpm_dump_action 服务器属性。
- SMF_request_activity_enabled
指定是否为分类元素进行分类的请求收集系统管理设施 (SMF) 120 子类型 9 记录。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_enabled 服务器属性。
- SMF_request_activity_timestamps
指定是否将请求的 SMF 120 子类型 9 记录上的时间戳记格式化为人类可读的格式。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_timestamps 服务器属性。
- SMF_request_activity_security
指定是否为请求收集 SMF 120 子类型 9 记录的安全性数据部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_security 服务器属性。
- SMF_request_activity_CPU_detail
指定是否为请求收集 SMF 120 子类型 9 记录的 CPU 使用情况细目部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_CPU_detail 服务器属性。
- classification_only_trace
指定是否为分类元素进行过分类的请求生成跟踪记录。
有效值为 0(否)和 1(是)。
此属性不会覆盖任何服务器属性。TRACERECORD modify 命令将覆盖 classification_only_trace。
如果任何分类元素将 classification_only_trace 设为 1,那么分类级别跟踪将对应用程序服务器生效。仅生成跟踪记录的那些线程是处理分类元素已进行分类的请求的线程。该分类元素必须定义 classification_only_trace="1"。任何不处理这样的请求的线程均禁用了跟踪收集并且不会生成跟踪记录。
如果没有任何分类元素定义 classification_only_trace="1",那么分类级别跟踪将不对应用程序服务器生效。服务器不会对任何线程禁用跟踪收集。所有跟踪记录将根据跟踪规范的规定写入到输出。
classification_only_trace 属性不影响定义和激活跟踪规范的方式。该属性仅影响哪些线程写跟踪记录。
- message_tag
指定与分类元素已进行分类的请求生成的所有跟踪记录、日志消息和系统消息一起打印的字符串标记。
此属性的最大字符数为 8。
此属性不会覆盖任何服务器属性。
- timeout_recovery
指定当分类元素进行过分类的请求超过其分派超时值时服务器采取的操作。在 dispatch_timeout 属性上指定分派超时。
有效值为 servant 和 session。
当此属性设置为 servant 时,将终止处理请求的服务方地址空间,并显示 ABEND EC3 和原因码 04130007。控制器地址空间向客户机发送失败响应,然后关闭与该请求相关联的套接字。
当此属性设置为 session 时, 控制器地址空间向客户机发送失败响应,然后关闭与该请求相关联的套接字。服务方地址空间不会被终止。请求不会被中断,而是允许其完成运行。
此属性将覆盖以下服务器属性:- HTTP
- protocol_http_timeout_output_recovery
- HTTPS
- protocol_https_timeout_output_recovery
分类过滤器:
- 可以按分层方式将 http_classification_info 元素进行嵌套。可以根据属性名称来构造过滤器。考虑以下两个过滤器:
<http_classification_info transaction_class="FAST" host="MyVHost1.com" uri="/MyWebApp1/*" /> <http_classification_info transaction_class="SLOW" host="MyVHost2.com" uri="/MyWebApp2/*" />
<http_classification_info transaction_class="MEDIUM" host="MyVHost1.com"> <http_classification_info transaction_class="FAST" uri="/MyWebApp1/*" /> <http_classification_info transaction_class="SLOW" uri="/MyWebApp2/*" /> </http_classification_info>
两个过滤器都会将对应用程序服务器中由上下文根 /MyWebApp1 和 /MyWebApp2 标识的 Web 应用程序的请求进行分类,该应用程序服务器正在主管虚拟主机 MyVHost1.com 的 Web 应用程序。但是,第二个过滤器还会将应用程序服务器中任何其他上下文根中的请求进行分类。
- 指定与父元素的属性值不同的属性名会有效地否决较低级别的过滤器。例如,
<http_classification_info transaction_class="FAST" uri="/MyWebApp1/*"> <http_classification_info transaction_class="SLOW" uri="/MyWebApp2"> </http_classification_info> </http_classification_info>
此示例将不会给上下文根为 /MyWebApp2 的 Web 应用程序分配 SLOW 事务类。较高级别的过滤器仅允许将上下文根为 /MyWebApp1/* 的 HTTP 请求传递到较低级别的过滤器。
- 使用特定级别的第一个过滤器,而不是使用最好的或最符合条件的过滤器。因此,每个级别的过滤器的顺序很重要。例如:
<http_classification_info transaction_class="FAST" host="MyVHost.com" /> <http_classification_info transaction_class="SLOW" uri="*" /> <http_classification_info transaction_class="MEDIUM" uri="/MyWebAppX/*" /> </http_classification_info>
在此示例中,由应用程序服务器通过虚拟主机“MyVHost.com”处理的 HTTP 请求 被分配了一个 TCLASS 值 SLOW。因为未应用过滤器,所以甚至对上下文根为 /MyWebAppX 的 Web 应用程序的请求也被分配了 TCLASS 值 SLOW。第一个匹配的过滤器用于 TCLASS 分配,忽略同一级别中其余的过滤器。
- description 字段是可选的,但是,应该在所有 http_classification_info 元素中上使用它。当您在 MVS 控制台中监视事务类时将显示该描述。
MDB 分类
<InboundClassification type="mdb"
schema_version="1.0"
default_transaction_class="qrs">
<endpoint type="messagelistenerport"
name="IPVListenerPort"
defaultclassification="MDBX"
description="ABC">
- type 属性必须始终等于 messagelistenerport。
- name 属性对应于 endpoint 元素的侦听器。name 属性的值必须是在服务器的管理控制台中指定的侦听器端口的名称。
- defaultclassification 元素是与消息驱动的 Bean 相关联的缺省事务类。此属性的值覆盖缺省事务分类值。
- description 字段是可选的,但是,应该在所有 endpoint 元素中使用它。当您在 MVS 控制台中监视事务类时将显示该描述。
<classificationentry selector="Location='East'"
classification="MDB2"
description="XYZ"
dispatch_timeout="value1"
queue_timeout_percent ="value2"
request_timeout="value3"
stalled_thread_dump_action="traceback"
cputimeused_limit="value5"
cputimeused_dump_action="traceback"
dpm_interval="value7"
dpm_dump_action="traceback"
SMF_request_activity_enabled="1"
SMF_request_activity_timestamps="1"
SMF_request_activity_security="1"
SMF_request_activity_CPU_detail="1"
classification_only_trace="1"
message_tag="value14"/>
- 选择器 (selector)
- 对于其部署描述符中具有 selector 子句的消息驱动的 Bean,可以使用 classificationentry 元素的 selector 属性来为它指定事务类。定义 classificationentry 元素时应遵循以下规则:
- selector 属性的值必须与 MDB 部署描述符中的 selector 子句精确匹配。
- selector 属性的值必须符合 XML 文档的正确语法。您必须将 < 符号替换为 < 实体引用并将 > 符号替换为 > 实体引用。同样,如果您要使用撇号或引号,那么必须使用 ' 和 " 实体引用。
- 分类
分类属性是可选的。如果未定义该属性,那么它将继承其父代的分类。字符串值必须是有效的 WLM 事务类、空字符串(例如,"")或者是包含八个或更少空格的一个字符串(如 " ")。通过指定空字符串,您可以覆盖缺省 TCLASS 设置或由更高级别的过滤器指定的 TCLASS 设置。指定空字符串意味着您没有该请求的 TCLASS 值。
RAS 属性:
您可以指定分类元素上的以下 RAS 属性。嵌套元素将继承父元素的 RAS 属性。嵌套元素可覆盖父元素的 RAS 属性。所有 RAS 属性均是可选的。
- dispatch_timeout
指定控制区域在将请求分派至 WLM 队列后等待的时间量。如果控制区域在指定时间内未接收到响应,那么它将发出超时。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_mdb_request_timeout 服务器属性。
- queue_timeout_percent
将 WLM 队列超时指定为分派超时的百分比。百分比范围是 0 - 99。队列超时是请求在超时之前该请求可在 WLM 队列中保留未分派的时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_mdb_queue_timeout_percent 服务器属性。
- request_timeout
指定应用到在已分派请求下生成的出站请求的超时值(以秒计)。已分派请求是分类元素已进行过分类的请求。
此属性将覆盖 com.ibm.CORBA.RequestTimeout 服务器属性。
- stalled_thread_dump_action
指定当请求超过在 dispatch_timeout 属性上为其指定的分派超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_mdb_stalled_thread_dump_action 服务器属性。
- cputimeused_limit
指定 CPU 超时(以毫秒计)。CPU 超时是在请求超时之前允许经过的 CPU 时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 server_region_request_cputimeused_limit 服务器属性。
- cputimeused_dump_action
指定当请求超过在其 cputimeused_limit 属性上指定的 CPU 超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_cputimeused_dump_action 服务器属性。
- dpm_interval
指定分派进度监视器 (DPM) 时间间隔(以秒计)。DPM 监视器在此时间间隔对分类元素已进行分类的请求触发 DPM 转储操作。在 dpm_dump_action 属性上指定 DMP 转储操作。
此属性不会覆盖任何服务器属性。必须使用 modify 命令来启用服务器范围 DPM 时间间隔。
- dpm_dump_action
指定在每个 DPM 时间间隔对分类元素进行分类的请求执行的 DPM 转储操作。在 dpm_interval 属性上指定 DPM 时间间隔。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_dpm_dump_action 服务器属性。
- SMF_request_activity_enabled
指定是否为分类元素进行分类的请求收集系统管理设施 (SMF) 120 子类型 9 记录。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_enabled 服务器属性。
- SMF_request_activity_timestamps
指定是否将请求的 SMF 120 子类型 9 记录上的时间戳记格式化为人类可读的格式。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_timestamps 服务器属性。
- SMF_request_activity_security
指定是否为请求收集 SMF 120 子类型 9 记录的安全性数据部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_security 服务器属性。
- SMF_request_activity_CPU_detail
指定是否为请求收集 SMF 120 子类型 9 记录的 CPU 使用情况细目部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_CPU_detail 服务器属性。
- classification_only_trace
指定是否为分类元素进行过分类的请求生成跟踪记录。
有效值为 0(否)和 1(是)。
此属性不会覆盖任何服务器属性。TRACERECORD modify 命令将覆盖 classification_only_trace。
如果任何分类元素将 classification_only_trace 设为 1,那么分类级别跟踪将对应用程序服务器生效。仅生成跟踪记录的那些线程是处理分类元素已进行分类的请求的线程。该分类元素必须定义 classification_only_trace="1"。任何不处理这样的请求的线程均禁用了跟踪收集并且不会生成跟踪记录。
如果没有任何分类元素定义 classification_only_trace="1",那么分类级别跟踪将不对应用程序服务器生效。服务器不会对任何线程禁用跟踪收集。所有跟踪记录将根据跟踪规范的规定写入到输出。
classification_only_trace 属性不影响定义和激活跟踪规范的方式。该属性仅影响哪些线程写跟踪记录。
- message_tag
指定与分类元素已进行分类的请求生成的所有跟踪记录、日志消息和系统消息一起打印的字符串标记。
此属性的最大字符数为 8。
此属性不会覆盖任何服务器属性。
优化本地适配器分类
具有属性 type="ola" 的 InboundClassification 元素定义文档中适用于优化本地适配器分类的部分。以下是此元素的一个示例:
<InboundClassification type="ola" schema_version="1.0"
default_transaction_class="value1"
>
可以通过为每个使用了服务名称或 Java 命名和目录接口 (JNDI) Home 名称的 EJB 应用程序添加一个小节来对优化本地适配器工作进行分类。可以使用通配符作为 JNDI Home 名称。
通过使用 iiop_classification_info 元素在任何级别对各种应用程序中的优化本地适配器工作进行分类。
- ola_classification_info
<ola_classification_info transaction_class="value1" propagate_transaction_name="value2" service_name="value3" description="value4" dispatch_timeout="value5" queue_timeout_percent ="value6" request_timeout="value7" stalled_thread_dump_action="traceback" cputimeused_limit="value9" cputimeused_dump_action="traceback" dpm_interval="value11" dpm_dump_action="traceback" SMF_request_activity_enabled="1" SMF_request_activity_timestamps="1" SMF_request_activity_security="1" SMF_request_activity_CPU_detail="1" classification_only_trace="1" message_tag="value18">
使用 ola_classification_info 元素,您可以根据服务或 JNDI 名称构建过滤器。使用该名称以将 TCLASS 值、RAS 属性或者两者指定给入站请求。使用 ola_classification_info 元素时应遵循以下规则:
- transaction_class
- transaction_class 属性是可选的。如果未定义该属性,那么它将继承其父代的事务类。字符串值必须是有效的 WLM 事务类、空字符串(例如,"")或者是包含八个或更少空格的一个字符串(如 " ")。通过指定空字符串,您可以覆盖缺省 TCLASS 设置或由更高级别的过滤器指定的 TCLASS 设置。指定空字符串意味着您没有该请求的 TCLASS 值。
- propagate_transaction_name
- propagate_transaction_name 属性是可选的。如果指定了该属性,字符串值必须为 true 或 false。通过指定值 true,如果指定了 service_name 过滤器,则会将客户信息控制系统 (CICS®) 中的 WLM 服务类传播至应用程序服务器的每个请求或每个匹配的请求。通过优化本地适配器在应用程序服务器中分派的工作将在同一服务类下作为客户机请求运行。
- service_name
- service_name 属性是可选的。此属性充当选择器或过滤器,它将指定事务类或允许嵌套 ola_classification_info 元素指定事务类。您可以通过以下方式指定此属性的值:
- 要驱动的 EJB 应用程序的确切服务名称或 JNDI Home 名称。
- 通配符值。可以将星号 (*) 置于字符串中的任意位置,用于表示以星号为前缀的字符串开头并以星号为后缀的字符串结尾的任何字符串都将视为匹配项。如果星号位于字符串末尾,那么以星号为前缀的字符串开头的任何字符串都将视为匹配项。示例:
- service_name="ejb/mySecondBean"
- service_name="ejb/my*Bean"
- service_name="ejb/my*"
- service_name="ejb/security/*"
警告:应用程序服务器进行比较的值区分大小写。
RAS 属性
您可以指定 ola_classification_info 元素上的以下 RAS 属性。嵌套元素将继承父元素的 RAS 属性。嵌套元素可覆盖父元素的 RAS 属性。所有 RAS 属性均是可选的。
- dispatch_timeout
指定控制区域在将请求分派至 WLM 队列后等待的时间量。如果控制区域在指定时间内未接收到响应,那么它将发出超时。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_wlm_dispatch_timeout 服务器属性。
- queue_timeout_percent
将 WLM 队列超时指定为分派超时的百分比。百分比范围是 0 - 99。队列超时是请求在超时之前该请求可在 WLM 队列中保留未分派的时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_iiop_queue_timeout_percent 服务器属性。
- request_timeout
指定应用到在已分派请求下生成的出站请求的超时值(以秒计)。已分派请求是分类元素已进行过分类的请求。
此属性将覆盖 com.ibm.CORBA.RequestTimeout 服务器属性。
- stalled_thread_dump_action
指定当请求超过在 dispatch_timeout 属性上为其指定的分派超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_iiop_stalled_thread_dump_action 服务器属性。
- cputimeused_limit
指定 CPU 超时(以毫秒计)。CPU 超时是在请求超时之前允许经过的 CPU 时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 server_region_request_cputimeused_limit 服务器属性。
- cputimeused_dump_action
指定当请求超过在其 cputimeused_limit 属性上指定的 CPU 超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_cputimeused_dump_action 服务器属性。
- dpm_interval
指定分派进度监视器 (DPM) 时间间隔(以秒计)。DPM 监视器在此时间间隔对分类元素已进行分类的请求触发 DPM 转储操作。在 dpm_dump_action 属性上指定 DMP 转储操作。
此属性不会覆盖任何服务器属性。必须使用 modify 命令来启用服务器范围 DPM 时间间隔。
- dpm_dump_action
指定在每个 DPM 时间间隔对分类元素进行分类的请求执行的 DPM 转储操作。在 dpm_interval 属性上指定 DPM 时间间隔。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_dpm_dump_action 服务器属性。
- SMF_request_activity_enabled
指定是否为分类元素进行分类的请求收集系统管理设施 (SMF) 120 子类型 9 记录。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_enabled 服务器属性。
- SMF_request_activity_timestamps
指定是否将请求的 SMF 120 子类型 9 记录上的时间戳记格式化为人类可读的格式。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_timestamps 服务器属性。
- SMF_request_activity_security
指定是否为请求收集 SMF 120 子类型 9 记录的安全性数据部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_security 服务器属性。
- SMF_request_activity_CPU_detail
指定是否为请求收集 SMF 120 子类型 9 记录的 CPU 使用情况细目部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_CPU_detail 服务器属性。
- classification_only_trace
指定是否为分类元素进行过分类的请求生成跟踪记录。
有效值为 0(否)和 1(是)。
此属性不会覆盖任何服务器属性。TRACERECORD modify 命令将覆盖 classification_only_trace。
如果任何分类元素将 classification_only_trace 设为 1,那么分类级别跟踪将对应用程序服务器生效。仅生成跟踪记录的那些线程是处理分类元素已进行分类的请求的线程。该分类元素必须定义 classification_only_trace="1"。任何不处理这样的请求的线程均禁用了跟踪收集并且不会生成跟踪记录。
如果没有任何分类元素定义 classification_only_trace="1",那么分类级别跟踪将不对应用程序服务器生效。服务器不会对任何线程禁用跟踪收集。所有跟踪记录将根据跟踪规范的规定写入到输出。
classification_only_trace 属性不影响定义和激活跟踪规范的方式。该属性仅影响哪些线程写跟踪记录。
- message_tag
指定与分类元素已进行分类的请求生成的所有跟踪记录、日志消息和系统消息一起打印的字符串标记。
此属性的最大字符数为 8。
此属性不会覆盖任何服务器属性。
分类过滤器:- 可以按分层方式将 ola_classification_info 元素进行嵌套。通过将这些元素进行嵌套,您可以创建基于属性值的分类过滤器。
<ola_classification_info transaction_class="MEDIUM" service_name="ejb/my*Bean"> <ola_classification_info transaction_class="FAST" service_name="ejb/myFastBean" /> <ola_classification_info transaction_class="SLOW" service_name="ejb/mySlowBean" /> </ola_classification_info>
- “描述”字段是可选的。但是,应该在所有 ola_classification_info 元素中使用描述。描述字符串将作为操作员命令支持的一部分进行打印,所以您可以标识将使用的分类规则。因为描述显示在 MVS 控制台中,所以应尽量使其简短一些。
SIP 分类
具有属性 type="sip" 的 InboundClassification 元素会定义文档中的以下部分:设置会话启动协议 (SIP) 请求的缺省事务类。以下是此元素的一个示例:
<InboundClassification type="sip" schema_version="1.0"
default_transaction_class="value1">
JMS RA 分类
<SibClassification type="jmsra"
schema_version="1.0"
default_transaction_class="a">
<sib_classification_info
transaction_class="sibb"
selector="user.Location='East'"
bus="bigrred"
destination="abusqueue"
description="Some words"
discriminator="XPath Expression"
dispatch_timeout="value1"
queue_timeout_percent ="value2"
request_timeout="value3"
stalled_thread_dump_action="traceback"
cputimeused_limit="value5"
cputimeused_dump_action="traceback"
dpm_interval="value7"
dpm_dump_action="traceback"
SMF_request_activity_enabled="1"
SMF_request_activity_timestamps="1"
SMF_request_activity_security="1"
SMF_request_activity_CPU_detail="1"
classification_only_trace="1"
message_tag="value14"/>
- 选择器 (selector)
- 对于其部署描述符中具有 selector 子句的消息驱动的 Bean,可以使用
sib_classification_info 元素的 selector 属性来为它指定事务类。定义 sib_classification_info 元素时应遵循以下规则:
- selector 属性的值是一个 SQL 表达式,它根据 message 属性的值来选择消息。其语法就是 JMS 1.1 规范中消息选择器的语法,但是该语法可以对 SIMessage 消息(多条 JMS 消息)执行操作。可以在系统属性(包括 JMS 头、JMSX 属性和 JMS_IBM_properties)和用户属性上选择该语法(用户属性必须以“.user”作为前缀,例如,对于用户属性“Location”,选择器将指定“user.Location”,如前面示例中所示)。有关更多信息,请参阅有关使用消息属性的主题。
- selector 属性的值必须符合 XML 文档的正确语法。您必须将 < 符号替换为 < 实体引用并将 > 符号替换为 > 实体引用。同样,如果您要使用撇号或引号,那么必须使用 ' 和 " 实体引用。
- bus
- 指定目标目的地的服务集成总线的名称。分类适用于由此属性指定的总线,如果未指定此属性,那么分类适用于任何总线。分类适用于的目标取决于 destination 属性的使用。
- destination
- 消息已传递至的目标总线目标的名称。这是队列或主题空间的名称。分类适用于由此属性指定的目标,如果未指定此属性,那么分类适用于任何目标。分类所适用的服务集成总线取决于 bus 属性的使用。
- discriminator
- 仅当 destination 属性指定主题空间时该属性才适用。此鉴别器值则是一个 XPath 表达式,用来在主题空间中选择一个或多个主题。
- description
- 尽管 description 字段是可选的,但是,还是应该在所有 sib_classification_info 元素中使用它。当您在 MVS 控制台中监视事务类时将显示该描述。
RAS 属性
您可以指定 sib_classification_info 元素上的以下 RAS 属性。嵌套元素将继承父元素的 RAS 属性。嵌套元素可覆盖父元素的 RAS 属性。所有 RAS 属性均是可选的。
- dispatch_timeout
指定控制区域在将请求分派至 WLM 队列后等待的时间量。如果控制区域在指定时间内未接收到响应,那么它将发出超时。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_wlm_dispatch_timeout 服务器属性。
- queue_timeout_percent
将 WLM 队列超时指定为分派超时的百分比。百分比范围是 0 - 99。队列超时是请求在超时之前该请求可在 WLM 队列中保留未分派的时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_iiop_queue_timeout_percent 服务器属性。
- request_timeout
指定应用到在已分派请求下生成的出站请求的超时值(以秒计)。已分派请求是分类元素已进行过分类的请求。
此属性将覆盖 com.ibm.CORBA.RequestTimeout 服务器属性。
- stalled_thread_dump_action
指定当请求超过在 dispatch_timeout 属性上为其指定的分派超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_iiop_stalled_thread_dump_action 服务器属性。
- cputimeused_limit
指定 CPU 超时(以毫秒计)。CPU 超时是在请求超时之前允许经过的 CPU 时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 server_region_request_cputimeused_limit 服务器属性。
- cputimeused_dump_action
指定当请求超过在其 cputimeused_limit 属性上指定的 CPU 超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_cputimeused_dump_action 服务器属性。
- dpm_interval
指定分派进度监视器 (DPM) 时间间隔(以秒计)。DPM 监视器在此时间间隔对分类元素已进行分类的请求触发 DPM 转储操作。在 dpm_dump_action 属性上指定 DMP 转储操作。
此属性不会覆盖任何服务器属性。必须使用 modify 命令来启用服务器范围 DPM 时间间隔。
- dpm_dump_action
指定在每个 DPM 时间间隔对分类元素进行分类的请求执行的 DPM 转储操作。在 dpm_interval 属性上指定 DPM 时间间隔。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_dpm_dump_action 服务器属性。
- SMF_request_activity_enabled
指定是否为分类元素进行分类的请求收集系统管理设施 (SMF) 120 子类型 9 记录。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_enabled 服务器属性。
- SMF_request_activity_timestamps
指定是否将请求的 SMF 120 子类型 9 记录上的时间戳记格式化为人类可读的格式。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_timestamps 服务器属性。
- SMF_request_activity_security
指定是否为请求收集 SMF 120 子类型 9 记录的安全性数据部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_security 服务器属性。
- SMF_request_activity_CPU_detail
指定是否为请求收集 SMF 120 子类型 9 记录的 CPU 使用情况细目部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_CPU_detail 服务器属性。
- classification_only_trace
指定是否为分类元素进行过分类的请求生成跟踪记录。
有效值为 0(否)和 1(是)。
此属性不会覆盖任何服务器属性。TRACERECORD modify 命令将覆盖 classification_only_trace。
如果任何分类元素将 classification_only_trace 设为 1,那么分类级别跟踪将对应用程序服务器生效。仅生成跟踪记录的那些线程是处理分类元素已进行分类的请求的线程。该分类元素必须定义 classification_only_trace="1"。任何不处理这样的请求的线程均禁用了跟踪收集并且不会生成跟踪记录。
如果没有任何分类元素定义 classification_only_trace="1",那么分类级别跟踪将不对应用程序服务器生效。服务器不会对任何线程禁用跟踪收集。所有跟踪记录将根据跟踪规范的规定写入到输出。
classification_only_trace 属性不影响定义和激活跟踪规范的方式。该属性仅影响哪些线程写跟踪记录。
- message_tag
指定与分类元素已进行分类的请求生成的所有跟踪记录、日志消息和系统消息一起打印的字符串标记。
此属性的最大字符数为 8。
此属性不会覆盖任何服务器属性。
每个 sib_classification_info 元素都可以包含这些属性中的一种或多种属性(对消息的工作进行分类所需的)。sib_classification_info 元素不能包含每种属性的多个实例。
<sib_classification_info bus="MyBus" transaction_class="a" />
<sib_classification_info destination="MyDest" transaction_class="b" />
对于从服务集成总线 MyBus 到达目标 MyDest 的消息,为它指定的分类为“a”。而对于从另一条总线到达 MyDest 的消息,指定的分类为“b”。
如果一条消息与外层 SibClassification 元素中的任何 sib_classification_info 元素都不匹配,那么会为该消息指定该 SibClassification 元素中的缺省分类。
如果一条消息与任何 SibClassification 元素中的任何 sib_classification_info 元素都不匹配,或者如果没有定义任何 SibClassification,那么所有工作都将接收到值为“SIBUS”的内置缺省分类。必须执行在使用 TCLASS 值“SIBUS”时所需要的 z/OS 工作负载管理器操作,如对 z/OS 工作负载分类中所述。
调解分类
<SibClassification type="destinationmediation"
schema_version="1.0"
default_transaction_class="b">
<sib_classification_info
transaction_class="e"
selector="user.Location='East'"
bus="bigrred"
destination="themoon"
discriminator="sides/dark"
description="n"
dispatch_timeout="value1"
queue_timeout_percent ="value2"
request_timeout="value3"
stalled_thread_dump_action="traceback"
cputimeused_limit="value5"
cputimeused_dump_action="traceback"
dpm_interval="value7"
dpm_dump_action="traceback"
SMF_request_activity_enabled="1"
SMF_request_activity_timestamps="1"
SMF_request_activity_security="1"
SMF_request_activity_CPU_detail="1"
classification_only_trace="1"
message_tag="value14"/>
- 选择器 (selector)
- 对于其部署描述符中具有 selector 子句的调解,可以使用
sib_classification_info 元素的 selector 属性来为它指定事务类。定义 sib_classification_info 元素时应遵循以下规则:
- selector 属性的值是一个 SQL 表达式,它根据 message 属性的值来选择消息。其语法就是 JMS 1.1 规范中消息选择器的语法,但是该语法可以对
SIMessage 消息(多条 JMS 消息)执行操作。可以在系统属性(包括
JMS 头、JMSX 属性和 JMS_IBM_properties)和用户属性上选择该语法(用户属性必须以“.user”作为前缀,例如,对于用户属性“Location”,选择器将指定“user.Location”,如前面示例中所示)。
有关更多信息,请参阅有关使用消息属性的主题。
- selector 属性的值必须符合 XML 文档的正确语法。您必须将 < 符号替换为 < 实体引用并将 > 符号替换为 > 实体引用。同样,如果您要使用撇号或引号,那么必须使用 ' 和 " 实体引用。
- selector 属性的值是一个 SQL 表达式,它根据 message 属性的值来选择消息。其语法就是 JMS 1.1 规范中消息选择器的语法,但是该语法可以对
SIMessage 消息(多条 JMS 消息)执行操作。可以在系统属性(包括
JMS 头、JMSX 属性和 JMS_IBM_properties)和用户属性上选择该语法(用户属性必须以“.user”作为前缀,例如,对于用户属性“Location”,选择器将指定“user.Location”,如前面示例中所示)。
- bus
- 指定目标目的地的服务集成总线的名称。分类适用于由此属性指定的总线,如果未指定此属性,那么分类适用于任何总线。分类适用于的目标取决于 destination 属性的使用。
- destination
- 消息已传递至的目标总线目标的名称。这是队列或主题空间的名称。分类适用于由此属性指定的目标,如果未指定此属性,那么分类适用于任何目标。分类所适用的服务集成总线取决于 bus 属性的使用。
- discriminator
- 仅当 destination 属性指定主题空间时该属性才适用。此鉴别器值则是一个 XPath 表达式,用来在主题空间中选择一个或多个主题。
- description
- 尽管 description 字段是可选的,但是,还是应该在所有 sib_classification_info 元素中使用它。当您在 MVS 控制台中监视事务类时将显示该描述。
RAS 属性
您可以指定 sib_classification_info 元素上的以下 RAS 属性。嵌套元素将继承父元素的 RAS 属性。嵌套元素可覆盖父元素的 RAS 属性。所有 RAS 属性均是可选的。
- dispatch_timeout
指定控制区域在将请求分派至 WLM 队列后等待的时间量。如果控制区域在指定时间内未接收到响应,那么它将发出超时。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_wlm_dispatch_timeout 服务器属性。
- queue_timeout_percent
将 WLM 队列超时指定为分派超时的百分比。百分比范围是 0 - 99。队列超时是请求在超时之前该请求可在 WLM 队列中保留未分派的时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_iiop_queue_timeout_percent 服务器属性。
- request_timeout
指定应用到在已分派请求下生成的出站请求的超时值(以秒计)。已分派请求是分类元素已进行过分类的请求。
此属性将覆盖 com.ibm.CORBA.RequestTimeout 服务器属性。
- stalled_thread_dump_action
指定当请求超过在 dispatch_timeout 属性上为其指定的分派超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_iiop_stalled_thread_dump_action 服务器属性。
- cputimeused_limit
指定 CPU 超时(以毫秒计)。CPU 超时是在请求超时之前允许经过的 CPU 时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 server_region_request_cputimeused_limit 服务器属性。
- cputimeused_dump_action
指定当请求超过在其 cputimeused_limit 属性上指定的 CPU 超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_cputimeused_dump_action 服务器属性。
- dpm_interval
指定分派进度监视器 (DPM) 时间间隔(以秒计)。DPM 监视器在此时间间隔对分类元素已进行分类的请求触发 DPM 转储操作。在 dpm_dump_action 属性上指定 DMP 转储操作。
此属性不会覆盖任何服务器属性。必须使用 modify 命令来启用服务器范围 DPM 时间间隔。
- dpm_dump_action
指定在每个 DPM 时间间隔对分类元素进行分类的请求执行的 DPM 转储操作。在 dpm_interval 属性上指定 DPM 时间间隔。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_dpm_dump_action 服务器属性。
- SMF_request_activity_enabled
指定是否为分类元素进行分类的请求收集系统管理设施 (SMF) 120 子类型 9 记录。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_enabled 服务器属性。
- SMF_request_activity_timestamps
指定是否将请求的 SMF 120 子类型 9 记录上的时间戳记格式化为人类可读的格式。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_timestamps 服务器属性。
- SMF_request_activity_security
指定是否为请求收集 SMF 120 子类型 9 记录的安全性数据部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_security 服务器属性。
- SMF_request_activity_CPU_detail
指定是否为请求收集 SMF 120 子类型 9 记录的 CPU 使用情况细目部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_CPU_detail 服务器属性。
- classification_only_trace
指定是否为分类元素进行过分类的请求生成跟踪记录。
有效值为 0(否)和 1(是)。
此属性不会覆盖任何服务器属性。TRACERECORD modify 命令将覆盖 classification_only_trace。
如果任何分类元素将 classification_only_trace 设为 1,那么分类级别跟踪将对应用程序服务器生效。仅生成跟踪记录的那些线程是处理分类元素已进行分类的请求的线程。该分类元素必须定义 classification_only_trace="1"。任何不处理这样的请求的线程均禁用了跟踪收集并且不会生成跟踪记录。
如果没有任何分类元素定义 classification_only_trace="1",那么分类级别跟踪将不对应用程序服务器生效。服务器不会对任何线程禁用跟踪收集。所有跟踪记录将根据跟踪规范的规定写入到输出。
classification_only_trace 属性不影响定义和激活跟踪规范的方式。该属性仅影响哪些线程写跟踪记录。
- message_tag
指定与分类元素已进行分类的请求生成的所有跟踪记录、日志消息和系统消息一起打印的字符串标记。
此属性的最大字符数为 8。
此属性不会覆盖任何服务器属性。
每个 sib_classification_info 元素都可以包含这些属性中的一种或多种属性(对消息的工作进行分类所需的)。sib_classification_info 元素不能包含每种属性的多个实例。
<sib_classification_info transaction_class="e" destination="themoon" description="n" />
<sib_classification_info transaction_class="f" description="n" />
对于到达已调解的目标 themoon 的消息指定的分类为“e”。对于到达另一个已调解的目标的消息指定的分类为“f”。
如果一条消息与外层 SibClassification 元素中的任何 sib_classification_info 元素都不匹配,那么会为该消息指定该 SibClassification 元素中的缺省分类。
如果一条消息与任何 SibClassification 元素中的任何 sib_classification_info 元素都不匹配,或者如果没有定义任何 SibClassification,那么所有工作都将接收到值为“SIBUS”的内置缺省分类。必须执行在使用 TCLASS 值“SIBUS”时所需要的 z/OS 工作负载管理器操作,如对 z/OS 工作负载分类中所述。
WebSphere MQ 消息传递提供程序分类
<WMQRAClassification default_transaction_class="TC99" schema_version="1.0">
<wmqra_classification_info transaction_class="TC_4"
destination="topic://a/b/*"
description="Any topics starting with a/b/ map to TC_4"/>
<wmqra_classification_info transaction_class="TC_3"
selector="JMSPriority>3 AND JMSPriority<8"
destination="queue://QMGR1/Q1"
queue_manager="QMGR1"
description="medium priorities with a queue manager name of QMGR1 and
a queue name of Q1 map to TC_3"
dispatch_timeout="value1"
queue_timeout_percent ="value2"
request_timeout="value3"
stalled_thread_dump_action="traceback"
cputimeused_limit="value5"
cputimeused_dump_action="traceback"
dpm_interval="value7"
dpm_dump_action="traceback"
SMF_request_activity_enabled="1"
SMF_request_activity_timestamps="1"
SMF_request_activity_security="1"
SMF_request_activity_CPU_detail="1"
classification_only_trace="1"
message_tag="value14"/>
- 选择器 (selector)
- 使用 wmqra_classification_info 元素的 selector 属性来根据消息的属性为其指定事务类。对于部署描述符中具有 selector 子句的消息驱动的 Bean,还可以使用此属性为它指定事务类:
- selector 属性的值是一个 SQL 表达式,它根据 message 属性的值来选择消息。语法是 JMS 1.1 规范中消息选择器的语法。
- selector 属性的值必须符合 XML 文档的正确语法。您必须将 < 符号替换为 < 实体引用并将 > 符号替换为 > 实体引用。同样,如果您要使用撇号或引号,那么必须使用 ' 和 " 实体引用。
- destination
- 表示消息已传递至的 WebSphere MQ 目标的 URI。分类适用于由此属性指定的目标,如果未指定此属性,那么分类适用于任何目标。如果该 URI 表示队列类型目标,那么它可以包含队列管理器名称(可选),但是该名称将被忽略且不用于分类。如果该 URI 表示主题类型目标,那么它可以使用通配符。有关 WebSphere MQ 支持的通配符的更多信息,请访问 WebSphere MQ 信息中心。
- queue_manager
- 消息已传递至的 WebSphere MQ 队列管理器的名称。分类适用于由此属性指定的队列管理器,如果未指定此属性,那么分类适用于任何队列管理器。队列管理器名称必须符合 WebSphere MQ 命名约定。
- 请注意,不能将此字段设为 WebSphere MQ 队列共享组的名称。而是必须为队列共享组中的每个队列管理器创建 wmqra_classification_info 元素,或者根据其他项(如目标属性)进行分类。
- description
- 尽管 description 字段是可选的,但是您必须将其用于所有 wmqra_classification_info 元素。
RAS 属性:
您可以指定 wmqra_classification_info 元素上的以下 RAS 属性。嵌套元素将继承父元素的 RAS 属性。嵌套元素可覆盖父元素的 RAS 属性。所有 RAS 属性均是可选的。
- dispatch_timeout
指定控制区域在将请求分派至 WLM 队列后等待的时间量。如果控制区域在指定时间内未接收到响应,那么它将发出超时。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_wlm_dispatch_timeout 服务器属性。
- queue_timeout_percent
将 WLM 队列超时指定为分派超时的百分比。百分比范围是 0 - 99。队列超时是请求在超时之前该请求可在 WLM 队列中保留未分派的时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 control_region_iiop_queue_timeout_percent 服务器属性。
- request_timeout
指定应用到在已分派请求下生成的出站请求的超时值(以秒计)。已分派请求是分类元素已进行过分类的请求。
此属性将覆盖 com.ibm.CORBA.RequestTimeout 服务器属性。
- stalled_thread_dump_action
指定当请求超过在 dispatch_timeout 属性上为其指定的分派超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_iiop_stalled_thread_dump_action 服务器属性。
- cputimeused_limit
指定 CPU 超时(以毫秒计)。CPU 超时是在请求超时之前允许经过的 CPU 时间量。此请求是分类元素已进行过分类的请求。
此属性将覆盖 server_region_request_cputimeused_limit 服务器属性。
- cputimeused_dump_action
指定当请求超过在其 cputimeused_limit 属性上指定的 CPU 超时值时,服务器执行的转储操作。此请求是分类元素已进行过分类的请求。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_cputimeused_dump_action 服务器属性。
- dpm_interval
指定分派进度监视器 (DPM) 时间间隔(以秒计)。DPM 监视器在此时间间隔对分类元素已进行分类的请求触发 DPM 转储操作。在 dpm_dump_action 属性上指定 DMP 转储操作。
此属性不会覆盖任何服务器属性。必须使用 modify 命令来启用服务器范围 DPM 时间间隔。
- dpm_dump_action
指定在每个 DPM 时间间隔对分类元素进行分类的请求执行的 DPM 转储操作。在 dpm_interval 属性上指定 DPM 时间间隔。
有效值为 svcdump、javacore、heapdump、traceback、javatdump 和 none。
此属性将覆盖 server_region_dpm_dump_action 服务器属性。
- SMF_request_activity_enabled
指定是否为分类元素进行分类的请求收集系统管理设施 (SMF) 120 子类型 9 记录。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_enabled 服务器属性。
- SMF_request_activity_timestamps
指定是否将请求的 SMF 120 子类型 9 记录上的时间戳记格式化为人类可读的格式。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_timestamps 服务器属性。
- SMF_request_activity_security
指定是否为请求收集 SMF 120 子类型 9 记录的安全性数据部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_security 服务器属性。
- SMF_request_activity_CPU_detail
指定是否为请求收集 SMF 120 子类型 9 记录的 CPU 使用情况细目部分。这些请求是分类元素已进行过分类的请求。
有效值为 0(否)和 1(是)。
此属性将覆盖 server_SMF_request_activity_CPU_detail 服务器属性。
- classification_only_trace
指定是否为分类元素进行过分类的请求生成跟踪记录。
有效值为 0(否)和 1(是)。
此属性不会覆盖任何服务器属性。TRACERECORD modify 命令将覆盖 classification_only_trace。
如果任何分类元素将 classification_only_trace 设为 1,那么分类级别跟踪将对应用程序服务器生效。仅生成跟踪记录的那些线程是处理分类元素已进行分类的请求的线程。该分类元素必须定义 classification_only_trace="1"。任何不处理这样的请求的线程均禁用了跟踪收集并且不会生成跟踪记录。
如果没有任何分类元素定义 classification_only_trace="1",那么分类级别跟踪将不对应用程序服务器生效。服务器不会对任何线程禁用跟踪收集。所有跟踪记录将根据跟踪规范的规定写入到输出。
classification_only_trace 属性不影响定义和激活跟踪规范的方式。该属性仅影响哪些线程写跟踪记录。
- message_tag
指定与分类元素已进行分类的请求生成的所有跟踪记录、日志消息和系统消息一起打印的字符串标记。
此属性的最大字符数为 8。
此属性不会覆盖任何服务器属性。
每个 wmqra_classification_info 元素都可以包含这些属性中的一种或多种属性(对消息的工作进行分类所需的)。wmqra_classification_info 元素不能包含一个属性的多个实例。
<wmqra_classification_info queue_manager="QMGR1" transaction_class="TC_1" />
<wmqra_classification_info destination="queue:///Q1" transaction_class="TC_2" />
将为到达队列管理器 QMGR1 上目标 Q1 的消息指定分类“TC_1”。而将为从另一队列管理器到达 Q1 的消息指定分类“TC_2”。
如果一条消息与外层 WMQRAClassification 元素中的任何 wmqra_classification_info 元素都不匹配,那么会为该消息指定该 WMQRAClassification 元素中的缺省分类。如果有多个 WMQRAClassification 元素,那么将使用首个 WMQRAClassification 元素的缺省事务类。
如果未定义任何 WMQRAClassification 元素,那么所有工作都将接收到缺省分类“WMQRA”。必须执行在使用 TCLASS 值“WMQRA”时所需要的 z/OS 工作负载管理器操作,如对 z/OS 工作负载分类中所述。
不带 RAS 属性的样本 z/OS 工作负载分类文档:
此样本 z/OS 工作负载分类文档包含用于对 z/OS 工作负载管理器的入站 HTTP、IIOP、会话启动协议 (SIP) 和消息驱动的 Bean (MDB) 工作请求进行分类的属性。此样本不包含 RAS 属性。
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Classification SYSTEM "Classification.dtd" > <Classification schema_version="1.0"> <!-- Internal Classification Rules --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="value1"/> <!-- IIOP Classification Rules --> <InboundClassification type="iiop" schema_version="1.0" default_transaction_class="A0"> <iiop_classification_info transaction_class="A1" application_name="IIOPStatelessSampleApp" module_name="StatelessSample.jar" component_name="Sample20" description="Sample20 EJB Classification"> <iiop_classification_info transaction_class="" method_name="echo" description="No TCLASS for echo()" /> <iiop_classification_info transaction_class="A1B" method_name="ping" description="Ping method" /> </iiop_classification_info> <iiop_classification_info application_name="*" module_name="*" component_name="*" transaction_class="A2" description="TCLASS the rest to A2"> <iiop_classification_info transaction_class="A2A" method_name="resetFilter" description="Sp1 case resetFilter()" /> </iiop_classification_info> </InboundClassification> <!-- HTTP Classification Rules --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="M"> <http_classification_info transaction_class="N" host="yourhost.yourcompany.com" description="Virtual Host yourhost"> <http_classification_info transaction_class="O" port="9080" description="Def yourhost HTTP reqs"> <http_classification_info transaction_class="Q" uri="/gcs/admin" description = "Gcs" /> <http_classification_info transaction_class="S" uri="/gcs/admin/1*" description="GCS login" /> <http_classification_info transaction_class="P" port="9081" description=" Def yourhost HTTPS reqs "/> <http_classification_info transaction_class="" uri="/gcss/mgr/*" description="GCSS Mgr" /> </http_classification_info> </http_classification_info> </InboundClassification> <!-- SIP Classification Rules --> <InboundClassification type="sip" schema_version="1.0" default_transaction_class="value1"/> <!-- MDB Classification Rules --> <InboundClassification type="mdb" schema_version="1.0" default_transaction_class="qrs"> <endpoint type="messagelistenerport" name="IVPListenerPort" defaultclassification="MDBX" description="ABC"> <classificationentry selector="Location='East'" classification="MDB1" description="DEF"/> <classificationentry selector="Location<>'East'" classification="MDB2" description="XYZ" /> </endpoint> <endpoint type="messagelistenerport" name="SimpleMDBListenerPort" defaultclassification="MDBX" description="GHI" /> </InboundClassification> <SibClassification type="jmsra" schema_version="1.0" default_transaction_class="a"> <sib_classification_info transaction_class="b" selector="user.Location='East'" bus="magic" destination="nowhere" description="n" /> <sib_classification_info transaction_class="c" selector="user.Location='West'" bus="omni" description="n" /> </SibClassification> <SibClassification type="destinationmediation" schema_version="1.0" default_transaction_class="b"> <sib_classification_info transaction_class="e" selector="user.Location='East'" destination="themoon" discriminator="sides/dark" description="n" /> <sib_classification_info transaction_class="f" selector="user.Location='West'" description="n" /> </SibClassification> <WMQRAClassification default_transaction_class="TC99" schema_version="1.0"> <wmqra_classification_info transaction_class="TC_1" queue_manager="GOLD" description="gold queue manager maps to TC_1"/> <wmqra_classification_info transaction_class="TC_2" selector="JMSPriority>7" description="high priorities maps to TC_2"/> <wmqra_classification_info transaction_class="TC_3" selector="JMSPriority>3 AND JMSPriority<8" description="medium priorities maps to TC_3"/> </WMQRAClassification> <!-- OLA Classification Rules --> <InboundClassification type="ola" schema_version="1.0" default_transaction_class="A0"> <ola_classification_info transaction_class="FAST1" service_name="ejb/InteractiveTransactionBean" description="EJB classification for quick turnaround"/> <ola_classification_info transaction_class="SLOW1" service_name="ejb/BackgroundBean" description="EJB classification for low priority" /> <ola_classification_info propagate_transaction_name="true" service_name="ejb/CalledFromCICSBean" description="use same service class as client" /> </InboundClassification> <!-- Workload Classification Document for P5SR01x servers Change History _______________________________________________________ Activity Date Author Created 01-28-2005 IPL --> </Classification>
不包含 RAS 属性的样本 z/OS 工作负载分类文档:
此样本 z/OS 工作负载分类文档包含用于对 z/OS 工作负载管理器的入站 HTTP、IIOP 和 MDB 工作请求进行分类的属性。此样本包含 RAS 属性。
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Classification SYSTEM "Classification.dtd" > <Classification schema_version="1.0"> <!-- IIOP 分类规则 --> <InboundClassification type="iiop" schema_version="1.0" default_transaction_class="TC"> <!-- 应用程序“EJBApp1”的 IIOP 分类信息。此分类元素定义一个 “TC1”的 transaction_class。此值将覆盖 InboundClassification 元素(“TC”)的 default_transaction_class。该分类元素还将指定 message_tag,它将应用于归类在此分类元素之下的所有请求。--> <iiop_classification_info application_name="EJBApp1" transaction_class="TC1" message_tag="EJBApp1"> <!-- EJBApp1 包含一个名为“MyEJB.jar”的 jar 模块,该模块具有一个名为“MyEJBClass”的 EJB。 此元素未定义 transaction_class;因此此元素将从其父节点“TC1”继承 transaction_class。此元素还将从其父节点“EJBApp1”继承 message_tag 属性。通常,分类元素会从其所有祖代节点继承所有 RAS 属性,较近的祖代节点(例如,直接父代)比链中较远的祖代节点(例如,祖父代)具有更高的优先权。--> <iiop_classification_info module_name="MyEJB.jar" component_name="MyEJBClass"> <!-- MyEJBClass 包含名为“helloWorld”和“goodbyeWorld”的方法。helloWorld 的 dispatch_timeout 被指定为 30 秒;queue_timeout_percent 被指定为 90,即队列超时值是 dispatch_timeout 值的 90%。此 分类元素还指定 SMF_request_activity_enabled=1,这意味着 将针对以下列方法为目标的所有请求收集 SMF 120 子类型 9 记录: helloWorld 方法。此外,请注意,此分类元素未定义 transaction_class;因此它将从定义了 transaction_class 的最接近祖代元素继承 transaction_class。在这种情况下,定义了 transaction_class 的最接近祖代元素是祖父元素“TC1”。注意:如果没有任何祖代元素定义 transaction_class,那么该分类元素将继承 InboundClassification 元素的 default_transaction_class。InboundClassification 上的 default_transaction_class 是必需的。 此分类元素还将从其祖父元素“EJBApp1”继承 message_tag 属性。--> <iiop_classification_info method_name="helloWorld" dispatch_timeout="30" queue_timeout_percent="90" SMF_request_activity_enabled="1" /> <!-- goodbyeWorld 方法将 dispatch_timeout 指定为 60 秒。此 分类元素还定义了 transaction_class“TC1gbye”,它将覆盖 其祖代定义的 transaction_class。此元素将继承其祖代“EJBApp1”的 message_tag。--> <iiop_classification_info method_name="goodbyeWorld" transaction_class="TC1gbye" dispatch_timeout="60" /> </iiop_classification_info> </iiop_classification_info> <!-- 应用程序“EJBApp2”的 IIOP 分类信息。此分类元素将 dispatch_timeout 定义为 15 秒并定义 “EJBApp2”的 message_tag。此 transaction_class 继承自 InboundClassification“TC”上的 default_transaction_class。归类在此分类元素下的所有请求均具有 15 秒的分派超时,并且由这些请求生成的所有跟踪记录和日志消息均使用 message_tag 属性值“EJBApp2”进行标记。--> <iiop_classification_info application_name="EJBApp2" dispatch_timeout="15" message_tag="EJBApp2"> <!-- EJBApp2 包含两个 jar 模块,即“MyEJB2a.jar”和“MyEJB2b.jar”。以下 两个分类元素为每个 jar 模块定义一个 transaction_class。没有 定义其他属性。两个元素都将继承其祖代节点的这些属性(dispatch_timeout="15" 且 message_tag="EJBApp2")。--> <iiop_classification_info module_name="MyEJB2a.jar" transaction_class="TC2a" /> <iiop_classification_info module_name="MyEJB2b.jar" transaction_class="TC2b" /> </iiop_classification_info> <!-- 以下分类元素为应用程序“EJBApp3”的特定模块、组件和方法定义属性。模块为“MyEJB3.jar”,组件为“MyEJB3Class”,方法为“method3”。将为 EJBApp3 应用程序中的此特定方法定义 transaction_class、dispatch_timeout、queue_timeout_percent、SMF_request_activity_enabled 和 SMF_request_activity_timestamps。不会对此应用程序中的任何其他 EJB 上的任何其他方法指定这些属性。--> <iiop_classification_info application_name="EJBApp3" module_name="MyEJB3.jar" component_name="MyEJB3Class" method_name="method3" transaction_class="TC3" dispatch_timeout="40" queue_timeout_percent="90" SMF_request_activity_enabled="1" SMF_request_activity_timestamps="1" /> </InboundClassification> <!-- Internal 分类规则 --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="internal" /> <!-- HTTP 分类规则 --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="HTC"> <!-- 以下分类元素为主机“my.server.com”和端口“8080”上接收到的所有 HTTP 请求定义 transaction_class“HTC8080”。此 分类元素还定义了 RAS 属性 dispatch_timeout、 queue_timeout_percent、timeout_recovery 和 stalled_thread_dump_action。此元素下的 所有子元素继承这些 RAS 属性。--> <http_classification_info host="my.server.com" port="8080" transaction_class="HTC8080" dispatch_timeout="100" queue_timeout_percent="98" timeout_recovery="session" stalled_thread_dump_action="javacore"> <!-- 以下分类元素适用于带有以“/PlantsByWebSphere/”开头的 URI 的所有 HTTP 请求。在主机 my.server.com 和端口 8080 上接收到的带有以 /PlantsByWebSphere 开头的 URI 的每个 HTTP 请求,将归入此分类(注意:主机和端口继承自父元素)。此分类元素还会定义 message_tag 属性“plantsbw”,该 message_tag 属性会被添加至任何 /PlantsByWebSphere/* 请求所生成的每条跟踪记录和日志消息。--> <http_classification_info uri="/PlantsByWebSphere/*" message_tag="plantsbw"> <!-- 以下分类元素适用于带有匹配 "/PlantsByWebSphere/*.jpg 的 URI(例如,/PlantsByWebSphere/mypic.jpg 和 /PlantsByWebSphere/some/path/anotherpic.jpg)的所有 HTTP 请求。另外,此过滤器仅适用于在主机 my.server.com 和端口 8080(由一个祖代节点指定)上接收到的请求。此分类元素会将 transaction_class 定义为“HTCPjpg”并将 dispatch_timeout 定义为“10”。它将从其祖代节点继承其他属性。--> <http_classification_info uri="*.jpg" transaction_class="HTCPjpg" dispatch_timeout="10" /> <!-- 以下分类元素适用于带有匹配 "/PlantsByWebSphere/*.html 的 URI(例如,/PlantsByWebSphere/index.html 和 /PlantsByWebSphere/some/path/afile.html)的所有 HTTP 请求。--> <http_classification_info uri="*.html" transaction_class="HTChtml" /> </http_classification_info> </http_classification_info> <!-- 以下分类元素为在端口“80”上接收到的所有 HTTP 请求定义 transaction_class“HTC80”。未定义主机属性;因此,此元素可匹配任何主机。--> <http_classification_info port="80" transaction_class="HTC80" dispatch_timeout="60" timeout_recovery="servant" message_tag="vanilla" /> </InboundClassification> <!-- MDB 分类规则 --> <InboundClassification type="mdb" schema_version="1.0" default_transaction_class="mdbdflt"> <!-- LP 1414、skLP1 以及 MDB 计划“A”测试的端点 --> <endpoint type="messagelistenerport" name="skLP1" defaultclassification="lp1dft" description="Endpoint for LP 1414, skLP1, for MDB Plan 'A' Test"> <classificationentry selector="JMSCorrelationID='TestCase1'" classification="lp1s1" description="New MDB Sample, TestCase1" cputimeused_limit="200101" request_timeout="20" dispatch_timeout="30" dpm_interval="0" queue_timeout_percent="20" stalled_thread_dump_action="traceback" /> </endpoint> </InboundClassification> <!-- SIB 分类规则 --> <SibClassification type="jmsra" schema_version="1.0" default_transaction_class="Dclass"> <sib_classification_info transaction_class="Tclass" bus="testbus" destination="themoon" description="test1" dispatch_timeout="30" queue_timeout_percent="20" request_timeout="20" stalled_thread_dump_action="traceback" cputimeused_limit="200101" cputimeused_dump_action="traceback" dpm_interval="0" dpm_dump_action="traceback" classification_only_trace="1" message_tag="sibreqst" /> </SibClassification> </Classification>
DTD:
以下 DTD 定义在以上样本工作负载分类文档中使用的元素和属性。
<?xml version='1.0' encoding="UTF-8"?> <!ELEMENT Classification (InboundClassification|SibClassification|WMQRAClassification)+> <!ATTLIST Classification schema_version CDATA #REQUIRED> <!ELEMENT InboundClassification ((iiop_classification_info*|http_classification_info*|endpoint*|ola_classification_info*))> <!ATTLIST InboundClassification type (iiop|mdb|http|internal|sip|ola) #REQUIRED> <!ATTLIST InboundClassification default_transaction_class CDATA #REQUIRED> <!ATTLIST InboundClassification schema_version CDATA #REQUIRED> <!ATTLIST InboundClassification default_iiop_application_name CDATA #IMPLIED> <!ATTLIST InboundClassification default_iiop_module_name CDATA #IMPLIED> <!ATTLIST InboundClassification default_iiop_component_name CDATA #IMPLIED> <!ELEMENT iiop_classification_info (iiop_classification_info*)> <!-- 输入 --> <!ATTLIST iiop_classification_info activity_workload_classification CDATA #IMPLIED> <!ATTLIST iiop_classification_info application_name CDATA #IMPLIED> <!ATTLIST iiop_classification_info component_name CDATA #IMPLIED> <!ATTLIST iiop_classification_info description CDATA #IMPLIED> <!ATTLIST iiop_classification_info method_name CDATA #IMPLIED> <!ATTLIST iiop_classification_info module_name CDATA #IMPLIED> <!-- 输出 --> <!ATTLIST iiop_classification_info transaction_class CDATA #IMPLIED> <!ATTLIST iiop_classification_info dispatch_timeout CDATA #IMPLIED> <!-- control_region_wlm_dispatch_timeout --> <!ATTLIST iiop_classification_info queue_timeout_percent CDATA #IMPLIED> <!-- control_region_iiop_queue_timeout_percent --> <!ATTLIST iiop_classification_info request_timeout CDATA #IMPLIED> <!-- com.ibm.CORBA.RequestTimeout --> <!ATTLIST iiop_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_iiop_stalled_thread_dump_action --> <!ATTLIST iiop_classification_info cputimeused_limit CDATA #IMPLIED> <!-- server_region_request_cputimeused_limit --> <!ATTLIST iiop_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_cputimeused_dump_action --> <!ATTLIST iiop_classification_info dpm_interval CDATA #IMPLIED> <!-- MODIFY [JOBNAME],DPM,IIOP= --> <!ATTLIST iiop_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_dpm_dump_action --> <!ATTLIST iiop_classification_info SMF_request_activity_enabled (0|1) #IMPLIED> <!-- server_SMF_request_activity_enabled --> <!ATTLIST iiop_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED> <!-- server_SMF_request_activity_timestamps --> <!ATTLIST iiop_classification_info SMF_request_activity_security (0|1) #IMPLIED> <!-- server_SMF_request_activity_security --> <!ATTLIST iiop_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED> <!-- server_SMF_request_activity_CPU_detail --> <!ATTLIST iiop_classification_info classification_only_trace (0|1) #IMPLIED> <!ATTLIST iiop_classification_info message_tag CDATA #IMPLIED> <!ELEMENT endpoint (classificationentry*)> <!ATTLIST endpoint defaultclassification CDATA #REQUIRED> <!ATTLIST endpoint name CDATA #REQUIRED> <!ATTLIST endpoint type (messagelistenerport) #REQUIRED> <!ATTLIST endpoint description CDATA #IMPLIED> <!ELEMENT classificationentry EMPTY> <!-- 输入 --> <!ATTLIST classificationentry selector CDATA #REQUIRED> <!ATTLIST classificationentry description CDATA #IMPLIED> <!-- 输出 --> <!ATTLIST classificationentry classification CDATA #REQUIRED> <!ATTLIST classificationentry dispatch_timeout CDATA #IMPLIED> <!-- control_region_mdb_request_timeout --> <!ATTLIST classificationentry queue_timeout_percent CDATA #IMPLIED> <!-- control_region_mdb_queue_timeout_percent --> <!ATTLIST classificationentry request_timeout CDATA #IMPLIED> <!-- com.ibm.CORBA.RequestTimeout --> <!ATTLIST classificationentry stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_mdb_stalled_thread_dump_action --> <!ATTLIST classificationentry cputimeused_limit CDATA #IMPLIED> <!-- server_region_request_cputimeused_limit --> <!ATTLIST classificationentry cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_cputimeused_dump_action --> <!ATTLIST classificationentry dpm_interval CDATA #IMPLIED> <!-- MODIFY [JOBNAME],DPM,IIOP= --> <!ATTLIST classificationentry dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_dpm_dump_action --> <!ATTLIST classificationentry SMF_request_activity_enabled (0|1) #IMPLIED> <!-- server_SMF_request_activity_enabled --> <!ATTLIST classificationentry SMF_request_activity_timestamps (0|1) #IMPLIED> <!-- server_SMF_request_activity_timestamps --> <!ATTLIST classificationentry SMF_request_activity_security (0|1) #IMPLIED> <!-- server_SMF_request_activity_security --> <!ATTLIST classificationentry SMF_request_activity_CPU_detail (0|1) #IMPLIED> <!-- server_SMF_request_activity_CPU_detail --> <!ATTLIST classificationentry classification_only_trace (0|1) #IMPLIED> <!ATTLIST classificationentry message_tag CDATA #IMPLIED> <!ELEMENT http_classification_info (http_classification_info*)> <!-- 输入 --> <!ATTLIST http_classification_info host CDATA #IMPLIED> <!ATTLIST http_classification_info port CDATA #IMPLIED> <!ATTLIST http_classification_info uri CDATA #IMPLIED> <!ATTLIST http_classification_info description CDATA #IMPLIED> <!ATTLIST http_classification_info transaction_class CDATA #IMPLIED> <!-- 输出 --> <!ATTLIST http_classification_info dispatch_timeout CDATA #IMPLIED> <!-- protocol_http_timeout_output --> <!ATTLIST http_classification_info queue_timeout_percent CDATA #IMPLIED> <!-- control_region_http_queue_timeout_percent --> <!ATTLIST http_classification_info request_timeout CDATA #IMPLIED> <!-- com.ibm.CORBA.RequestTimeout --> <!ATTLIST http_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_http_stalled_thread_dump_action --> <!ATTLIST http_classification_info cputimeused_limit CDATA #IMPLIED> <!-- server_region_request_cputimeused_limit --> <!ATTLIST http_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_cputimeused_dump_action --> <!ATTLIST http_classification_info dpm_interval CDATA #IMPLIED> <!-- MODIFY [JOBNAME],DPM,HTTP= --> <!ATTLIST http_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_dpm_dump_action --> <!ATTLIST http_classification_info SMF_request_activity_enabled (0|1) #IMPLIED> <!-- server_SMF_request_activity_enabled --> <!ATTLIST http_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED> <!-- server_SMF_request_activity_timestamps --> <!ATTLIST http_classification_info SMF_request_activity_security (0|1) #IMPLIED> <!-- server_SMF_request_activity_security --> <!ATTLIST http_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED> <!-- server_SMF_request_activity_CPU_detail --> <!ATTLIST http_classification_info classification_only_trace (0|1) #IMPLIED> <!ATTLIST http_classification_info message_tag CDATA #IMPLIED> <!ATTLIST http_classification_info timeout_recovery (servant|session) #IMPLIED> <!-- protocol_http_timeout_output_recovery --> <!ELEMENT ola_classification_info (ola_classification_info*)> <!ATTLIST ola_classification_info transaction_class CDATA #IMPLIED> <!ATTLIST ola_classification_info propagate_transaction_name (true|false) #IMPLIED> <!ATTLIST ola_classification_info service_name CDATA #IMPLIED> <!ATTLIST ola_classification_info description CDATA #IMPLIED> <!ATTLIST ola_classification_info dispatch_timeout CDATA #IMPLIED> <!-- control_region_wlm_dispatch_timeout --> <!ATTLIST ola_classification_info queue_timeout_percent CDATA #IMPLIED> <!-- control_region_iiop_queue_timeout_percent --> <!ATTLIST ola_classification_info request_timeout CDATA #IMPLIED> <!-- com.ibm.CORBA.RequestTimeout --> <!ATTLIST ola_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_iiop_stalled_thread_dump_action --> <!ATTLIST ola_classification_info cputimeused_limit CDATA #IMPLIED> <!-- server_region_request_cputimeused_limit --> <!ATTLIST ola_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_cputimeused_dump_action --> <!ATTLIST ola_classification_info dpm_interval CDATA #IMPLIED> <!-- MODIFY [JOBNAME],DPM,IIOP= --> <!ATTLIST ola_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_dpm_dump_action --> <!ATTLIST ola_classification_info SMF_request_activity_enabled (0|1) #IMPLIED> <!-- server_SMF_request_activity_enabled --> <!ATTLIST ola_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED> <!-- server_SMF_request_activity_timestamps --> <!ATTLIST ola_classification_info SMF_request_activity_security (0|1) #IMPLIED> <!-- server_SMF_request_activity_security --> <!ATTLIST ola_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED> <!-- server_SMF_request_activity_CPU_detail --> <!ATTLIST ola_classification_info classification_only_trace (0|1) #IMPLIED> <!ATTLIST ola_classification_info message_tag CDATA #IMPLIED> <!ELEMENT SibClassification (sib_classification_info+)> <!ATTLIST SibClassification type (jmsra|destinationmediation) #REQUIRED> <!ATTLIST SibClassification default_transaction_class CDATA #REQUIRED> <!ATTLIST SibClassification schema_version CDATA #REQUIRED> <!ELEMENT sib_classification_info EMPTY> <!-- 输入 --> <!ATTLIST sib_classification_info selector CDATA #IMPLIED> <!ATTLIST sib_classification_info bus CDATA #IMPLIED> <!ATTLIST sib_classification_info destination CDATA #IMPLIED> <!ATTLIST sib_classification_info discriminator CDATA #IMPLIED> <!ATTLIST sib_classification_info description CDATA #IMPLIED> <!-- 输出 --> <!ATTLIST sib_classification_info transaction_class CDATA #REQUIRED> <!ATTLIST sib_classification_info dispatch_timeout CDATA #IMPLIED> <!-- control_region_wlm_dispatch_timeout --> <!ATTLIST sib_classification_info queue_timeout_percent CDATA #IMPLIED> <!-- control_region_iiop_queue_timeout_percent --> <!ATTLIST sib_classification_info request_timeout CDATA #IMPLIED> <!-- com.ibm.CORBA.RequestTimeout --> <!ATTLIST sib_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_iiop_stalled_thread_dump_action --> <!ATTLIST sib_classification_info cputimeused_limit CDATA #IMPLIED> <!-- server_region_request_cputimeused_limit --> <!ATTLIST sib_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_cputimeused_dump_action --> <!ATTLIST sib_classification_info dpm_interval CDATA #IMPLIED> <!-- MODIFY [JOBNAME],DPM,IIOP= --> <!ATTLIST sib_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_dpm_dump_action --> <!ATTLIST sib_classification_info SMF_request_activity_enabled (0|1) #IMPLIED> <!-- server_SMF_request_activity_enabled --> <!ATTLIST sib_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED> <!-- server_SMF_request_activity_timestamps --> <!ATTLIST sib_classification_info SMF_request_activity_security (0|1) #IMPLIED> <!-- server_SMF_request_activity_security --> <!ATTLIST sib_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED> <!-- server_SMF_request_activity_CPU_detail --> <!ATTLIST sib_classification_info classification_only_trace (0|1) #IMPLIED> <!ATTLIST sib_classification_info message_tag CDATA #IMPLIED> <!ELEMENT WMQRAClassification (wmqra_classification_info+)> <!ATTLIST WMQRAClassification default_transaction_class CDATA #REQUIRED> <!ATTLIST WMQRAClassification schema_version CDATA #REQUIRED> <!ELEMENT wmqra_classification_info EMPTY> <!-- 输入 --> <!ATTLIST wmqra_classification_info selector CDATA #IMPLIED> <!ATTLIST wmqra_classification_info queue_manager CDATA #IMPLIED> <!ATTLIST wmqra_classification_info destination CDATA #IMPLIED> <!ATTLIST wmqra_classification_info description CDATA #IMPLIED> <!-- 输出 --> <!ATTLIST wmqra_classification_info transaction_class CDATA #REQUIRED> <!ATTLIST wmqra_classification_info dispatch_timeout CDATA #IMPLIED> <!-- control_region_wlm_dispatch_timeout --> <!ATTLIST wmqra_classification_info queue_timeout_percent CDATA #IMPLIED> <!-- control_region_iiop_queue_timeout_percent --> <!ATTLIST wmqra_classification_info request_timeout CDATA #IMPLIED> <!-- com.ibm.CORBA.RequestTimeout --> <!ATTLIST wmqra_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_iiop_stalled_thread_dump_action --> <!ATTLIST wmqra_classification_info cputimeused_limit CDATA #IMPLIED> <!-- server_region_request_cputimeused_limit --> <!ATTLIST wmqra_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_cputimeused_dump_action --> <!ATTLIST wmqra_classification_info dpm_interval CDATA #IMPLIED> <!-- MODIFY [JOBNAME],DPM,IIOP= --> <!ATTLIST wmqra_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED> <!-- server_region_dpm_dump_action --> <!ATTLIST wmqra_classification_info SMF_request_activity_enabled (0|1) #IMPLIED> <!-- server_SMF_request_activity_enabled --> <!ATTLIST wmqra_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED> <!-- server_SMF_request_activity_timestamps --> <!ATTLIST wmqra_classification_info SMF_request_activity_security (0|1) #IMPLIED> <!-- server_SMF_request_activity_security --> <!ATTLIST wmqra_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED> <!-- server_SMF_request_activity_CPU_detail --> <!ATTLIST wmqra_classification_info classification_only_trace (0|1) #IMPLIED> <!ATTLIST wmqra_classification_info message_tag CDATA #IMPLIED>
HTTP 入站请求的分类示例:
将以下 HTTP 请求用于先前描述的包含 RAS 属性的样本 z/OS 工作负载分类文档:
http://my.server.com:8080/PlantsByWebSphere/plants/newOrder.html
因为此请求为 HTTP 请求,应用程序服务器将仅扫描 http_classification_info 元素。应用程序服务器按照这些元素在工作负载分类文件中出现的顺序对他们进行扫描。
<http_classification_info
host="my.server.com"
port="8080"
transaction_class="HTC8080"
dispatch_timeout="100"
queue_timeout_percent="98"
timeout_recovery="session"
stalled_thread_dump_action="javacore">
此元素具有 host="my.server.com" 和 port="8080" 的输入属性和值。因为这些属性匹配入站 HTTP 请求,所以应用程序服务器将降至此元素并比较子节点。应用程序服务器将找到以下子元素: <http_classification_info
uri="/PlantsByWebSphere/*"
message_tag="plantsbw">
此子元素定义了 uri="/PlantsByWebSphere/*" 的输入属性和值,该 URI 与入站请求 URI 的 URI 匹配。然后应用程序服务器将扫描该元素的子元素。应用程序服务器将找到第一个子元素: <http_classification_info
uri="*.jpg"
transaction_class="HTCPjpg"
dispatch_timeout="10"
/>
此子元素包含 uri="*.jpg" 属性和值。因为此属性/值对不匹配输入 URI,所以应用程序服务器将移至下一个子元素。应用程序服务器将发现第二个子元素:<http_classification_info
uri="*.html"
transaction_class="HTChtml"
/>
此子元素包含 uri="*.html" 属性和值,该 URI 与输入 URI 匹配。dispatch_timeout="100"
queue_timeout_percent="98"
timeout_recovery="session"
stalled_thread_dump_action="javacore"
message_tag="plantsbw"
transaction_class="HTChtml"
应用程序服务器将从服务器范围配置读取任何未在工作负载分类文件中定义的 RAS 属性并将他们指定给请求。以下列表中列示了相关的服务器范围配置属性(包括分类数据覆盖的配置属性): protocol_http_timeout_output -- overridden by dispatch_timeout
control_region_http_queue_timeout_percent -- overridden by queue_timeout_percent
com.ibm.CORBA.RequestTimeout
server_region_http_stalled_thread_dump_action -- overridden by stalled_thread_dump_action
server_region_request_cputimeused_limit
server_region_cputimeused_dump_action
server_region_dpm_dump_action
server_SMF_request_activity_enabled
server_SMF_request_activity_timestamps
server_SMF_request_activity_CPU_detail
protocol_http_timeout_output_recovery -- overridden by timeout_recovery
对于分类数据未覆盖的任何服务器范围配置属性,该请求将继承该服务器范围属性值。IIOP 入站请求的分类示例:
将以下 IIOP 请求用于前述包含 RAS 属性的样本 z/OS 工作负载分类文档:
应用程序 EJBApp2 中模块 MyEJB2b.jar 中的 MyEJB2bBean.someMethod() 的 IIOP 入站请求。
<iiop_classification_info
application_name="EJBApp1"
transaction_class="TC1"
message_tag="EJBApp1">
此元素具有 application_name="EJBApp1" 的输入属性和值。application_name 属性上 EJBApp1 的应用程序名称不匹配入站请求中的 EJBApp2 的应用程序名称。因此,应用程序服务器将跳过此分类元素及其所有子元素并移至下一个元素。应用程序服务器将发现下一个元素: <iiop_classification_info
application_name="EJBApp2"
dispatch_timeout="15"
message_tag="EJBApp2">
此元素具有 application_name="EJBApp2" 的输入属性和值。由于此属性/值对匹配入站请求的应用程序名称,所以扫描程序将降至此元素。应用程序服务器将找到第一个子元素:<iiop_classification_info
module_name="MyEJB2a.jar"
transaction_class="TC2a"
/>
此元素包含 module_name="MyEJB2b.jar" 的输入属性和值。由于此属性/值对不匹配入站请求的 MyEJB2b.jar 模块名称,所以应用程序服务器将扫描下一个子元素: <iiop_classification_info
module_name="MyEJB2b.jar"
transaction_class="TC2b"
/>
此元素包含 module_name="MyEJB2b.jar" 的属性和值。module_name 属性上 MyEJB2b.jar 的模块名称匹配入站请求的模块名称。由于不存在更多子元素,应用程序服务器将对此元素的请求进行分类。该请求将继承此元素和所有祖代元素的所有输出属性。以下属性/值对是应用程序服务器对请求指定的输出属性/值对的完整列表: dispatch_timeout="15"
message_tag="EJBApp2"
transaction_class="TC2b"
应用程序服务器将从服务器范围配置读取任何未在工作负载分类文件中定义的 RAS 属性并将他们指定给请求。以下列表中列示了相关的服务器范围配置属性(包括分类数据覆盖的配置属性): control_region_wlm_dispatch_timeout -- overridden by dispatch_timeout
control_region_iiop_queue_timeout_percent
com.ibm.CORBA.RequestTimeout
server_region_iiop_stalled_thread_dump_action
server_region_request_cputimeused_limit
server_region_cputimeused_dump_action
server_region_dpm_dump_action
server_SMF_request_activity_enabled
server_SMF_request_activity_timestamps
server_SMF_request_activity_CPU_detail
对于分类数据未覆盖的任何服务器范围配置属性,该请求将继承该服务器范围属性值。