![[z/OS]](../images/ngzos.gif)
Archivo de clasificación de carga de trabajo
El documento de clasificación de cargas de trabajo es un archivo XML común que clasifica el trabajo de entrada HTTP, IIOP, MDB (beans controlados por mensajes), SIP (protocolo de iniciación de sesiones), (SIP), de adaptador local optimizado y de mediación, para el gestor de carga de trabajo de z/OS.
Notas de uso
Este tema contiene ejemplos del archivo de clasificación de cargas de trabajo con y sin atributos RAS (Reliability Availability and Serviceability). Los atributos RAS le permiten conseguir granularidad RAS a nivel de solicitud para solicitudes HTTP, solicitudes IIOP, solicitudes MDB y solicitudes de adaptador local optimizadas. Estos atributos se especifican en el elemento http_classification_info, el elemento iiop_classification_info, el elemento classificationentry, el elemento sib_classification_info, el elemento wmqra_classification_info y el elemento ola_classification_info en el archivo de clasificación de cargas de trabajo.
El archivo de clasificación de cargas de trabajo se utiliza cuando completa las tareas de clasificación de cargas de trabajo de z/OS o de habilitación de granularidad RAS a nivel de solicitud.
Elementos necesarios
- <?xml version="1.0" encoding="UTF-8"?>
- Indica que el documento de clasificación de cargas de trabajo debe guardarse en ASCII para que lo pueda procesar el servidor de aplicaciones. Esta sentencia es obligatoria.
- <!DOCTYPE Classification SYSTEM "Classifications.dtd">
- Facilita al analizador XML el nombre del documento DTD proporcionado por el producto, y se utiliza para validar el documento de clasificación de cargas de trabajo. El documento de clasificación de cargas de trabajo que escriba debe seguir las normas que se describen en este DTD. Debe añadir esta sentencia al documento de clasificación de cargas de trabajo.
- Classification
- <Classification schema_version="1.0">
Indica el directorio raíz del documento de clasificación de cargas de trabajo. Todos los documentos de clasificación de cargas de trabajo deben empezar y terminar con este elemento. El atributo schema_version es necesario. El único schema_version soportado es 1.0. El elemento Classification contiene uno o más elementos InboundClassification. Para el trabajo de integración de servicios de entrada, el elemento Classification también puede contener hasta dos elementos SibClassification. Si se están clasificando mensajes de entrada para entregarlos a beans controlados por mensajes utilizando las especificaciones de activación del proveedor de mensajería WebSphere MQ, el elemento Clasificación puede contener uno o varios elementos 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>
Siga las siguientes reglas cuando utilice el elemento InboundClassification:
- El atributo type es necesario. Su valor debe ser internal, iiop, http, mdb, sip, o ola. Sólo puede aparecer un elemento InboundClassification por cada tipo en el documento. Pueden aparecer hasta cinco elementos InboundClassification en un documento. Los tipos no tienen que especificarse en un determinado orden en el documento de clasificación.
- El atributo schema_version es necesario. El valor debe establecerse en 1.0.
- Debe especificarse el atributo default_transaction_class, que define la clase de transacción para los flujos de trabajo del tipo especificado. El valor de serie debe ser una clase de transacción WLM válida, una serie nula (como "") o una serie que contenga como máximo 8 espacios en blanco (como " ").
- Los elemento InboundClassification no puede anidarse. Todos los elementos InboundClassification deben terminar antes de que empiece el siguiente elemento InboundClassification o SibClassification.
- El atributo default_iiop_application_name es opcional y define el nombre de la aplicación predeterminada para flujos de trabajo IIOP que no tienen un nombre de aplicación, un nombre de módulo o un nombre de componente.
- El atributo default_iiop_module_name es opcional y define el nombre de módulo predeterminado para flujos de trabajo IIOP que no tienen un nombre de aplicación, un nombre de módulo o un nombre de componente.
- El atributo default_iiop_component_name es opcional y define el nombre de componente predeterminado para flujos de trabajo IIOP que no tienen un nombre de aplicación, un nombre de módulo o un nombre de componente.
- Las solicitudes de CORBA son un flujo de trabajo IIOP que no tiene un nombre de aplicación, un nombre de módulo o un nombre de componente.
- SibClassification
- <SibClassification type="jmsra | destinationmediation" schema_version="1.0"
default_transaction_class="value">
Siga las siguientes normas cuando utilice el elemento SibClassification:
- El atributo type es necesario. El valor deber ser jmsra o destinationmediation. En el documento puede haber un elemento SibClassification como máximo para cada tipo. Los tipos no tienen que especificarse en un determinado orden en el documento de clasificación.
- El atributo schema_version es necesario. El valor debe establecerse en 1.0.
- Debe especificarse el atributo default_transaction_class, que define la clase de transacción para los flujos de trabajo del tipo especificado. El valor de serie debe ser una clase de transacción WLM válida, una serie nula (como "") o una serie que contenga como máximo 8 espacios en blanco (como " ").
- Los elemento SibClassification no pueden anidarse. Todos los elementos SibClassification deben terminar antes de que empiece el siguiente elemento InboundClassification o SibClassification.
- WMQRAClassification
- <WMQRAClassification schema_version=”1.0”
default_transaction_class=”valor”>Las siguientes reglas se aplican al elemento WMQRAClassification:
- El atributo schema_version es necesario. El valor debe establecerse en 1.0.
- Debe especificarse el atributo default_transaction_class, que define la clase de transacción para los flujos de trabajo del tipo especificado. El valor de la serie debe ser una clase de transacción WLM válida.
- Los elementos WMQRAClassification no se pueden anidar. Cada elemento WMQRAClassification debe terminar para que cualquier otro elemento de clasificación pueda comenzar.
Las reglas y sentencias XML para clasificar distintos tipos de trabajo son similares, pero la sintaxis es ligeramente distinta para cada tipo. Para obtener más información sobre la sintaxis de cada tipo de trabajo, consulte las siguientes secciones:- InboundClassification
- SibClassification
- WMQRAClassification
Clasificación interna
El elemento InboundClassification con el tipo de atributo type="internal" define la sección del documento aplicable al trabajo interno, como por ejemplo las solicitudes despachadas en un sirviente, que se originan en el propio controlador. A continuación figura un ejemplo de este elemento:
<InboundClassification type="internal" schema_version="1.0"
default_transaction_class="value1">
Si no se especifica un elemento InboundClassification con el atributo type="internal", el trabajo interno se clasifica utilizando las reglas especificadas para el trabajo del IIOP.
Clasificación IIOP
El elemento InboundClassification con el atributo type="iiop" define la sección del documento que es aplicable a la clasificación IIOP. A continuación figura un ejemplo de este elemento:
<InboundClassification type="iiop" schema_version="1.0"
default_transaction_class="value1">
- Nombre de aplicación
Nombre de la aplicación que contiene los enterprise beans. Es el nombre de visualización de la aplicación, que es posible que no coincida con el del archivo .ear que contiene todos los artefactos.
- Nombre del módulo
Nombre del archivo .jar de EJB (Enterprise JavaBeans) que contiene uno o más enterprise beans. Puede haber varios archivos .jar de EJB en un archivo .ear.
- Nombre de componente
Nombre del EJB que está incluido en un módulo (o archivo .jar de EJB). Puede haber uno o más enterprise beans en un archivo .jar.
- Nombre de método
Nombre de un método remoto de un EJB.
Clasifique el trabajo IIOP de varias aplicaciones en cualquiera de estos niveles utilizando el elemento iiop_classification_info.
- 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">
Con el elemento iiop_classification_info, puede crear filtros basándose en los nombres de aplicación, módulo, componente y método para asignar valores TCLASS, atributos RAS, o ambos a las solicitudes de entrada. Siga las siguientes normas cuando utilice el elemento iiop_classification_info:
- transaction_class
- El atributo transaction_class es opcional. Si el atributo no está definido, hereda la clase de transacción de su padre. El valor de serie debe ser una clase de transacción WLM válida, una serie nula (como "") o una serie que contenga como máximo 8 espacios en blanco (como " "). Si especifica un serie nula o en blanco, podrá sobrescribir un valor TCLASS por omisión o un valor TCLASS asignado por un filtro de nivel superior. La especificación de una serie nula o en blanco indica que no dispone de ningún valor TCLASS para la solicitud.
- application_name, module_name, component_name y method_name
- Los atributos application_name, module_name, component_name y
method_name pueden utilizarse a medida que sean necesarios. Estos atributos pueden
actuar como selectores o filtros que asignan un clase de transacción o permiten que
un elemento iiop_classification_info anidado asigne la clase de transacción. Puede especificar el valor de estos atributos de los modos siguientes:
- Nombre exacto de la aplicación, módulo, componente o método.
- Un valor comodín. Puede colocar un asterisco (*) en cualquier
lugar de una serie para indicar que cualquier serie que empiece por la
serie anterior al asterisco y finalice por la serie a continuación del asterisco se considera una coincidencia. Si el asterisco está al final de la serie, cualquier serie que empiece por la serie
anterior al asterisco se considera una coincidencia.Ejemplos:
- La serie Mar*61, coincide con Mar61, March61 y Mar20early61, pero no coincide con March81 ni MAR61.
- La serie MAR* coincide con MARCH, MAR61 y MARS, pero no coincide con Mar61 ni con MAY61.
Avoid trouble: Las comparaciones de valores que se llevan a cabo son sensibles a las mayúsculas y minúsculas.gotcha
Puede utilizar cualquier combinación de estos atributos para crear un filtro de clasificación. Sin embargo, utilice sólo la granularidad que sea necesaria. Por ejemplo, si sólo hay una aplicación en el servidor de aplicaciones, no es necesario que las normas de clasificación especifiquen el atributo application_name.
Atributos RAS
Puede especificar los siguientes atributos RAS en el elemento iiop_classification_info. Los elementos anidados heredan los atributos RAS de su elemento padre. Los elementos anidados puede alterar temporalmente los atributos RAS de un elemento padre. Todos los atributos RAS son opcionales.
- dispatch_timeout
Especifica la cantidad de tiempo que una región de control espera después de enviar una solicitud a la cola WLM. Si la región de control no recibe una respuesta en el tiempo especificado, emite un tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica el tiempo de espera de cola WLM como un porcentaje del tiempo de espera de asignación. El rango para el porcentaje es 0 - 99. El tiempo de espera de cola es la cantidad de tiempo que una solicitud puede permanecer en la cola WLM sin asignación, antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica el valor de tiempo de espera en segundos aplicado a las solicitudes de salida que se originan bajo solicitudes asignadas. La solicitud asignada es una solicitud que el elemento Classification ha clasificado.
Este atributo altera temporalmente la propiedad de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de asignación especificado en el atributo dispatch_timeout. La solicitud es una solicitud que el elemento Classification ha clasificado. Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica el tiempo de espera de la CPU en milisegundos. El tiempo de espera de la CPU es la cantidad de tiempo de CPU permitida para la solicitud antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de CPU especificado en el atributo cputimeused_limit. La solicitud es una solicitud que el elemento Classification ha clasificado.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica en segundos el intervalo de DPM (Dispatch Progress Monitor). El supervisor de DPM desencadena la acción de volcado de DPM en el intervalo para solicitudes que el elemento de clasificación ha clasificado. Especifique la acción de volcado de DMP en el atributo dpm_dump_action.
El atributo no altera temporalmente ninguna propiedad del servidor. Debe utilizar el mandato modify para habilitar los intervalos de DPM en todo el servidor.
- dpm_dump_action
Especifica la acción de volcado de DPM que se realiza en cada intervalo de DPM para las solicitudes que clasifica el elemento de clasificación. Especifique el intervalo de DPM en el atributo dpm_interval.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica si se recopilan registros SMF (System Management Facilities) 120 subtipo 9, para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica si se utiliza un formato de indicación de fecha y hora legible por el usuario en el registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica si se recopila la sección de datos de seguridad del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica si se recopila la sección de desglose de uso de la CPU del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica si deben generarse registros de rastreo para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo no altera temporalmente ninguna propiedad del servidor. El mandato TRACERECORD modify modifica classification_only_trace.
Si algún elemento de clasificación tiene classification_only_trace establecido en 1, el rastreo a nivel de clasificación está activo para el servidor de aplicaciones. Las únicas hebras que generan registros de rastreo son hebras que procesan solicitudes que clasifica un elemento de clasificación. Este elemento de clasificación debe definir classification_only_trace="1". Las hebras que no procesan estas solicitudes tienen inhabilitada la recopilación de rastreo y no generan registros de rastreo.
Si ningún elemento de clasificación define classification_only_trace="1", el rastreo a nivel de clasificación no está activo para el servidor de aplicaciones. El servidor no inhabilita la recopilación de rastreo para ninguna hebra. Todos los registros de rastreo se escriben en la salida, tal como indica la especificación de rastreo.
El atributo classification_only_trace no afecta cómo se define o activa una especificación de rastreo. El atributo sólo afecta a qué hebras escriben registros de rastreo.
- message_tag
Especifica una señal de serie que imprime con todos los registros de rastreo, mensajes de registro y mensajes del sistema generados para solicitudes que clasifica el elemento de clasificación.
El atributo tiene un máximo de ocho caracteres.
El atributo no altera temporalmente ninguna propiedad del servidor.
Filtros de clasificación- Los elementos iiop_classification_info se pueden anidar de modo
jerárquico. Al anidar los elementos, puede crear filtros de clasificación
basados en los valores de atributo. El siguiente filtro clasifica las
solicitudes en beans EJB1 y EJB2 en la aplicación MyAPP1:
<iiop_classification_info transaction_class="FAST" application_name="MyAPP1" component_name="EJB1" /> <iiop_classification_info transaction_class="SLOW" application_name="MyAPP1" component_name="EJB2" />
El siguiente filtro también clasifica solicitudes de los EJB1 y EJB2 de la aplicación MyAPP1, pero también clasifica las solicitudes de cualquier otro EJB de la aplicación:
<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>
- Si especifica un valor de atributo que no es compatible con el valor
de atributo del elemento padre, se niega el filtro de nivel inferior. Un
ejemplo de un valor hijo que no es compatible con el valor de atributo del
elemento padre es el siguiente:
<iiop_classification_info transaction_class="FAST" application_name="MyAPP1"> <iiop_classification_info transaction_class="SLOW" application_name="MyAPP2" /> </iiop_classification_info>
En este ejemplo, las solicitudes EJB de MyAPP2 nunca se asignarían a la clase de transacción "SLOW" ya que el filtro de nivel superior sólo permite que las solicitudes IIOP para application_name="MyAPP1" se pasen a través del filtro de nivel inferior.
- Se utiliza el primer filtro de un nivel específico que coincida con
los atributos de la solicitud, no el mejor filtro o el más restrictivo. Por
lo tanto, es importante el orden en que especifique los filtros.
<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>
En el ejemplo anterior, todas las solicitudes IIOP procesadas por enterprise beans de la aplicación MyAPP están diseñadas como un valor TCLASS de SLOW. Esta asignación también se realiza para todas las solicitudes a MySSB enterprise. Aunque se asigne una clase de transacción a MySSB, no se aplica el filtro porque se ha aplicado el primer filtro y ya se ha asignado un valor TCLASS de SLOW. La lista restante de filtros del mismo nivel se ignora.
- El campo de descripción es opcional. No obstante, debe utilizar una descripción en todos los elementos iiop_classification_info. La serie de la descripción se imprime como parte del soporte de mandato de operador para que pueda identificar las normas de clasificación que se están utilizando. Mantenga sus descripciones razonablemente cortas ya que se visualizan en la consola MVS.
Clasificación HTTP
El elemento InboundClassification con el atributo type="http" define la sección del documento que es aplicable a la clasificación HTTP. A continuación figura un ejemplo de este elemento:
<InboundClassification type="http"
schema_version="1.0"
default_transaction_class="value1">
- Nombre del host virtual
Especifica el nombre de host de la cabecera HTTP a la que se está enviando la solicitud de entrada.
- Número de puerto
Especifica el puerto en el que está escuchando el capturador HTTP.
- URI (Uniform Resource Identifier)
La serie que identifica la aplicación 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">
Con el elemento http_classification_info, puede crear filtros basándose en el host, el puerto y el URI, para asignar valores TCLASS, atributos RAS, o ambos, a las solicitudes de entrada. Utilice las siguientes normas cuando utilice el elemento http_classification_info:
- transaction_class
- El atributo transaction_class es opcional. Si el atributo no está definido, hereda la clase de transacción de su padre. El valor de serie debe ser una clase de transacción WLM válida, una serie nula (como "") o una serie que contenga como máximo 8 espacios en blanco (como " "). Si especifica un serie nula o en blanco, podrá sobrescribir un valor TCLASS por omisión o un valor TCLASS asignado por un filtro de nivel superior. La especificación de una serie nula o en blanco indica que no dispone de ningún valor TCLASS para la solicitud.
- host, port y uri
- Los atributos host, port y uri pueden utilizarse a medida que sean
necesarios. Estos atributos pueden actuar como selectores o filtros que
asignan un clase de transacción o permiten que un elemento
http_classification_info anidado asigne la clase de transacción. Puede especificar el valor de estos atributos de los modos siguientes:
- Nombre exacto del host, puerto o URI.
- Cualquier valor. Para especificar una coincidencia con cualquier valor, utilice el símbolo del asterisco (*).
- Un valor comodín. Puede colocar un asterisco (*) en cualquier
lugar de una serie para indicar que cualquier serie que empiece por la
serie anterior al asterisco y finalice por la serie a continuación del asterisco se considera una coincidencia. Si el asterisco está al final de la serie, cualquier serie que empiece por la serie
anterior al asterisco se considera una coincidencia.Ejemplos:
- La serie Mar*61, coincide con Mar61, Marzo61, y Mar20principios61, pero no con Marzo81.
- La serie MAR* coincide con MARCH, MAR61 y MARS, pero no coincide con Mar61 ni con MAY61.
Avoid trouble: Las comparaciones de valores que se llevan a cabo son sensibles a las mayúsculas y minúsculas.gotcha
Utilice alguno o todos estos atributos para crear un filtro de clasificación. Utilice sólo la granularidad que sea necesaria. Por ejemplo, si sólo hay una aplicación en el servidor de aplicaciones, no es necesario que las normas de clasificación especifiquen el atributo uri.
Atributos de RAS:
Puede especificar los siguientes atributos RAS en el elemento http_classification_info. Los elementos anidados heredan los atributos RAS de su elemento padre. Los elementos anidados puede alterar temporalmente los atributos RAS de un elemento padre. Todos los atributos RAS son opcionales.
- dispatch_timeout
Especifica la cantidad de tiempo que una región de control espera después de enviar una solicitud a la cola WLM. Si la región de control no recibe una respuesta en el tiempo especificado, emite un tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo altera temporalmente las propiedades de servidor siguientes:- HTTP
- protocol_http_timeout_output
- HTTPS
- protocol_https_timeout_output
- queue_timeout_percent
Especifica el tiempo de espera de cola WLM como un porcentaje del tiempo de espera de asignación. El rango para el porcentaje es 0 - 99. El tiempo de espera de cola es la cantidad de tiempo que una solicitud puede permanecer en la cola WLM sin asignación, antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo altera temporalmente las propiedades de servidor siguientes:- HTTP
- control_region_http_queue_timeout_percent
- HTTPS
- control_region_https_queue_timeout_percent
- request_timeout
Especifica el valor de tiempo de espera en segundos aplicado a las solicitudes de salida que se originan bajo solicitudes asignadas. La solicitud asignada es una solicitud que el elemento Classification ha clasificado.
Este atributo altera temporalmente la propiedad de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de asignación especificado en el atributo dispatch_timeout. La solicitud es una solicitud que el elemento Classification ha clasificado. Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo altera temporalmente las propiedades de servidor siguientes:- HTTP
- server_region_http_stalled_thread_dump_action
- HTTPS
- server_region_https_stalled_thread_dump_action
- cputimeused_limit
Especifica el tiempo de espera de la CPU en milisegundos. El tiempo de espera de la CPU es la cantidad de tiempo de CPU permitida para la solicitud antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de CPU especificado en el atributo cputimeused_limit. La solicitud es una solicitud que el elemento Classification ha clasificado.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica en segundos el intervalo de DPM (Dispatch Progress Monitor). El supervisor de DPM desencadena la acción de volcado de DPM en el intervalo para solicitudes que el elemento de clasificación ha clasificado. Especifique la acción de volcado de DMP en el atributo dpm_dump_action.
El atributo no altera temporalmente ninguna propiedad del servidor. Debe utilizar el mandato modify para habilitar los intervalos de DPM en todo el servidor.
- dpm_dump_action
Especifica la acción de volcado de DPM que se realiza en cada intervalo de DPM para las solicitudes que clasifica el elemento de clasificación. Especifique el intervalo de DPM en el atributo dpm_interval.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica si se recopilan registros SMF (System Management Facilities) 120 subtipo 9, para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica si se utiliza un formato de indicación de fecha y hora legible por el usuario en el registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica si se recopila la sección de datos de seguridad del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica si se recopila la sección de desglose de uso de la CPU del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica si deben generarse registros de rastreo para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo no altera temporalmente ninguna propiedad del servidor. El mandato TRACERECORD modify modifica classification_only_trace.
Si algún elemento de clasificación tiene classification_only_trace establecido en 1, el rastreo a nivel de clasificación está activo para el servidor de aplicaciones. Las únicas hebras que generan registros de rastreo son hebras que procesan solicitudes que clasifica un elemento de clasificación. Este elemento de clasificación debe definir classification_only_trace="1". Las hebras que no procesan estas solicitudes tienen inhabilitada la recopilación de rastreo y no generan registros de rastreo.
Si ningún elemento de clasificación define classification_only_trace="1", el rastreo a nivel de clasificación no está activo para el servidor de aplicaciones. El servidor no inhabilita la recopilación de rastreo para ninguna hebra. Todos los registros de rastreo se escriben en la salida, tal como indica la especificación de rastreo.
El atributo classification_only_trace no afecta cómo se define o activa una especificación de rastreo. El atributo sólo afecta a qué hebras escriben registros de rastreo.
- message_tag
Especifica una señal de serie que imprime con todos los registros de rastreo, mensajes de registro y mensajes del sistema generados para solicitudes que clasifica el elemento de clasificación.
El atributo tiene un máximo de ocho caracteres.
El atributo no altera temporalmente ninguna propiedad del servidor.
- timeout_recovery
Especifica la acción que el servidor realiza cuando una solicitud que ha clasificado el elemento de clasificación supera su tiempo de espera de asignación. Puede especificar el tiempo de espera de la asignación en el atributo dispatch_timeout.
Los valores válidos son servant y session.
Cuando el atributo se establece en servant, el espacio de direcciones del sirviente que procesa la solicitud termina con ABEND EC3 y el código de razón 04130007. El espacio de direcciones del controlador envía una respuesta de error al cliente y, a continuación, cierra el socket asociado a la solicitud.
Cuando el atributo se establece en session, el espacio de direcciones del controlador envía una respuesta de error al cliente y, a continuación, cierra el socket asociado a la solicitud. El espacio de direcciones del sirviente no finaliza. La solicitud no se interrumpe, sino que puede ejecutarse hasta el final.
El atributo altera temporalmente las propiedades de servidor siguientes:- HTTP
- protocol_http_timeout_output_recovery
- HTTPS
- protocol_https_timeout_output_recovery
Filtros de clasificación:
- Puede anidar los elementos http_classification_info de forma
jerárquica. Puede construir filtros basándose en los nombres de atributo. Considere los filtros siguientes:
<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>
Ambos filtros clasifican las solicitudes en aplicaciones web identificadas por las raíces de contexto /MyWebApp1 y /MyWebApp2 en el servidor de aplicaciones que aloja las aplicaciones web para el host virtual MyVHost1.com. Sin embargo, el segundo filtro también clasifica solicitudes en cualquier otra raíz de contexto del servidor de aplicaciones.
- Especificar un nombre de atributo distinto del valor de
atributo del elemento padre niega el filtro de nivel inferior.
Por ejemplo:
<http_classification_info transaction_class="FAST" uri="/MyWebApp1/*"> <http_classification_info transaction_class="SLOW" uri="/MyWebApp2"> </http_classification_info> </http_classification_info>
Este ejemplo nunca dará como resultado que se asigne la clase de transacción SLOW a aplicaciones web con una raíz de contexto de /MyWebApp2. El filtro de nivel alto sólo permite que se pasen a un filtro de nivel inferior las solicitudes HTTP con una raíz de contexto de /MyWebApp1/*.
- Se utiliza el primer filtro de un nivel específico, no el mejor filtro
o el más restrictivo. Por lo tanto, es importante el orden de los filtros
en todos los niveles. Por ejemplo:
<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>
En este ejemplo, a las solicitudes HTTP procesadas por el servidor de aplicaciones con el host virtual "MyVHost.com" se les asigna un valor TCLASS de SLOW. Incluso a las solicitudes de la aplicación web con la raíz de contexto /MyWebAppX se les asigna un valor TCLASS de SLOW porque el filtro no se ha aplicado. El primer filtro que coincida se utiliza para la asignación de TCLASS y se ignora el resto de filtros del mismo nivel.
- El campo de descripción es opcional, sin embargo, debería utilizarlo en todos los elementos http_classification_info. La descripción se visualiza al supervisar las clases de transacción en la consola MVS.
Clasificación MDB
<InboundClassification type="mdb"
schema_version="1.0"
default_transaction_class="qrs">
<endpoint type="messagelistenerport"
name="IPVListenerPort"
defaultclassification="MDBX"
description="ABC">
- El atributo type siempre debe ser igual a messagelistenerport.
- El atributo name se corresponde con el escucha para el elemento endpoint. El valor del atributo name debe ser el nombre del puerto de escucha que se ha especificado en la consola administrativa para el servidor.
- El elemento defaultclassification es la clase de transacción por omisión que está asociada con los beans controlados por mensajes. El valor de este atributo sobrescribe el valor de clasificación de transacciones por omisión.
- El campo description es opcional, sin embargo, debería utilizarlo en todos los elementos endpoint. La descripción se visualiza al supervisar las clases de transacción en la consola 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
- Utilice el atributo selector del elemento classificationentry para asignar una clase de transacción a un bean controlado por mensaje que tenga una cláusula de selector en el descriptor de despliegue. Utilice las siguientes normas al definir los elementos classificationentry:
- El valor del atributo selector debe coincidir exactamente con la cláusula de selector del descriptor de despliegue MDB.
- El valor del atributo selector debe tener la sintaxis correcta para un documento XML. Debe sustituir el símbolo < por la expresión < referencia de entidad, y el símbolo > por la expresión > referencia de entidad. De igual modo, si utiliza un apóstrofe o comillas, utilice las referencias de entidad ' y ".
- classification
El atributo classification es opcional. Si el atributo no está definido, hereda la clasificación de su padre. El valor de serie debe ser una clase de transacción WLM válida, una serie nula (como "") o una serie que contenga como máximo 8 espacios en blanco (como " "). Si especifica un serie nula o en blanco, podrá sobrescribir un valor TCLASS por omisión o un valor TCLASS asignado por un filtro de nivel superior. La especificación de una serie nula o en blanco indica que no dispone de ningún valor TCLASS para la solicitud.
Atributos de RAS:
Puede especificar los siguientes atributos RAS en el elemento classificationentry. Los elementos anidados heredan los atributos RAS de su elemento padre. Los elementos anidados puede alterar temporalmente los atributos RAS de un elemento padre. Todos los atributos RAS son opcionales.
- dispatch_timeout
Especifica la cantidad de tiempo que una región de control espera después de enviar una solicitud a la cola WLM. Si la región de control no recibe una respuesta en el tiempo especificado, emite un tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_mdb_request_timeout.
- queue_timeout_percent
Especifica el tiempo de espera de cola WLM como un porcentaje del tiempo de espera de asignación. El rango para el porcentaje es 0 - 99. El tiempo de espera de cola es la cantidad de tiempo que una solicitud puede permanecer en la cola WLM sin asignación, antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_mdb_queue_timeout_percent.
- request_timeout
Especifica el valor de tiempo de espera en segundos aplicado a las solicitudes de salida que se originan bajo solicitudes asignadas. La solicitud asignada es una solicitud que el elemento Classification ha clasificado.
Este atributo altera temporalmente la propiedad de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de asignación especificado en el atributo dispatch_timeout. La solicitud es una solicitud que el elemento Classification ha clasificado. Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_mdb_stalled_thread_dump_action.
- cputimeused_limit
Especifica el tiempo de espera de la CPU en milisegundos. El tiempo de espera de la CPU es la cantidad de tiempo de CPU permitida para la solicitud antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de CPU especificado en el atributo cputimeused_limit. La solicitud es una solicitud que el elemento Classification ha clasificado.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica en segundos el intervalo de DPM (Dispatch Progress Monitor). El supervisor de DPM desencadena la acción de volcado de DPM en el intervalo para solicitudes que el elemento de clasificación ha clasificado. Especifique la acción de volcado de DMP en el atributo dpm_dump_action.
El atributo no altera temporalmente ninguna propiedad del servidor. Debe utilizar el mandato modify para habilitar los intervalos de DPM en todo el servidor.
- dpm_dump_action
Especifica la acción de volcado de DPM que se realiza en cada intervalo de DPM para las solicitudes que clasifica el elemento de clasificación. Especifique el intervalo de DPM en el atributo dpm_interval.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica si se recopilan registros SMF (System Management Facilities) 120 subtipo 9, para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica si se utiliza un formato de indicación de fecha y hora legible por el usuario en el registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica si se recopila la sección de datos de seguridad del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica si se recopila la sección de desglose de uso de la CPU del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica si deben generarse registros de rastreo para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo no altera temporalmente ninguna propiedad del servidor. El mandato TRACERECORD modify modifica classification_only_trace.
Si algún elemento de clasificación tiene classification_only_trace establecido en 1, el rastreo a nivel de clasificación está activo para el servidor de aplicaciones. Las únicas hebras que generan registros de rastreo son hebras que procesan solicitudes que clasifica un elemento de clasificación. Este elemento de clasificación debe definir classification_only_trace="1". Las hebras que no procesan estas solicitudes tienen inhabilitada la recopilación de rastreo y no generan registros de rastreo.
Si ningún elemento de clasificación define classification_only_trace="1", el rastreo a nivel de clasificación no está activo para el servidor de aplicaciones. El servidor no inhabilita la recopilación de rastreo para ninguna hebra. Todos los registros de rastreo se escriben en la salida, tal como indica la especificación de rastreo.
El atributo classification_only_trace no afecta cómo se define o activa una especificación de rastreo. El atributo sólo afecta a qué hebras escriben registros de rastreo.
- message_tag
Especifica una señal de serie que imprime con todos los registros de rastreo, mensajes de registro y mensajes del sistema generados para solicitudes que clasifica el elemento de clasificación.
El atributo tiene un máximo de ocho caracteres.
El atributo no altera temporalmente ninguna propiedad del servidor.
Clasificación de los adaptadores locales optimizados
El elemento InboundClassification con el atributo type="ola" define la sección del documento que se aplica a la clasificación de adaptadores locales optimizados. A continuación figura un ejemplo de este elemento:
<InboundClassification type="ola" schema_version="1.0"
default_transaction_class="value1"
>
Puede clasificar el trabajo del adaptador local optimizado añadiendo una sección para cada aplicación EJB que utiliza el nombre de servicio o el nombre de inicio JNDI (Java Naming and Directory Interface). Puede utilizar un comodín para el nombre inicial JNDI.
Clasifique el trabajo del adaptador local optimizado en varias aplicaciones en cualquiera de estos niveles utilizando el elemento 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">
Con el elemento ola_classification_info, puede crear filtros basándose en el servicio o nombre JNDI. Utilice el nombre para asignar valores TCLASS, atributos RAS, o ambos, a las solicitudes de entrada. Siga las normas siguientes cuando utilice el elemento ola_classification_info:
- transaction_class
- El atributo transaction_class es opcional. Si el atributo no está definido, hereda la clase de transacción de su padre. El valor de serie debe ser una clase de transacción WLM válida, una serie nula (como "") o una serie que contenga como máximo 8 espacios en blanco (como " "). Si especifica un serie nula o en blanco, podrá sobrescribir un valor TCLASS por omisión o un valor TCLASS asignado por un filtro de nivel superior. La especificación de una serie nula o en blanco indica que no dispone de ningún valor TCLASS para la solicitud.
- propagate_transaction_name
- El atributo propagate_transaction_name es opcional. Si se especifica el atributo, el valor de serie debe ser true o false. Al especificar el valor true, la clase de servicio WLM de CICS (Customer Information Control System) se propaga al servidor de aplicaciones en cada solicitud o en cada solicitud coincidente si se ha especificado el filtro service_name. El trabajo que se envía en el servidor de aplicaciones a través del adaptador local optimizado se ejecuta en la misma clase de servicio que la solicitud de cliente.
- service_name
- El atributo service_name es opcional. Este atributo actúa como un selector o filtro que, o bien asigna una clase de transacción o admite un elemento ola_classification_info anidado para asignar la clase de transacción. Puede especificar el valor de este atributo de la siguiente manera:
- El nombre de servicio exacto o nombre de inicio JNDI de la aplicación EJB a controlar.
- Un valor comodín. Puede colocar un asterisco (*) en cualquier
lugar de una serie para indicar que cualquier serie que empiece por la
serie anterior al asterisco y finalice por la serie a continuación del asterisco se considera una coincidencia. Si el asterisco está al final de la serie, cualquier serie que empiece por la serie
anterior al asterisco se considera una coincidencia. Ejemplos:
- service_name="ejb/mySecondBean"
- service_name="ejb/my*Bean"
- service_name="ejb/my*"
- service_name="ejb/security/*"
PRECAUCIÓN:Las comparaciones de valores que realiza el servidor de aplicaciones son sensibles a las mayúsculas y minúsculas.
Atributos RAS
Puede especificar los siguientes atributos RAS en el elemento ola_classification_info. Los elementos anidados heredan los atributos RAS de su elemento padre. Los elementos anidados puede alterar temporalmente los atributos RAS de un elemento padre. Todos los atributos RAS son opcionales.
- dispatch_timeout
Especifica la cantidad de tiempo que una región de control espera después de enviar una solicitud a la cola WLM. Si la región de control no recibe una respuesta en el tiempo especificado, emite un tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica el tiempo de espera de cola WLM como un porcentaje del tiempo de espera de asignación. El rango para el porcentaje es 0 - 99. El tiempo de espera de cola es la cantidad de tiempo que una solicitud puede permanecer en la cola WLM sin asignación, antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica el valor de tiempo de espera en segundos aplicado a las solicitudes de salida que se originan bajo solicitudes asignadas. La solicitud asignada es una solicitud que el elemento Classification ha clasificado.
Este atributo altera temporalmente la propiedad de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de asignación especificado en el atributo dispatch_timeout. La solicitud es una solicitud que el elemento Classification ha clasificado. Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica el tiempo de espera de la CPU en milisegundos. El tiempo de espera de la CPU es la cantidad de tiempo de CPU permitida para la solicitud antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de CPU especificado en el atributo cputimeused_limit. La solicitud es una solicitud que el elemento Classification ha clasificado.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica en segundos el intervalo de DPM (Dispatch Progress Monitor). El supervisor de DPM desencadena la acción de volcado de DPM en el intervalo para solicitudes que el elemento de clasificación ha clasificado. Especifique la acción de volcado de DMP en el atributo dpm_dump_action.
El atributo no altera temporalmente ninguna propiedad del servidor. Debe utilizar el mandato modify para habilitar los intervalos de DPM en todo el servidor.
- dpm_dump_action
Especifica la acción de volcado de DPM que se realiza en cada intervalo de DPM para las solicitudes que clasifica el elemento de clasificación. Especifique el intervalo de DPM en el atributo dpm_interval.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica si se recopilan registros SMF (System Management Facilities) 120 subtipo 9, para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica si se utiliza un formato de indicación de fecha y hora legible por el usuario en el registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica si se recopila la sección de datos de seguridad del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica si se recopila la sección de desglose de uso de la CPU del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica si deben generarse registros de rastreo para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo no altera temporalmente ninguna propiedad del servidor. El mandato TRACERECORD modify modifica classification_only_trace.
Si algún elemento de clasificación tiene classification_only_trace establecido en 1, el rastreo a nivel de clasificación está activo para el servidor de aplicaciones. Las únicas hebras que generan registros de rastreo son hebras que procesan solicitudes que clasifica un elemento de clasificación. Este elemento de clasificación debe definir classification_only_trace="1". Las hebras que no procesan estas solicitudes tienen inhabilitada la recopilación de rastreo y no generan registros de rastreo.
Si ningún elemento de clasificación define classification_only_trace="1", el rastreo a nivel de clasificación no está activo para el servidor de aplicaciones. El servidor no inhabilita la recopilación de rastreo para ninguna hebra. Todos los registros de rastreo se escriben en la salida, tal como indica la especificación de rastreo.
El atributo classification_only_trace no afecta cómo se define o activa una especificación de rastreo. El atributo sólo afecta a qué hebras escriben registros de rastreo.
- message_tag
Especifica una señal de serie que imprime con todos los registros de rastreo, mensajes de registro y mensajes del sistema generados para solicitudes que clasifica el elemento de clasificación.
El atributo tiene un máximo de ocho caracteres.
El atributo no altera temporalmente ninguna propiedad del servidor.
Filtros de clasificación:- Los elementos ola_classification_info se pueden anidar de modo jerárquico. Al anidar los elementos, puede crear filtros de clasificación
basados en los valores de atributo.
<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>
- El campo de descripción es opcional. No obstante, utilice una descripción en todos los elementos ola_classification_info. La serie de la descripción se imprime como parte del soporte de mandato de operador para que pueda identificar las normas de clasificación que se están utilizando. Mantenga sus descripciones razonablemente cortas ya que se visualizan en la consola MVS.
Clasificación SIP
El elemento InboundClassification con el atributo type="sip" define la sección del documento que establece la clase de la transacción por omisión para las solicitudes SIP (Session Initiation Protocol). A continuación figura un ejemplo de este elemento:
<InboundClassification type="sip" schema_version="1.0"
default_transaction_class="value1">
Clasificación RA de JMS
<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
- Utilice el atributo selector del elemento sib_classification_info para
asignar una clase de transacción a un bean controlado por mensaje que
tenga una cláusula de selector en el descriptor de despliegue. Utilice las siguientes normas
al definir los elementos sib_classification_info:
- El valor del atributo del selector es una expresión SQL que selecciona un mensaje según los valores de las propiedades del mensaje. La sintaxis es la de un selector de mensajes de la especificación JMS 1.1, pero puede operar en mensajes SIMessage (más que en los mensajes JMS). La sintaxis puede seleccionar propiedades del sistema (incluidas las cabeceras JMS, propiedades JMSX y JMS_IBM_properties) y propiedades de usuario (que deben llevar el prefijo ".user", por ejemplo, para la propiedad de usuario "Location", el selector especificaría "user.Location" como se muestra en el ejemplo anterior). Para obtener más información, consulte el tema dedicado a la utilización de propiedades de mensaje.
- El valor del atributo selector debe tener la sintaxis correcta para un documento XML. Debe sustituir el símbolo < con la referencia de la entidad < y el símbolo > con la referencia de entidad >. De igual modo, si utiliza un apóstrofe o comillas, utilice las referencias de entidad ' y ".
- bus
- Nombre del bus de integración de servicios al que está asignado el destino conectado el destino señalado. La clasificación se aplica al bus nombrado por esta propiedad o cualquier bus si no especifica esta propiedad. Los destinos a los que se aplica la clasificación dependen del uso que haga de la propiedad destination.
- destination
- Nombre del destino de bus señalado al que se ha enviado el mensaje. Se trata del nombre de un espacio de tema o de cola. La clasificación se aplica al destino nombrado por esta propiedad o cualquier destino si no especifica esta propiedad. Los buses de integración de servicios a los que se aplica la clasificación dependen del uso que haga de la propiedad bus.
- discriminator
- Esta propiedad sólo se aplica cuando la propiedad destination nombra un espacio de tema. Este valor discriminator es, en este caso, una expresión XPath que selecciona uno o más temas en el espacio de tema.
- description
- Aunque el campo description es opcional, debe utilizarlo en todos los elementos sib_classification_info. La descripción se visualiza al supervisar las clases de transacción en la consola MVS.
Atributos RAS
Puede especificar los siguientes atributos RAS en el elemento sib_classification_info. Los elementos anidados heredan los atributos RAS de su elemento padre. Los elementos anidados puede alterar temporalmente los atributos RAS de un elemento padre. Todos los atributos RAS son opcionales.
- dispatch_timeout
Especifica la cantidad de tiempo que una región de control espera después de enviar una solicitud a la cola WLM. Si la región de control no recibe una respuesta en el tiempo especificado, emite un tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica el tiempo de espera de cola WLM como un porcentaje del tiempo de espera de asignación. El rango para el porcentaje es 0 - 99. El tiempo de espera de cola es la cantidad de tiempo que una solicitud puede permanecer en la cola WLM sin asignación, antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica el valor de tiempo de espera en segundos aplicado a las solicitudes de salida que se originan bajo solicitudes asignadas. La solicitud asignada es una solicitud que el elemento Classification ha clasificado.
Este atributo altera temporalmente la propiedad de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de asignación especificado en el atributo dispatch_timeout. La solicitud es una solicitud que el elemento Classification ha clasificado. Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica el tiempo de espera de la CPU en milisegundos. El tiempo de espera de la CPU es la cantidad de tiempo de CPU permitida para la solicitud antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de CPU especificado en el atributo cputimeused_limit. La solicitud es una solicitud que el elemento Classification ha clasificado.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica en segundos el intervalo de DPM (Dispatch Progress Monitor). El supervisor de DPM desencadena la acción de volcado de DPM en el intervalo para solicitudes que el elemento de clasificación ha clasificado. Especifique la acción de volcado de DMP en el atributo dpm_dump_action.
El atributo no altera temporalmente ninguna propiedad del servidor. Debe utilizar el mandato modify para habilitar los intervalos de DPM en todo el servidor.
- dpm_dump_action
Especifica la acción de volcado de DPM que se realiza en cada intervalo de DPM para las solicitudes que clasifica el elemento de clasificación. Especifique el intervalo de DPM en el atributo dpm_interval.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica si se recopilan registros SMF (System Management Facilities) 120 subtipo 9, para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica si se utiliza un formato de indicación de fecha y hora legible por el usuario en el registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica si se recopila la sección de datos de seguridad del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica si se recopila la sección de desglose de uso de la CPU del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica si deben generarse registros de rastreo para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo no altera temporalmente ninguna propiedad del servidor. El mandato TRACERECORD modify modifica classification_only_trace.
Si algún elemento de clasificación tiene classification_only_trace establecido en 1, el rastreo a nivel de clasificación está activo para el servidor de aplicaciones. Las únicas hebras que generan registros de rastreo son hebras que procesan solicitudes que clasifica un elemento de clasificación. Este elemento de clasificación debe definir classification_only_trace="1". Las hebras que no procesan estas solicitudes tienen inhabilitada la recopilación de rastreo y no generan registros de rastreo.
Si ningún elemento de clasificación define classification_only_trace="1", el rastreo a nivel de clasificación no está activo para el servidor de aplicaciones. El servidor no inhabilita la recopilación de rastreo para ninguna hebra. Todos los registros de rastreo se escriben en la salida, tal como indica la especificación de rastreo.
El atributo classification_only_trace no afecta cómo se define o activa una especificación de rastreo. El atributo sólo afecta a qué hebras escriben registros de rastreo.
- message_tag
Especifica una señal de serie que imprime con todos los registros de rastreo, mensajes de registro y mensajes del sistema generados para solicitudes que clasifica el elemento de clasificación.
El atributo tiene un máximo de ocho caracteres.
El atributo no altera temporalmente ninguna propiedad del servidor.
Todos los elementos sib_classification_info pueden contener una o más de estas propiedades según sea necesario para clasificar el trabajo para un mensaje. Un elemento sib_classification_info no puede contener más de una instancia de cada propiedad.
<sib_classification_info bus="MyBus" transaction_class="a" />
<sib_classification_info destination="MyDest" transaction_class="b" />
La clasificación "a" se asigna a un mensaje que llega al destino MyDest desde el bus de integración de servicios MyBus. La clasificación "b" se asigna a un mensaje que llega a MyDest desde otro bus.
Si un mensaje no coincide con ningún elemento sib_classification_info de un elemento SibClassification que lo contenga, se le asigna la clasificación por omisión del elemento SibClassification.
Si un mensaje no coincide con ningún elemento sib_classification_info de un elemento SibClassification, o si no hay elementos SibClassification definidos, todo el trabajo recibe una clasificación por omisión incorporada con el valor "SIBUS". Debe realizar las acciones de z/OS Workload Manager que sean necesarias para utilizar el valor de TCLASS "SIBUS", como se describe en Clasificación de la carga de trabajo z/OS.
Clasificación de mediación
<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
- Utilice el atributo selector del elemento sib_classification_info para
asignar una clase de transacción con una mediación que tenga una cláusula
de selector en el descriptor de despliegue. Utilice las siguientes normas
al definir los elementos sib_classification_info:
- El valor del atributo del selector es una expresión
SQL que selecciona un mensaje según los valores de las propiedades del
mensaje.
La sintaxis es la de un selector de mensajes de la
especificación JMS 1.1, pero puede operar en mensajes SIMessage (más que
en los mensajes JMS).
La sintaxis puede seleccionar propiedades del
sistema (incluidas las cabeceras JMS, propiedades JMSX y
JMS_IBM_properties) y propiedades de usuario (que deben llevar el prefijo
".user", por ejemplo, para la propiedad de usuario "Location",
el selector especificaría "user.Location" como se muestra en el
ejemplo anterior).
Para obtener más información, consulte el tema dedicado a la utilización de propiedades de mensaje.
- El valor del atributo selector debe tener la sintaxis correcta para un documento XML. Debe sustituir el símbolo < con la referencia de la entidad < y el símbolo > con la referencia de entidad >. De igual modo, si utiliza un apóstrofe o comillas, utilice las referencias de entidad ' y ".
- El valor del atributo del selector es una expresión
SQL que selecciona un mensaje según los valores de las propiedades del
mensaje.
La sintaxis es la de un selector de mensajes de la
especificación JMS 1.1, pero puede operar en mensajes SIMessage (más que
en los mensajes JMS).
La sintaxis puede seleccionar propiedades del
sistema (incluidas las cabeceras JMS, propiedades JMSX y
JMS_IBM_properties) y propiedades de usuario (que deben llevar el prefijo
".user", por ejemplo, para la propiedad de usuario "Location",
el selector especificaría "user.Location" como se muestra en el
ejemplo anterior).
- bus
- Nombre del bus de integración de servicios al que está asignado el destino conectado el destino señalado. La clasificación se aplica al bus nombrado por esta propiedad o cualquier bus si no especifica esta propiedad. Los destinos a los que se aplica la clasificación dependen del uso que haga de la propiedad destination.
- destination
- Nombre del destino de bus señalado al que se ha enviado el mensaje. Se trata del nombre de un espacio de tema o de cola. La clasificación se aplica al destino nombrado por esta propiedad o cualquier destino si no especifica esta propiedad. Los buses de integración de servicios a los que se aplica la clasificación dependen del uso que haga de la propiedad bus.
- discriminator
- Esta propiedad sólo se aplica cuando la propiedad destination nombra un espacio de tema. Este valor discriminator es, en este caso, una expresión XPath que selecciona uno o más temas en el espacio de tema.
- description
- Aunque el campo description es opcional, debe utilizarlo en todos los elementos sib_classification_info. La descripción se visualiza al supervisar las clases de transacción en la consola MVS.
Atributos RAS
Puede especificar los siguientes atributos RAS en el elemento sib_classification_info. Los elementos anidados heredan los atributos RAS de su elemento padre. Los elementos anidados puede alterar temporalmente los atributos RAS de un elemento padre. Todos los atributos RAS son opcionales.
- dispatch_timeout
Especifica la cantidad de tiempo que una región de control espera después de enviar una solicitud a la cola WLM. Si la región de control no recibe una respuesta en el tiempo especificado, emite un tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica el tiempo de espera de cola WLM como un porcentaje del tiempo de espera de asignación. El rango para el porcentaje es 0 - 99. El tiempo de espera de cola es la cantidad de tiempo que una solicitud puede permanecer en la cola WLM sin asignación, antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica el valor de tiempo de espera en segundos aplicado a las solicitudes de salida que se originan bajo solicitudes asignadas. La solicitud asignada es una solicitud que el elemento Classification ha clasificado.
Este atributo altera temporalmente la propiedad de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de asignación especificado en el atributo dispatch_timeout. La solicitud es una solicitud que el elemento Classification ha clasificado. Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica el tiempo de espera de la CPU en milisegundos. El tiempo de espera de la CPU es la cantidad de tiempo de CPU permitida para la solicitud antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de CPU especificado en el atributo cputimeused_limit. La solicitud es una solicitud que el elemento Classification ha clasificado.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica en segundos el intervalo de DPM (Dispatch Progress Monitor). El supervisor de DPM desencadena la acción de volcado de DPM en el intervalo para solicitudes que el elemento de clasificación ha clasificado. Especifique la acción de volcado de DMP en el atributo dpm_dump_action.
El atributo no altera temporalmente ninguna propiedad del servidor. Debe utilizar el mandato modify para habilitar los intervalos de DPM en todo el servidor.
- dpm_dump_action
Especifica la acción de volcado de DPM que se realiza en cada intervalo de DPM para las solicitudes que clasifica el elemento de clasificación. Especifique el intervalo de DPM en el atributo dpm_interval.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica si se recopilan registros SMF (System Management Facilities) 120 subtipo 9, para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica si se utiliza un formato de indicación de fecha y hora legible por el usuario en el registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica si se recopila la sección de datos de seguridad del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica si se recopila la sección de desglose de uso de la CPU del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica si deben generarse registros de rastreo para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo no altera temporalmente ninguna propiedad del servidor. El mandato TRACERECORD modify modifica classification_only_trace.
Si algún elemento de clasificación tiene classification_only_trace establecido en 1, el rastreo a nivel de clasificación está activo para el servidor de aplicaciones. Las únicas hebras que generan registros de rastreo son hebras que procesan solicitudes que clasifica un elemento de clasificación. Este elemento de clasificación debe definir classification_only_trace="1". Las hebras que no procesan estas solicitudes tienen inhabilitada la recopilación de rastreo y no generan registros de rastreo.
Si ningún elemento de clasificación define classification_only_trace="1", el rastreo a nivel de clasificación no está activo para el servidor de aplicaciones. El servidor no inhabilita la recopilación de rastreo para ninguna hebra. Todos los registros de rastreo se escriben en la salida, tal como indica la especificación de rastreo.
El atributo classification_only_trace no afecta cómo se define o activa una especificación de rastreo. El atributo sólo afecta a qué hebras escriben registros de rastreo.
- message_tag
Especifica una señal de serie que imprime con todos los registros de rastreo, mensajes de registro y mensajes del sistema generados para solicitudes que clasifica el elemento de clasificación.
El atributo tiene un máximo de ocho caracteres.
El atributo no altera temporalmente ninguna propiedad del servidor.
Todos los elementos sib_classification_info pueden contener una o más de estas propiedades según sea necesario para clasificar el trabajo para un mensaje. Un elemento sib_classification_info no puede contener más de una instancia de cada propiedad.
<sib_classification_info transaction_class="e" destination="themoon" description="n" />
<sib_classification_info transaction_class="f" description="n" />
La clasificación "e" se asigna a un mensaje que llega al destino mediado themoon. La clasificación "f" se asigna a un mensaje que llega a otro destino mediado.
Si un mensaje no coincide con ningún elemento sib_classification_info de un elemento SibClassification que lo contenga, se le asigna la clasificación por omisión del elemento SibClassification.
Si un mensaje no coincide con ningún elemento sib_classification_info de ningún elemento SibClassification, o si no hay elementos SibClassification definidos, todo el trabajo recibe una clasificación por omisión incorporada con el valor "SIBUS". Debe realizar las acciones de z/OS Workload Manager que sean necesarias para utilizar el valor de TCLASS "SIBUS", como se describe en Clasificación de la carga de trabajo z/OS.
Clasificación del proveedor de mensajería 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
- Utilice el atributo selector del elemento wmqra_classification_info para asignar una clase de transacción a un mensaje en función de sus propiedades.
Este atributo se puede utilizar también para asignar una clase de transacción a un bean controlado por mensaje que tenga una cláusula de selector en su descriptor de despliegue:
- El valor del atributo del selector es una expresión SQL que selecciona un mensaje según los valores de las propiedades del mensaje. La sintaxis es la del selector de mensajes en la especificación JMS 1.1.
- El valor del atributo selector debe tener la sintaxis correcta para un documento XML. Debe sustituir el símbolo < con la referencia de la entidad < y el símbolo > con la referencia de entidad >. De igual modo, si utiliza un apóstrofe o comillas, utilice las referencias de entidad ' y ".
- destination
- URI que representa el destino de WebSphere MQ al que se ha enviado el mensaje. La clasificación se aplica al destino nombrado por esta propiedad, o a cualquier destino si no se especifica la propiedad. Si el URI representa un destino de tipo de cola, puede incluir opcionalmente un nombre de gestor de colas, pero ese nombre se ignora y no se utiliza para la clasificación. Si el URI representa un destino de tipo de tema, puede utilizar comodines. Para obtener más información sobre el soporte de comodines en WebSphere MQ, consulte el centro de información de WebSphere MQ.
- queue_manager
- Nombre del gestor de colas de WebSphere MQ al que se ha enviado el mensaje. La clasificación se aplica al gestor de colas nombrado por esta propiedad, o por cualquier gestor de colas si no se especifica esta propiedad. El nombre del gestor de colas debe ser compatible con los convenios de denominación de WebSphere MQ.
- Tenga en cuenta que este campo no se debe establecer en el nombre de un grupo de compartimiento de colas de WebSphere MQ. En su lugar, debe crear un elemento wmqra_classification_info para cada gestor de colas del grupo de compartimiento de colas o basar la clasificación en algo más como, por ejemplo, el atributo de destino.
- description
- Aunque el campo de la descripción es opcional, debe utilizarlo en todos los elementos wmqra_classification_info.
Atributos de RAS:
Puede especificar los siguientes atributos RAS en el elemento wmqra_classification_info. Los elementos anidados heredan los atributos RAS de su elemento padre. Los elementos anidados puede alterar temporalmente los atributos RAS de un elemento padre. Todos los atributos RAS son opcionales.
- dispatch_timeout
Especifica la cantidad de tiempo que una región de control espera después de enviar una solicitud a la cola WLM. Si la región de control no recibe una respuesta en el tiempo especificado, emite un tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica el tiempo de espera de cola WLM como un porcentaje del tiempo de espera de asignación. El rango para el porcentaje es 0 - 99. El tiempo de espera de cola es la cantidad de tiempo que una solicitud puede permanecer en la cola WLM sin asignación, antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica el valor de tiempo de espera en segundos aplicado a las solicitudes de salida que se originan bajo solicitudes asignadas. La solicitud asignada es una solicitud que el elemento Classification ha clasificado.
Este atributo altera temporalmente la propiedad de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de asignación especificado en el atributo dispatch_timeout. La solicitud es una solicitud que el elemento Classification ha clasificado. Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica el tiempo de espera de la CPU en milisegundos. El tiempo de espera de la CPU es la cantidad de tiempo de CPU permitida para la solicitud antes de que la solicitud exceda el tiempo de espera. La solicitud es una solicitud que el elemento Classification ha clasificado.
El atributo sustituye la propiedad de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica la acción de volcado que el servidor realiza cuando las solicitudes superan su tiempo de espera de CPU especificado en el atributo cputimeused_limit. La solicitud es una solicitud que el elemento Classification ha clasificado.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica en segundos el intervalo de DPM (Dispatch Progress Monitor). El supervisor de DPM desencadena la acción de volcado de DPM en el intervalo para solicitudes que el elemento de clasificación ha clasificado. Especifique la acción de volcado de DMP en el atributo dpm_dump_action.
El atributo no altera temporalmente ninguna propiedad del servidor. Debe utilizar el mandato modify para habilitar los intervalos de DPM en todo el servidor.
- dpm_dump_action
Especifica la acción de volcado de DPM que se realiza en cada intervalo de DPM para las solicitudes que clasifica el elemento de clasificación. Especifique el intervalo de DPM en el atributo dpm_interval.
Los valores válidos son svcdump, javacore, heapdump, traceback, javatdump y none.
El atributo sustituye la propiedad de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica si se recopilan registros SMF (System Management Facilities) 120 subtipo 9, para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica si se utiliza un formato de indicación de fecha y hora legible por el usuario en el registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica si se recopila la sección de datos de seguridad del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica si se recopila la sección de desglose de uso de la CPU del registro SMF 120 subtipo 9 para las solicitudes. Las solicitudes son solicitudes de que el elemento de clasificación ha clasificado.
Los valores válidos son 0 (no) y 1 (yes).
El atributo sustituye la propiedad de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica si deben generarse registros de rastreo para las solicitudes que clasifica el elemento de clasificación.
Los valores válidos son 0 (no) y 1 (yes).
El atributo no altera temporalmente ninguna propiedad del servidor. El mandato TRACERECORD modify modifica classification_only_trace.
Si algún elemento de clasificación tiene classification_only_trace establecido en 1, el rastreo a nivel de clasificación está activo para el servidor de aplicaciones. Las únicas hebras que generan registros de rastreo son hebras que procesan solicitudes que clasifica un elemento de clasificación. Este elemento de clasificación debe definir classification_only_trace="1". Las hebras que no procesan estas solicitudes tienen inhabilitada la recopilación de rastreo y no generan registros de rastreo.
Si ningún elemento de clasificación define classification_only_trace="1", el rastreo a nivel de clasificación no está activo para el servidor de aplicaciones. El servidor no inhabilita la recopilación de rastreo para ninguna hebra. Todos los registros de rastreo se escriben en la salida, tal como indica la especificación de rastreo.
El atributo classification_only_trace no afecta cómo se define o activa una especificación de rastreo. El atributo sólo afecta a qué hebras escriben registros de rastreo.
- message_tag
Especifica una señal de serie que imprime con todos los registros de rastreo, mensajes de registro y mensajes del sistema generados para solicitudes que clasifica el elemento de clasificación.
El atributo tiene un máximo de ocho caracteres.
El atributo no altera temporalmente ninguna propiedad del servidor.
Cada elemento wmqra_classification_info puede contener una o varias de estas propiedades, según sea necesario para clasificar el trabajo para un mensaje. Un elemento wmqra_classification_info no puede contener más de una instancia de cada propiedad.
<wmqra_classification_info queue_manager="QMGR1" transaction_class="TC_1" />
<wmqra_classification_info destination="queue:///Q1" transaction_class="TC_2" />
A un mensaje que llega al destino Q1 en el gestor de colas QMGR1 se asigna la clasificación "TC_1". A un mensaje que llega a Q1 desde otro gestor de colas se asigna la clasificación "TC_2".
Si un mensaje no coincide con ningún elemento wmqra_classification_info de un elemento WMQRAClassification que lo contenga, el mensaje se asigna a la clasificación predeterminada desde el elemento WMQRAClassification. Si hay varios elementos WMQRAClassification, se utiliza la clase de transacción predeterminada del primer elemento WMQRAClassification.
Si no se definen elementos WMQRAClassification, todo el trabajo recibe la clasificación predeterminada "WMQRA". Debe realizar las acciones de z/OS Workload Manager que sean necesarias para utilizar el valor de TCLASS "WMQRA", como se describe en Clasificación de la carga de trabajo z/OS.
Ejemplo de documento de clasificación de cargas de trabajo de z/OS sin atributos RAS
El documento de clasificación de cargas de trabajo de z/OS de ejemplo contiene atributos para clasificar las solicitudes de trabajo HTTP de entrada, IIOP, SIP (Session Initiation Protocol) y MDB (bean controlado por mensaje) del gestor de carga de trabajo de z/OS. Este ejemplo no contiene atributos RAS.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Classification SYSTEM "Classification.dtd" > <Classification schema_version="1.0"> <!-- Internal Classification Rules --> <InboundClassification type="internal" 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>
Ejemplo de documento de clasificación de cargas de trabajo de z/OS con atributos RAS
El documento de clasificación de cargas de trabajo de z/OS de ejemplo contiene atributos para clasificar las solicitudes de trabajo HTTP de entrada, IIOP y MDB del gestor de carga de trabajo de z/OS. Este ejemplo contiene atributos RAS.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Classification SYSTEM "Classification.dtd" > <Classification schema_version="1.0"> <!-- IIOP Classification Rules --> <InboundClassification type="iiop" schema_version="1.0" default_transaction_class="TC"> <!-- Información de clasificación IIOP para la aplicación "EJBApp1". El elemento de clasificación define un transaction_class de "TC1". Este valor altera temporalmente el valor de default_transaction_class del elemento InboundClassification ("TC"). El elemento de clasificación también especifica un message_tag, que se aplica a todas las solicitudes que están clasificadas bajo este elemento de clasificación. --> <iiop_classification_info application_name="EJBApp1" transaction_class="TC1" message_tag="EJBApp1"> <!-- EJBApp1 contiene un módulo jar denominado "MyEJB.jar" con un EJB denominado "MyEJBClass". transaction_class no está definido para este elemento; por lo tanto, el elemento hereda la transaction_class de su nodo padre, "TC1". Este elemento también hereda el atributo message_tag de su nodo padre, "EJBApp1". En general, un elemento de clasificación hereda todos los atributos RAS de todos sus nodos ancestros, con los nodos ancestros más cercanos (por ejemplo, los padres directos) con otros nodos ancestro superiores en la cadena (por ejemplo, abuelos). --> <iiop_classification_info module_name="MyEJB.jar" component_name="MyEJBClass"> <!-- MyEJBClass contiene métodos denominados "helloWorld" y "goodbyeWorld". A helloWorld se le asigna un dispatch_timeout de 30 segundos y un queue_timeout_percent de 90, por lo que el valor de tiempo de espera de cola es el 90% del valor de dispatch_timeout. El elemento de clasificación también especifica SMF_request_activity_enabled=1, lo que significa que se recopilan registros SMF 120 subtipo 9 para todas las solicitudes destinadas al método helloWorld. Tenga en cuenta también que este elemento de clasificación no define una transaction_class; por tanto, hereda la transaction_class del elemento ancestro más cercano que defina uno. En este caso, el elemento ancestro más cercano que define una transaction_class es el elemento abuelo, "TC1". Nota: si no hay ningún elemento ancestro que defina una transaction_class, el elemento de clasificación hereda la default_transaction_class del elemento InboundClassification. El valor de default_transaction_class es obligatorio en InboundClassification. Este elemento de clasificación también hereda el atributo message_tag de elemento abuelo, "EJBApp1". --> <iiop_classification_info method_name="helloWorld" dispatch_timeout="30" queue_timeout_percent="90" SMF_request_activity_enabled="1" /> <!-- El método goodbyeWorld especifica un valor para dispatch_timeout de 60 segundos. El elemento de clasificación también define un valor para transaction_class, "TC1gbye", que altera temporalmente el valor de transaction_class definido en su ancestro. Este elemento hereda el valor de message_tag de sus ancestros, "EJBApp1". --> <iiop_classification_info method_name="goodbyeWorld" transaction_class="TC1gbye" dispatch_timeout="60" /> </iiop_classification_info> </iiop_classification_info> <!-- Información de clasificación de IIOP para la apl. "EJBApp2". El elemento de clasificación define un dispatch_timeout de 15 segundos y un message_tag de "EJBApp2". El transaction_class se hereda de default_transaction_class de InboundClassification, "TC". Todas las solicitudes clasificadas bajo este elemento de clasificación tienen un tiempo de espera de asignación de 15 segundos y todos los registros de rastreo y mensajes de registro generados por estas solicitudes se marcan con el valor del atributo message_tag, "EJBApp2". --> <iiop_classification_info application_name="EJBApp2" dispatch_timeout="15" message_tag="EJBApp2"> <!-- EJBApp2 contiene dos módulos jar, "MyEJB2a.jar" y "MyEJB2b.jar". Los siguientes dos elementos de clasificación definen una transaction_class para cada módulo jar. No se define ningún otro atributo. Ambos elementos heredan los atributos de sus nodos ancestro (dispatch_timeout="15" y 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> <!-- El elemento de clasificación siguiente define atributos para un módulo, componente y método específicos de la aplicación "EJBApp3". El módulo es "MyEJB3.jar", el componente es "MyEJB3Class" y el método es "method3". transaction_class, dispatch_timeout queue_timeout_percent, SMF_request_activity_enabled y SMF_request_activity_timestamps están definidos para este método específico en la aplicación EJBApp3. No se ha asignado estos atributos a ningún otro método ni EJB de esta aplicación. --> <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 Classification Rules --> <InboundClassification type="internal" schema_version="1.0" default_transaction_class="internal" /> <!-- HTTP Classification Rules --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="HTC"> <!-- El siguiente elemento de clasificación define un valor de transaction_class, "HTC8080", para todas las solicitudes HTTP recibidas en el host "my.server.com" y el puerto "8080". El elemento de clasificación define también los atributos RAS dispatch_timeout, queue_timeout_percent, timeout_recovery y stalled_thread_dump_action. Todos los elementos hijo bajo este elemento heredan estos atributos 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"> <!-- El elemento de clasificación siguiente se aplica a todas las solicitudes HTTP con un URI que empieza por "/PlantsByWebSphere/". Todas las solicitudes HTTP recibidas en el host my.server.com y el puerto 8080 con un URI que empieza por /PlantsByWebSphere van en esta clasificación (nota: host y puerto heredados del elemento padre). El elemento de clasificación también define el atributo message_tag, "plantsbw", que se añade a todos los registros de rastreo y mensajes de registro generados por las solicitudes /PlantsByWebSphere/*. --> <http_classification_info uri="/PlantsByWebSphere/*" message_tag="plantsbw"> <!-- El elemento de clasificación siguiente se aplica a todas las solicitudes HTTP con un URI que coincida con "/PlantsByWebSphere/*.jpg (por ejemplo, /PlantsByWebSphere/mypic.jpg, /PlantsByWebSphere/some/path/anotherpic.jpg). De nuevo, este filtro sólo se aplica a las solicitudes recibidas en el host my.server.com y en el puerto 8080 (tal como indica un nodo ancestro). El elemento de clasificación siguiente define una transaction_class, "HTCPjpg" y un dispatch_timeout, "10". Hereda los atributos restantes de de sus nodos ancestro. --> <http_classification_info uri="*.jpg" transaction_class="HTCPjpg" dispatch_timeout="10" /> <!-- El elemento de clasificación siguiente se aplica a todas las solicitudes HTTP con un URI que coincida con "/PlantsByWebSphere/*.html (por ejemplo, /PlantsByWebSphere/index.html, /PlantsByWebSphere/some/path/afile.html). --> <http_classification_info uri="*.html" transaction_class="HTChtml" /> </http_classification_info> </http_classification_info> <!-- El siguiente elemento de clasificación define un valor de transaction_class, "HTC80", para todas las solicitudes HTTP recibidas en el puerto "80". El atributo de host no está definido; así pues, este elemento coincide con cualquier host. --> <http_classification_info port="80" transaction_class="HTC80" dispatch_timeout="60" timeout_recovery="servant" message_tag="vanilla" /> </InboundClassification> <!-- MDB Classification Rules --> <InboundClassification type="mdb" schema_version="1.0" default_transaction_class="mdbdflt"> <!-- Endpoint for LP 1414, skLP1, for MDB Plan 'A' Test --> <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 Classification Rules --> <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:
El DTD siguiente define los elementos y atributos utilizados en el documento de ejemplo anterior de clasificación de cargas de trabajo.
<?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*)> <!-- inputs --> <!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> <!-- outputs --> <!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> <!-- inputs --> <!ATTLIST classificationentry selector CDATA #REQUIRED> <!ATTLIST classificationentry description CDATA #IMPLIED> <!-- outputs --> <!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*)> <!-- inputs --> <!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> <!-- outputs --> <!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> <!-- inputs --> <!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> <!-- outputs --> <!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> <!-- inputs --> <!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> <!-- outputs --> <!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>
Ejemplo de clasificación de una solicitud de entrada HTTP:
Utilice la solicitud http siguiente con el ejemplo descrito anteriormente de documento de clasificación de cargas de trabajo de z/OS que contiene atributos RAS:
http://my.server.com:8080/PlantsByWebSphere/plants/newOrder.html
Puesto que esta solicitud es una solicitud HTTP, el servidor de aplicaciones sólo explora los elementos http_classification_info. El servidor de aplicaciones explora los elementos en el orden en que se encuentran en el archivo de clasificación de cargas de trabajo.
<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">
Este elemento
tiene atributos de entrada y los valores
host="my.server.com" y port="8080".
Dado
que estos atributos coinciden con la solicitud HTTP de entrada, el
servidor de aplicaciones desciende a este elemento y compara los nodos
hijo. El servidor de aplicaciones encuentra el elemento hijo siguiente: <http_classification_info
uri="/PlantsByWebSphere/*"
message_tag="plantsbw">
El elemento hijo define el
atributo de entrada y el valor
uri="/PlantsByWebSphere/*", que coincide con el URI de la
solicitud entrante. A continuación, el servidor de aplicaciones
explora los hijos del elemento. El servidor de aplicaciones encuentra el primer elemento hijo: <http_classification_info
uri="*.jpg"
transaction_class="HTCPjpg"
dispatch_timeout="10"
/>
Este elemento hijo contiene el atributo y valor
uri="*.jpg". Dado que esta pareja de atributo-valor no
coincide con el URI de entrada, el servidor de aplicaciones pasa al
elemento hijo siguiente. El servidor de aplicaciones encuentra el segundo
elemento hijo: <http_classification_info
uri="*.html"
transaction_class="HTChtml"
/>
Este elemento hijo contiene el atributo y valor
uri="*.html", que coincide con el URI de entrada.dispatch_timeout="100"
queue_timeout_percent="98"
timeout_recovery="session"
stalled_thread_dump_action="javacore"
message_tag="plantsbw"
transaction_class="HTChtml"
El servidor de aplicaciones lee
en la configuración de servidores los atributos RAS no definidos en el
archivo de clasificación de cargas de trabajo y los asigna a la
solicitud.
Las propiedades relevantes de configuración de servidores, incluidas las
que los datos de clasificación han modificado, están en la lista
siguiente: protocol_http_timeout_output -- overridden by dispatch_timeout
control_region_http_queue_timeout_percent -- alterada temporalmente por queue_timeout_percent
com.ibm.CORBA.RequestTimeout
server_region_http_stalled_thread_dump_action -- alterada temporalmente por 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 -- alterada temporalmente por timeout_recovery
Para cualquier propiedad de configuración, a nivel de servidor, que los datos de clasificación no alteren temporalmente, la solicitud hereda el valor de la propiedad a nivel de servidor.Ejemplo de clasificación de una solicitud de entrada IIOP:
Utilice la solicitud IIOP siguiente con el ejemplo descrito anteriormente de documento de clasificación de cargas de trabajo de z/OS que contiene atributos RAS:
Solicitud IIOP entrante para MyEJB2bBean.someMethod() en el módulo MyEJB2b.jar desde la aplicación EJBApp2.
<iiop_classification_info
application_name="EJBApp1"
transaction_class="TC1"
message_tag="EJBApp1">
Este elemento tiene el atributo y
valor de entrada application_name="EJBApp1". El nombre de
aplicación EJBApp1 en el atributo application_name no coincide con el nombre de
aplicación EJBApp2 de la solicitud de entrada. Por lo tanto, el servidor
de aplicaciones ignora este elemento de clasificación y todos sus
elementos hijo, y pasa al siguiente elemento. El servidor de aplicaciones
encuentra el siguiente elemento: <iiop_classification_info
application_name="EJBApp2"
dispatch_timeout="15"
message_tag="EJBApp2">
Este elemento tiene el atributo y
valor de entrada application_name="EJBApp2". Puesto que
esta pareja atributo-valor coincide con el nombre de la
aplicación de la solicitud de entrada, el escáner desciende a este
elemento. El servidor de aplicaciones encuentra el primer elemento hijo: <iiop_classification_info
module_name="MyEJB2a.jar"
transaction_class="TC2a"
/>
Este elemento contiene el atributo y valor de entrada
module_name="MyEJB2a.jar". Dado que este par atributo-valor no coincide
con el nombre de módulo MyEJB2b.jar de la solicitud entrante,
el servidor de aplicaciones explora el siguiente elemento hijo: <iiop_classification_info
module_name="MyEJB2b.jar"
transaction_class="TC2b"
/>
Este elemento contiene el atributo y valor
module_name="MyEJB2b.jar".
El nombre de módulo
MyEJB2b.jar en el atributo module_name coincide con el nombre de
módulo de la solicitud de entrada. Dado que no existen más elementos hijo,
el servidor de aplicaciones clasifica la
solicitud en este elemento. La solicitud hereda todos los atributos de
salida de este elemento y de todos los elementos ancestros. Las siguientes
parejas atributo-valor son una lista completa de parejas de atributo-valor
de salida que el servidor de aplicaciones asigna a la solicitud: dispatch_timeout="15"
message_tag="EJBApp2"
transaction_class="TC2b"
El servidor de aplicaciones lee
en la configuración de servidores los atributos RAS no definidos en el
archivo de clasificación de cargas de trabajo y los asigna a la
solicitud.
Las propiedades relevantes de configuración de servidores, incluidas las
que los datos de clasificación han modificado, están en la lista
siguiente: 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
Para cualquier propiedad de configuración, a nivel de servidor, que los datos de clasificación no alteren temporalmente, la solicitud hereda el valor de la propiedad a nivel de servidor.