![[z/OS]](../images/ngzos.gif)
工作量分類檔
工作量分類文件是對 z/OS® 工作量管理程式的入埠 HTTP、IIOP、訊息驅動 Bean (MDB)、階段作業起始通訊協定 (SIP)、最佳化本端配接器及調解工作進行分類的一般 XML 檔。
使用注意事項
這個主題包含具備及不具備「可靠性、可用性和可服務性 (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 屬性是必要的。 1.0 是唯一受支援的 schema_version。 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 元素。
- 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 元素。
- WMQRAClassification
- <WMQRAClassification schema_version=”1.0”
default_transaction_class=”value”>下列規則適用於 WMQRAClassification 元素:
- schema_version 屬性是必要的。 值必須設為 1.0。
- 必須指定 default_transaction_class 屬性,它定義指定類型之工作流程的預設交易類別。 字串值必須是有效的 WLM 交易類別。
- WMQRAClassification 元素不能是巢狀結構。 每個 WMQRAClassification 元素都必須結束,才能開始任何其他 Classification 元素。
對不同類型的工作進行分類的規則和 XML 陳述式都相似,但每個類型的語法還是稍微有所不同。 如需各工作類型語法的相關資訊,請參閱下列各章節:- InboundClassification
- SibClassification
- WMQRAClassification
內部分類
具有 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">
- 應用程式名稱
包含 Enterprise Bean 的應用程式名稱。 它是應用程式的顯示名稱,有可能不是包含所有構件的 .ear 檔的名稱。
- 模組名稱
包含一或多個 Enterprise Bean 的 Enterprise JavaBeans(EJB) .jar 檔的名稱。 .ear 檔可以包含多個 EJB .jar 檔。
- 元件名稱
包含在模組(或 EJB .jar 檔)中的 EJB 的名稱。 .jar 檔可以包含一或多個 Enterprise 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 Enterprise 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 應用程式中的 Enterprise Bean 處理的所有 IIOP 要求都指派了 TCLASS 值 SLOW。 對 MySSB 企業的任何要求也都會進行這項指派。 即使向 MySSB 指派了交易類別,也不會套用這個過濾器,因為已套用了第一個過濾器,且它指派了 TCLASS 值 SLOW。 系統不會處理相同層次的其餘過濾器清單。
- description 欄位是選用的。 不過,您應該對所有 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。 控制器位址空間會向用戶端傳送失敗回應,然後關閉與要求相關聯的 Socket。
當這個屬性設為 session 時, 控制器位址空間會向用戶端傳送失敗回應,然後關閉與要求相關聯的 Socket。 「服務者位址空間」不會終止。 要求不會中斷,相反地,會允許其執行完成。
這個屬性會置換下列伺服器內容:- HTTP
- protocol_http_timeout_output_recovery
- HTTPS
- protocol_https_timeout_output_recovery
Classification 過濾器:
- 您可以按階層方式來建立 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>
在代管虛擬主機 MyVHost1.com 之 Web 應用程式的應用程式伺服器中,由環境定義根目錄 /MyWebApp1 和 /MyWebApp2 來識別的 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
- 請利用 classificationentry 元素的 selector 屬性,將交易類別指派給其部署描述子含有 selector 子句的訊息驅動 Bean。 當定義 classificationentry 元素時,請使用下列規則:
- selector 屬性的值必須完全符合 MDB 部署描述子中的 selector 子句。
- selector 屬性的值必須符合 XML 文件的正確語法。 您必須將 < 符號取代為 < 實體參照,將 > 符號取代為 > 實體參照。 同樣地,如果您使用省略符號或引號,請使用 ' 和 " 實體參照。
- classification
classification 屬性是選用的。 如果未定義這個屬性,它會繼承其母項的分類。 這個字串值必須是有效的 WLM 交易類別、空字串(例如,""),或是包含不超出八個空格的字串(如 " ")。 通過指定空值或空字串,您可以置換預設的 TCLASS 設定,或更高層次的過濾器所指派的 TCLASS 設定。 指定空值或空字串代表要求沒有 TCLASS 值。
RAS 屬性:
您可以對 classificationentry 元素指定下列 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 名稱可以使用萬用字元。
請利用 ola_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 個字元。
這個屬性不會置換任何伺服器內容。
Classification 過濾器:- 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>
- description 欄位是選用的。 不過,請對所有 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
- 請利用 sib_classification_info 元素的 selector 屬性,將交易類別指派給其部署描述子含有 selector 子句的訊息驅動 Bean。
當定義 sib_classification_info 元素時,請使用下列規則:
- selector 屬性的值是一個 SQL 表示式,根據訊息內容值來選取訊息。 其語法是 JMS 1.1 規格中訊息選取器的語法,但它可以操作 SIMessage 訊息(多於 JMS 訊息)。 這個語法可以在系統內容(包括 JMS 標頭、JMSX 內容和 JMS_IBM_properties)上,以及在使用者內容(字首必須是 ".user",比方說,對於使用者內容 "Location",selector 會指定 "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" 的內建預設分類。 您必須依照Classifying z/OS workload所說明,執行使用 TCLASS 值 "SIBUS" 所需要的「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
- 請利用 sib_classification_info 元素的 selector 屬性,將交易類別指派給其部署描述子含有 selector 子句的調解。
當定義 sib_classification_info 元素時,請使用下列規則:
- selector 屬性的值是一個 SQL 表示式,根據訊息內容值來選取訊息。
其語法是 JMS 1.1 規格中訊息選取器的語法,但它可以操作 SIMessage 訊息(多於 JMS 訊息)。
這個語法可以在系統內容(包括 JMS 標頭、JMSX 內容和 JMS_IBM_properties)上,以及在使用者內容(字首必須是 ".user",比方說,對於使用者內容 "Location",selector 會指定 "user.Location",如前述範例所示)上進行選取。
如需相關資訊,請參閱使用訊息內容的相關主題。
- selector 屬性的值必須符合 XML 文件的正確語法。 您必須將 < 符號取代為 < 實體參照,將 > 符號取代為 > 實體參照。 同樣地,如果您使用省略符號或引號,請使用 ' 和 " 實體參照。
- selector 屬性的值是一個 SQL 表示式,根據訊息內容值來選取訊息。
其語法是 JMS 1.1 規格中訊息選取器的語法,但它可以操作 SIMessage 訊息(多於 JMS 訊息)。
這個語法可以在系統內容(包括 JMS 標頭、JMSX 內容和 JMS_IBM_properties)上,以及在使用者內容(字首必須是 ".user",比方說,對於使用者內容 "Location",selector 會指定 "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" 的內建預設分類。 您必須依照Classifying z/OS workload所說明,執行使用 TCLASS 值 "SIBUS" 所需要的「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 表示式,根據訊息內容值來選取訊息。 其語法是 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 元素,或另尋其他根據(如 destination 屬性)來進行分類。
- 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"。 您必須依照Classifying z/OS workload所說明,執行使用 TCLASS 值 "WMQRA" 所需要的「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"> <!-- 內部分類規則 --> <InboundClassification type="internal" schema_version="1.0" default_transaction_class="value1"/> <!-- IIOP 分類規則 --> <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 分類規則 --> <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 分類規則 --> <InboundClassification type="sip" schema_version="1.0" default_transaction_class="value1"/> <!-- MDB 分類規則 --> <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 分類規則 --> <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> <!-- P5SR01x 伺服器工作量分類文件 變更歷程 _______________________________________________________ 已建立 日期 作者 活動 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 分類資訊。這個分類元素定義 transaction_class 為 "TC1"。這個值會置換 InboundClassification 元素的 default_transaction_class ("TC")。此外,這個分類元素還 指定一個 message_tag,適用於 在這個分類元素之下進行分類的所有要求。--> <iiop_classification_info application_name="EJBApp1" transaction_class="TC1" message_tag="EJBApp1"> <!-- EJBApp1 包含一個名稱為 "MyEJB.jar" 的 jar 模組,它有一個名稱為 "MyEJBClass" 的 EJB。 這個元素未定義 transaction_class;因此,這個元素 繼承其母節點的 transaction_class,"TC1"。此外,這個元素還 繼承其母節點的 message_tag 屬性,"EJBApp1"。一般而言, 分類元素會繼承其所有上代節點的所有 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,表示 對於所有以 helloWorld 方法為目標的要求,會收集其 SMF 120 子類型 9 記錄。另外也請注意,這個分類元素未 定義 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 秒,message_tag 為 "EJBApp2"。此 transaction_class 繼承自 InboundClassification 上的 default_transaction_class,"TC"。在這個分類元素之下進行分類的 所有要求都有 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"。transaction_class、 dispatch_timeout、queue_timeout_percent、SMF_request_activity_enabled 和 SMF_request_activity_timestamps 全部是針對 EJBApp3 應用程式中的這個 特定方法而定義。這些屬性未指派給這個應用程式內的任何其他方法 或任何其他 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> <!-- 內部分類規則 --> <InboundClassification type="internal" schema_version="1.0" default_transaction_class="internal" /> <!-- HTTP 分類規則 --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="HTC"> <!-- 下列分類元素將 transaction_class "HTC8080" 定義給 在 "my.server.com" 主機和 "8080" 埠上接收的所有 HTTP 要求。此 分類元素還定義了 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"> <!-- 下列分類元素適用於 URI 開頭為 "/PlantsByWebSphere/" 的所有 HTTP 要求。在 my.server.com 主機和 8080 埠上, 以開頭為 /PlantsByWebSphere 的 URI 收到的每個 HTTP 要求都是屬於這個分類(附註:主機和埠從母元素繼承 而來)。另外,這個分類元素還定義了 message_tag 屬性 "plantsbw",這個屬性會新增到任何 /PlantsByWebSphere/* 要求所產生的每個追蹤記錄和日誌訊息中。 --> <http_classification_info uri="/PlantsByWebSphere/*" message_tag="plantsbw"> <!-- 下列分類元素適用於 URI 符合 "/PlantsByWebSphere/*.jpg(例如, /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" /> <!-- 下列分類元素適用於 URI 符合 "/PlantsByWebSphere/*.jpg(例如, /PlantsByWebSphere/index.html、/PlantsByWebSphere/some/path/afile.htm) 的所有 HTTP 要求。 --> <http_classification_info uri="*.html" transaction_class="HTChtml" /> </http_classification_info> </http_classification_info> <!-- 下列分類元素將 transaction_class "HTC80" 定義給 在 "80" 埠上接收的所有 HTTP 要求。未定義 host 屬性; 因此,這個元素會符合任何主機。 --> <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。
之後,應用程式伺服器便掃描這個元素的子項。
應用程式伺服器會尋找第一個子元素: <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 符合。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="MyEJB2a.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
對於分類資料未置換的任何伺服器層面配置內容,要求會繼承伺服器層面的內容值。