![[z/OS]](../images/ngzos.gif)
Arquivo de Classificação de Carga de Trabalho
O documento de classificação de carga de trabalho é um arquivo XML comum que classifica o trabalho de entrada de HTTP, IIOP e message-driven bean (MDB), Session Initiation Protocol (SIP), adaptador local otimizado e de mediação para o gerenciador de carga de trabalho do z/OS.
Notas sobre a Utilização
Este tópico contém exemplos do arquivo de classificação de carga de trabalho com e sem atributos Reliability Availability and Serviceability (RAS). Atributos RAS permitem atingir a granularidade de RAS em nível de pedido para pedidos de HTTP, IIOP, MDB e de adaptador local otimizado. Você especifica esses atributos nos elementos http_classification_info element, iiop_classification_info, classificationentry, sib_classification_info, wmqra_classification_info e ola_classification_info no arquivo de classificação de carga de trabalho.
Você usa o arquivo de classificação de carga de trabalho quando conclui as tarefas para classificar a carga de trabalho do z/OS ou ativar a granularidade de RAS em nível de pedido.
Elementos Necessários
- <?xml version="1.0" encoding="UTF-8"?>
- Indica que o documento de classificação de carga de trabalho deve ser salvo em ASCII para ser processado pelo servidor de aplicativos. Esta instrução é exigida.
- <!DOCTYPE Classification SYSTEM "Classifications.dtd">
- Fornece ao analisador XML o nome do documento DTD fornecido com o produto e que é utilizado para validar o documento de classificação de carga de trabalho. O documento de classificação de carga de trabalho que for criado deve seguir as regras que são descritas nesse DTD. É preciso incluir esta instrução no documento de classificação de carga de trabalho.
- Classificação
- <Classification schema_version="1.0">
Indica a raiz do documento de classificação de carga de trabalho. Todos os documentos de classificação de carga de trabalho devem começar e terminar com este elemento. O atributo schema_version é exigido. A única schema_version suportada é 1.0. O elemento Classification contém um ou mais elementos InboundClassification. Para trabalho de integração de serviços de entrada, o elemento Classification pode conter também até dois elementos SibClassification. Se classificar mensagens de entrada para entrega em beans acionados por mensagens utilizando as especificações de ativação do provedor de sistemas de mensagens do WebSphere MQ, o elemento Classificação poderá conter um ou mais 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>
Utilize as seguintes regras quando utilizar o elemento InboundClassification:
- O atributo type é exigido. O valor deve ser internal, iiop, http, mdb, sip, ou ola. Somente uma ocorrência de um elemento InboundClassification pode ocorrer no documento para cada tipo. Pode haver até cinco elementos InboundClassification em um documento. Os tipos não precisam ser especificados em uma ordem determinada no documento de classificação.
- O atributo schema_version é exigido. O valor deve ser definido como 1.0.
- O atributo default_transaction_class deve ser especificado, e define a classe de transação padrão para fluxos de trabalho do tipo especificado. O valor da cadeia deve ser uma classe de transação WLM válida, uma cadeia nula (tal como "") ou uma cadeia que contenha oito ou menos espaços em branco (tal como " ").
- Os elementos InboundClassification não podem ser aninhados. Cada elemento InboundClassification deve terminar antes que o próximo elemento InboundClassification ou SibClassification possa começar.
- O atributo default_iiop_application_name é opcional e define o nome do aplicativo padrão para fluxos de trabalho IIOP que não têm um nome de aplicativo, nome de módulo ou nome de componente.
- O atributo default_iiop_module_name é opcional e define o nome do módulo padrão para fluxos de trabalho IIOP que não têm um nome de aplicativo, nome de módulo ou nome de componente.
- O atributo default_iiop_component_name é opcional e define o nome do componente padrão para fluxos de trabalho IIOP que não têm um nome de aplicativo, nome de módulo ou nome de componente.
- As solicitações CORBA são um fluxo de trabalho IIOP que não tem um nome de aplicativo, nome de módulo ou nome de componente.
- SibClassification
- <SibClassification type="jmsra | destinationmediation" schema_version="1.0"
default_transaction_class="value">
Utilize as seguintes regras quando utilizar o elemento SibClassification:
- O atributo type é exigido. O valor deve ser jmsra ou destinationmediation. Pode haver no máximo um elemento SibClassification no documento para cada tipo. Os tipos não precisam ser especificados em uma ordem determinada no documento de classificação.
- O atributo schema_version é exigido. O valor deve ser definido como 1.0.
- O atributo default_transaction_class deve ser especificado, e define a classe de transação padrão para fluxos de trabalho do tipo especificado. O valor da sequência deve ser uma classe de transação WLM válida, uma sequência nula (tal como "") ou uma sequência que contenha oito ou menos espaços em branco (tal como " ").
- Os elementos SibClassification não podem ser aninhados. Cada elemento SibClassification deve terminar antes que o próximo elemento InboundClassification ou SibClassification possa começar.
- WMQRAClassification
- <WMQRAClassification schema_version=”1.0”
default_transaction_class=”value”>As regras a seguir se aplicam ao elemento WMQRAClassification:
- O atributo schema_version é exigido. O valor deve ser definido como 1.0.
- O atributo default_transaction_class deve ser especificado, e define a classe de transação padrão para fluxos de trabalho do tipo especificado. O valor de cadeia deve ser uma classe de transação WLM válida.
- Os elementos WMQRAClassification não podem ser aninhados. Cada elemento WMQRAClassification deve ser finalizado antes que qualquer outro elemento de classificação possa ser iniciado.
As regras e instruções XML para classificar tipos diferentes de trabalho são semelhantes, mas existe uma sintaxe levemente diferente para cada tipo. Para obter informações adicionais sobre a sintaxe para cada tipo de trabalho, consulte as seguintes seções:- InboundClassification
- SibClassification
- WMQRAClassification
Classificação Interna
O elemento InboundClassification com o atributo type="internal" define a seção do documento que é aplicável ao trabalho interno, como os pedidos que são despachados em um servant, originados no controlador próprio. Um exemplo deste elemento é mostrado a seguir:
<InboundClassification type="internal" schema_version="1.0"
default_transaction_class="value1">
Se um elemento InboundClassification com o atributo type="internal" não for especificado, o trabalho interno será classificado utilizando-se as regras especificadas para o trabalho IIOP.
Classificação IIOP
O elemento InboundClassification com o atributo type="iiop" define a seção do documento que é aplicável à classificação IIOP. Um exemplo deste elemento é mostrado a seguir:
<InboundClassification type="iiop" schema_version="1.0"
default_transaction_class="value1">
- Nome do aplicativo
O nome do aplicativo que contém os enterprise beans. Ele é o nome de exibição do aplicativo, que pode não ser o nome do arquivo .ear que contém todos os artefatos.
- Nome do Módulo
O nome do arquivo .jar de Enterprise JavaBeans (EJB) que contém um ou mais enterprise beans. Pode haver vários arquivos .jar de EJB em um arquivo .ear.
- Nome do Componente
O nome do EJB que está contido em um módulo (ou arquivo .jar de EJB). Pode haver um ou mais enterprise beans contidos em um arquivo .jar.
- Nome do Método
O nome de um método remoto em um EJB.
Classifique o trabalho IIOP em diversos aplicativos em qualquer destes níveis utilizando o 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">
Com o elemento iiop_classification_info, é possível construir filtros com base nos nomes do aplicativo, módulo, componente e método para designar valores TCLASS, atributos RAS ou ambos para pedidos de entrada. Utilize as seguintes regras ao utilizar o elemento iiop_classification_info:
- transaction_class
- O atributo transaction_class é opcional. Se o atributo não estiver definido, ele herda a classe de transação de seu pai. O valor da cadeia deve ser uma classe de transação WLM válida, uma cadeia nula (tal como "") ou uma cadeia que contenha oito ou menos espaços em branco (tal como " "). Especificando uma cadeia nula ou em branco, é possível substituir uma configuração de TCLASS padrão ou uma configuração de TCLASS que foi designada por um filtro de nível mais alto. Especificar uma cadeia nula ou em branco significa que você não tem um valor de TCLASS para o pedido.
- application_name, module_name, component_name, and method_name
- Os atributos application_name, module_name, component_name e method_name
podem ser utilizados conforme necessário. Esses atributos agem como seletores ou filtros
que designam uma classe de transação ou permitem que um elemento iiop_classification_info
aninhado seja designado à classe de transação. É possível especificar os valores desses atributos das seguintes maneiras:
- O nome exato do aplicativo, módulo, componente ou método.
- Um valor curinga. É possível inserir um asterisco (*)
em qualquer lugar em uma cadeia para indicar que qualquer cadeia que iniciar com a cadeia
precedente ao asterisco e terminar com a cadeia que segue o asterisco
será considerada uma correspondência. Se o asterisco estiver no fim da cadeia, qualquer cadeia
que iniciar com a cadeia precedente ao asterisco será considerada uma correspondência.Exemplos:
- A cadeia Mar*61 corresponde a Mar61, March61 e Mar20early61, mas não corresponde a March81 ou MAR61.
- A cadeia MAR* corresponde a MARCH, MAR61 e MARS, mas não corresponde a Mar61 ou MAY61.
Evitar Problemas: As comparações de valores que são executadas fazem distinção entre maiúsculas e minúsculas.gotcha
É possível utilizar qualquer combinação desses atributos para fazer um filtro de classificação. No entanto, use apenas a granularidade que for necessária. Por exemplo, se houver somente um aplicativo no servidor de aplicativos, as regras de classificação não necessitam especificar o atributo application_name.
Atributos RAS
É possível especificar os seguintes atributos RAS no elemento iiop_classification_info. Elementos aninhados herdam os atributos RAS do elemento-pai. Elementos aninhados podem substituir os atributos RAS de um elemento-pai. Todos os atributos RAS são opcionais.
- dispatch_timeout
Especifica a quantidade de tempo que uma região de controle aguarda após despachar uma solicitação para a fila do WLM. Se a região de controle não receber uma resposta no tempo especificado, ela emitirá um tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica o tempo limite da fila do WLM como uma porcentagem do tempo limite de dispatch. O intervalo para a porcentagem é 0 - 99. O tempo limite da fila é a quantidade de tempo que um pedido pode permanecer na fila do WLM sem dispatch antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica o valor de tempo limite em segundos aplicado em pedidos de saída que se originam sob pedidos com dispatch. O pedido com dispatch é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de dispatch especificado no atributo dispatch_timeout. O pedido é um pedido que o elemento de classificação classificou. Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica o tempo limite de CPU em milissegundos. O tempo limite de CPU é a quantidade de tempo de CPU permitida para o pedido antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de CPU especificado no atributo cputimeused_limit. O pedido é um pedido que o elemento de classificação classificou.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica em segundos o intervalo do Dispatch Progress Monitor (DPM). O monitor do DPM aciona a ação dump do DPM no intervalo para pedidos que o elemento de classificação classificou. Especifique a ação dump do DPM no atributo dpm_dump_action.
O atributo não substitui nenhuma propriedade do servidor. Você deve usar o comando de modificação para ativar intervalos do DPM extensivos ao servidor.
- dpm_dump_action
Especifica a ação dump do DPM que é adotada em todos os intervalos do DPM para pedidos que o elemento de classificação classifica. Especifique o intervalo de DPM no atributo dpm_interval.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica se os registros System Management Facilities (SMF) 120 de subtipo 9 são coletados para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica se serão formatados os registros de data e hora em formato legível para o ser humano no registro SMF 120 de subtipo 9 para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica se a seção de dados de segurança do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica se a seção de análise de uso de CPU do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica se serão gerados registros de rastreio para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo não substitui nenhuma propriedade do servidor. O comando de modificação TRACERECORD substitui o classification_only_trace.
Se algum elemento de classificação tiver classification_only_trace configurado como 1, o rastreio do nível de classificação está em vigor para o servidor de aplicativos. Os únicos encadeamentos que geram registros de rastreio são encadeamentos que processam pedidos que um elemento de classificação classifica. Esse elemento de classificação deve definir classification_only_trace="1". Qualquer encadeamento que não estiver processando esse pedido tem a coleta de rastreamento desativada e não gera registros de rastreio.
Se nenhum elemento de classificação define classification_only_trace="1", o rastreio do nível de classificação não está em vigor para o servidor de aplicativos. O servidor não desativa a coleta de rastreio para nenhum encadeamento. Todos os registros de rastreio são gravados para saída conforme determinado pela especificação de rastreio.
O atributo classification_only_trace não afeta como uma especificação de rastreio é definida e ativada. O atributo afeta somente quais encadeamentos gravam registros de rastreio.
- message_tag
Especifica um token de cadeia que é impresso com todos os registros de rastreio, mensagens de log e mensagens do sistema gerados para pedidos que o elemento de classificação classifica.
O atributo tem um máximo de oito caracteres.
O atributo não substitui nenhuma propriedade do servidor.
Filtros de classificação- Os elementos iiop_classification_info podem ser aninhados de uma maneira
hierárquica. Aninhando os elementos, é possível criar filtros de classificação que
sejam baseados nos valores dos atributos. O filtro a seguir classifica pedidos
nos enterprise beans EJB1 e EJB2 no aplicativo 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" />
O filtro a seguir também classifica pedidos em EJB1 e EJB2 no aplicativo MyAPP1, mas também classifica pedidos em qualquer outro EJB no aplicativo:
<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>
- Se você especificar um valor de atributo que conflite com o valor de
atributo do elemento-pai, o filtro de nível inferior é negado. Segue
um exemplo de um valor-filho que conflite com o valor de atributo do
elemento-pai:
<iiop_classification_info transaction_class="FAST" application_name="MyAPP1"> <iiop_classification_info transaction_class="SLOW" application_name="MyAPP2" /> </iiop_classification_info>
Nesse exemplo, pedidos de EJB em MyAPP2 nunca seriam designados à classe de transação "SLOW" porque o filtro de nível superior somente permite que pedidos de IIOP para application_name="MyAPP1" sejam transmitidos para o filtro de nível inferior.
- O primeiro filtro em um nível específico que corresponda aos atributos do
pedido é utilizado, não o filtro melhor ou mais restritivo. Portanto, a ordem em que
os filtros são especificados é importante.
<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>
No exemplo anterior, todos os pedidos IIOP que são processados por enterprise beans no aplicativo MyAPP têm designado um valor de TCLASS de SLOW. Essa designação é feita para qualquer pedido ao corporativo MySSB também. Embora seja designada uma classe de transação para MySSB, o filtro não é aplicado porque o primeiro filtro foi aplicado e foi designado um valor de TCLASS de SLOW. A lista de filtros restantes no mesmo nível é ignorada.
- O campo de descrição é opcional. No entanto, deve-se utilizar uma descrição em todos os elementos iiop_classification_info. A cadeia de descrição é impressa como parte do suporte de comandos do operador para que se possa identificar as regras de classificação que estão sendo utilizadas. Mantenha as descrições razoavelmente curtas porque elas serão exibidas no console do MVS.
Classificação HTTP
O elemento InboundClassification com o atributo type="http" define a seção do documento que é aplicável à classificação HTTP. Um exemplo deste elemento é mostrado a seguir:
<InboundClassification type="http"
schema_version="1.0"
default_transaction_class="value1">
- Nome do Host Virtual
Especifica o nome do host no cabeçalho HTTP para o qual o pedido de entrada está sendo enviado.
- Número da porta
Especifica a porta na qual o catcher HTTP está atendendo.
- URI (Identificador Uniforme de Recursos)
A cadeia que identifica o aplicativo da 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">
Com o elemento http_classification_info, é possível construir filtros com base no host, na porta e na URI para designar valores TCLASS, atributos RAS ou ambos para pedidos de entrada. Utilize as seguintes regras ao utilizar o elemento http_classification_info:
- transaction_class
- O atributo transaction_class é opcional. Se o atributo não estiver definido, ele herda a classe de transação de seu pai. O valor da cadeia deve ser uma classe de transação WLM válida, uma cadeia nula (tal como "") ou uma cadeia que contenha oito ou menos espaços em branco (tal como " "). Especificando uma cadeia nula ou em branco, é possível substituir uma configuração de TCLASS padrão ou uma configuração de TCLASS que foi designada por um filtro de nível mais alto. Especificar uma cadeia nula ou em branco significa que você não tem um valor de TCLASS para o pedido.
- host, porta e uri
- Os atributos de host, porta e uri podem ser utilizados
conforme necessário. Esses
atributos agem como seletores ou filtros que designam uma classe de transação
ou permitem que um elemento http_classification_info aninhado designe a classe
de transação. É possível especificar os valores desses atributos das seguintes maneiras:
- O nome exato do host, da porta ou da URI.
- Qualquer valor. Para especificar uma correspondência com qualquer valor, utilize o símbolo de asterisco *).
- Um valor curinga. É possível inserir um asterisco (*)
em qualquer lugar em uma cadeia para indicar que qualquer cadeia que iniciar com a cadeia
precedente ao asterisco e terminar com a cadeia que segue o asterisco
será considerada uma correspondência. Se o asterisco estiver no fim da cadeia, qualquer cadeia
que iniciar com a cadeia precedente ao asterisco será considerada uma correspondência.Exemplos:
- A cadeia Mar*61 corresponde a Mar61, March61 e Mar20early61, mas não corresponde a March81.
- A cadeia MAR* corresponde a MARCH, MAR61 e MARS, mas não corresponde a Mar61 ou MAY61.
Evitar Problemas: As comparações de valores que são executadas fazem distinção entre maiúsculas e minúsculas.gotcha
Use todos ou qualquer desses atributos para fazer um filtro de classificação. Utilize somente a granularidade que for necessária. Por exemplo, se houver somente um aplicativo no servidor de aplicativos, as regras de classificação não necessitam especificar o atributo uri.
Atributos RAS:
É possível especificar os seguintes atributos RAS no elemento http_classification_info. Elementos aninhados herdam os atributos RAS do elemento-pai. Elementos aninhados podem substituir os atributos RAS de um elemento-pai. Todos os atributos RAS são opcionais.
- dispatch_timeout
Especifica a quantidade de tempo que uma região de controle aguarda após despachar uma solicitação para a fila do WLM. Se a região de controle não receber uma resposta no tempo especificado, ela emitirá um tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui as seguintes propriedades de servidor:- HTTP
- protocol_http_timeout_output
- HTTPS
- protocol_https_timeout_output
- queue_timeout_percent
Especifica o tempo limite da fila do WLM como uma porcentagem do tempo limite de dispatch. O intervalo para a porcentagem é 0 - 99. O tempo limite da fila é a quantidade de tempo que um pedido pode permanecer na fila do WLM sem dispatch antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui as seguintes propriedades de servidor:- HTTP
- control_region_http_queue_timeout_percent
- HTTPS
- control_region_https_queue_timeout_percent
- request_timeout
Especifica o valor de tempo limite em segundos aplicado em pedidos de saída que se originam sob pedidos com dispatch. O pedido com dispatch é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de dispatch especificado no atributo dispatch_timeout. O pedido é um pedido que o elemento de classificação classificou. Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui as seguintes propriedades de servidor:- HTTP
- server_region_http_stalled_thread_dump_action
- HTTPS
- server_region_https_stalled_thread_dump_action
- cputimeused_limit
Especifica o tempo limite de CPU em milissegundos. O tempo limite de CPU é a quantidade de tempo de CPU permitida para o pedido antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de CPU especificado no atributo cputimeused_limit. O pedido é um pedido que o elemento de classificação classificou.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica em segundos o intervalo do Dispatch Progress Monitor (DPM). O monitor do DPM aciona a ação dump do DPM no intervalo para pedidos que o elemento de classificação classificou. Especifique a ação dump do DPM no atributo dpm_dump_action.
O atributo não substitui nenhuma propriedade do servidor. Você deve usar o comando de modificação para ativar intervalos do DPM extensivos ao servidor.
- dpm_dump_action
Especifica a ação dump do DPM que é adotada em todos os intervalos do DPM para pedidos que o elemento de classificação classifica. Especifique o intervalo de DPM no atributo dpm_interval.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica se os registros System Management Facilities (SMF) 120 de subtipo 9 são coletados para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica se serão formatados os registros de data e hora em formato legível para o ser humano no registro SMF 120 de subtipo 9 para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica se a seção de dados de segurança do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica se a seção de análise de uso de CPU do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica se serão gerados registros de rastreio para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo não substitui nenhuma propriedade do servidor. O comando de modificação TRACERECORD substitui o classification_only_trace.
Se algum elemento de classificação tiver classification_only_trace configurado como 1, o rastreio do nível de classificação está em vigor para o servidor de aplicativos. Os únicos encadeamentos que geram registros de rastreio são encadeamentos que processam pedidos que um elemento de classificação classifica. Esse elemento de classificação deve definir classification_only_trace="1". Qualquer encadeamento que não estiver processando esse pedido tem a coleta de rastreamento desativada e não gera registros de rastreio.
Se nenhum elemento de classificação define classification_only_trace="1", o rastreio do nível de classificação não está em vigor para o servidor de aplicativos. O servidor não desativa a coleta de rastreio para nenhum encadeamento. Todos os registros de rastreio são gravados para saída conforme determinado pela especificação de rastreio.
O atributo classification_only_trace não afeta como uma especificação de rastreio é definida e ativada. O atributo afeta somente quais encadeamentos gravam registros de rastreio.
- message_tag
Especifica um token de cadeia que é impresso com todos os registros de rastreio, mensagens de log e mensagens do sistema gerados para pedidos que o elemento de classificação classifica.
O atributo tem um máximo de oito caracteres.
O atributo não substitui nenhuma propriedade do servidor.
- timeout_recovery
Especifica a ação que o servidor utiliza quando um pedido que o elemento de classificação classificou excede seu tempo limite de dispatch. Especifique o tempo limite de dispatch no atributo dispatch_timeout.
Os valores válidos são servant e session.
Quando o atributo estiver configurado como servant, o espaço de endereço do servidor que processa o pedido finaliza com ABEND EC3 e o código de razão 04130007. O espaço de endereço do controlador envia uma resposta de falha ao cliente e, em seguida, fecha o soquete associado com o pedido.
Quando o atributo estiver configurado como session, o espaço de endereço do controlador envia uma resposta de falha ao cliente e, em seguida, fecha o soquete associado com o pedido. O Espaço de endereço do servidor não é finalizado. O pedido não é interrompido, mas em vez disso tem permissão de ser executado até a conclusão.
O atributo substitui as seguintes propriedades de servidor:- HTTP
- protocol_http_timeout_output_recovery
- HTTPS
- protocol_https_timeout_output_recovery
Filtros de Classificação:
- É possível aninhar os elementos http_classification_info de uma maneira hierárquica. Pode-se construir filtros com base em nomes de atributos. Considere os dois filtros a
seguir:
<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 os filtros classificam pedidos para aplicativos da Web que são identificados pelas raízes de contexto /MyWebApp1 e /MyWebApp2 no servidor de aplicativos que está hospedando aplicativos da Web para o host virtual MyVHost1.com. No entanto, o segundo filtro também classifica pedidos em qualquer outra raiz de contexto no servidor de aplicativos.
- Especificar um nome do atributo que é diferente do valor de atributo
do elemento-pai efetivamente nega o filtro de nível inferior.
Por exemplo:
<http_classification_info transaction_class="FAST" uri="/MyWebApp1/*"> <http_classification_info transaction_class="SLOW" uri="/MyWebApp2"> </http_classification_info> </http_classification_info>
Este exemplo nunca resultaria na designação dos aplicativos da Web com uma raiz de contexto /MyWebApp2 para a classe de transação SLOW. O filtro de alto nível somente permite pedidos de HTTP com uma raiz de contexto de /MyWebApp1/* a ser passados para um filtro de nível inferior.
- O primeiro filtro que esteja em um nível específico é utilizado, não o filtro melhor
ou mais restritivo. Portanto, a ordem dos filtros em cada nível
é importante. Por exemplo:
<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>
Neste exemplo, pedidos HTTP processados pelo servidor de aplicativos pelo host virtual "MyVHost.com" têm designado um valor de TCLASS de SLOW. Mesmo os pedidos para o aplicativo da Web com a raiz de contexto /MyWebAppX são designados a um valor TCLASS de SLOW porque o filtro não foi aplicado. O primeiro filtro que corresponda é utilizado para a designação de TCLASS, e os filtros restantes no mesmo nível são ignorados.
- O campo de descrição é opcional, porém deve ser utilizado em todos os elementos http_classification_info. A descrição é exibida ao monitorar as classes de transação no console do MVS.
Classificação MDB
<InboundClassification type="mdb"
schema_version="1.0"
default_transaction_class="qrs">
<endpoint type="messagelistenerport"
name="IPVListenerPort"
defaultclassification="MDBX"
description="ABC">
- O atributo type deve ser sempre igual a messagelistenerport.
- O atributo name corresponde ao listener para o elemento endpoint. O valor do atributo name deve ser o nome da porta listener que é especificada no console de administração para o servidor.
- O elemento defaultclassification é a classe de transação padrão que é associada aos beans orientados a mensagens. O valor deste atributo substitui o valor padrão de classificação de transação.
- O campo de descrição é opcional, porém deve ser utilizado em todos os elementos endpoint. A descrição é exibida ao monitorar as classes de transação no console do 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
- Utilize o atributo selector do elemento classificationentry para designar uma classe de transação para um bean orientado a mensagens que tenha uma cláusula selector em seu descritor de implementação. Utilize as seguintes regras ao definir seus elementos classificationentry:
- O valor do atributo selector deve corresponder exatamente à cláusula selector no descritor de implementação do MDB.
- O valor do atributo selector deve ter a sintaxe correta para um documento XML. Você deve substituir o símbolo < pela referência de entidade < e o símbolo final > pela referência de entidade >. De forma semelhante, se você utilizar um apóstrofo ou aspas, utilize as referências de entidade ' e ".
- classificação
O atributo de classificação é opcional. Se o atributo não estiver definido, ele herda a classificação de seu pai. O valor da cadeia deve ser uma classe de transação WLM válida, uma cadeia nula (tal como "") ou uma cadeia que contenha oito ou menos espaços em branco (tal como " "). Especificando uma cadeia nula ou em branco, é possível substituir uma configuração de TCLASS padrão ou uma configuração de TCLASS que foi designada por um filtro de nível mais alto. Especificar uma cadeia nula ou em branco significa que você não tem um valor de TCLASS para o pedido.
Atributos RAS:
É possível especificar os seguintes atributos RAS no elemento classificationentry. Elementos aninhados herdam os atributos RAS do elemento-pai. Elementos aninhados podem substituir os atributos RAS de um elemento-pai. Todos os atributos RAS são opcionais.
- dispatch_timeout
Especifica a quantidade de tempo que uma região de controle aguarda após despachar uma solicitação para a fila do WLM. Se a região de controle não receber uma resposta no tempo especificado, ela emitirá um tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_mdb_request_timeout.
- queue_timeout_percent
Especifica o tempo limite da fila do WLM como uma porcentagem do tempo limite de dispatch. O intervalo para a porcentagem é 0 - 99. O tempo limite da fila é a quantidade de tempo que um pedido pode permanecer na fila do WLM sem dispatch antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_mdb_queue_timeout_percent.
- request_timeout
Especifica o valor de tempo limite em segundos aplicado em pedidos de saída que se originam sob pedidos com dispatch. O pedido com dispatch é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de dispatch especificado no atributo dispatch_timeout. O pedido é um pedido que o elemento de classificação classificou. Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_mdb_stalled_thread_dump_action.
- cputimeused_limit
Especifica o tempo limite de CPU em milissegundos. O tempo limite de CPU é a quantidade de tempo de CPU permitida para o pedido antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de CPU especificado no atributo cputimeused_limit. O pedido é um pedido que o elemento de classificação classificou.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica em segundos o intervalo do Dispatch Progress Monitor (DPM). O monitor do DPM aciona a ação dump do DPM no intervalo para pedidos que o elemento de classificação classificou. Especifique a ação dump do DPM no atributo dpm_dump_action.
O atributo não substitui nenhuma propriedade do servidor. Você deve usar o comando de modificação para ativar intervalos do DPM extensivos ao servidor.
- dpm_dump_action
Especifica a ação dump do DPM que é adotada em todos os intervalos do DPM para pedidos que o elemento de classificação classifica. Especifique o intervalo de DPM no atributo dpm_interval.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica se os registros System Management Facilities (SMF) 120 de subtipo 9 são coletados para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica se serão formatados os registros de data e hora em formato legível para o ser humano no registro SMF 120 de subtipo 9 para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica se a seção de dados de segurança do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica se a seção de análise de uso de CPU do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica se serão gerados registros de rastreio para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo não substitui nenhuma propriedade do servidor. O comando de modificação TRACERECORD substitui o classification_only_trace.
Se algum elemento de classificação tiver classification_only_trace configurado como 1, o rastreio do nível de classificação está em vigor para o servidor de aplicativos. Os únicos encadeamentos que geram registros de rastreio são encadeamentos que processam pedidos que um elemento de classificação classifica. Esse elemento de classificação deve definir classification_only_trace="1". Qualquer encadeamento que não estiver processando esse pedido tem a coleta de rastreamento desativada e não gera registros de rastreio.
Se nenhum elemento de classificação define classification_only_trace="1", o rastreio do nível de classificação não está em vigor para o servidor de aplicativos. O servidor não desativa a coleta de rastreio para nenhum encadeamento. Todos os registros de rastreio são gravados para saída conforme determinado pela especificação de rastreio.
O atributo classification_only_trace não afeta como uma especificação de rastreio é definida e ativada. O atributo afeta somente quais encadeamentos gravam registros de rastreio.
- message_tag
Especifica um token de cadeia que é impresso com todos os registros de rastreio, mensagens de log e mensagens do sistema gerados para pedidos que o elemento de classificação classifica.
O atributo tem um máximo de oito caracteres.
O atributo não substitui nenhuma propriedade do servidor.
Classificação do Adaptador Local Otimizado
O elemento InboundClassification com o atributo type="ola" define a seção do documento que é aplicável à classificação do adaptador local otimizado. Um exemplo deste elemento é mostrado a seguir:
<InboundClassification type="ola" schema_version="1.0"
default_transaction_class="value1"
>
É possível classificar o trabalho do adaptador local otimizado incluindo uma seção para cada aplicativo EJB que usa o nome do serviço ou o nome de início da Java Naming and Directory Interface (JNDI). É possível usar um curinga para o nome de início da JNDI.
Classifique o trabalho do adaptador local otimizado em vários aplicativos em qualquer desses níveis usando o 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">
Com o elemento ola_classification_info, é possível construir filtros com base no nome do serviço ou da JNDI. Use o nome para designar valores TCLASS, atributos RAS ou ambos para pedidos de entrada. Use as seguintes regras ao usar o elemento the ola_classification_info:
- transaction_class
- O atributo transaction_class é opcional. Se o atributo não estiver definido, ele herda a classe de transação de seu pai. O valor da cadeia deve ser uma classe de transação WLM válida, uma cadeia nula (tal como "") ou uma cadeia que contenha oito ou menos espaços em branco (tal como " "). Especificando uma cadeia nula ou em branco, é possível substituir uma configuração de TCLASS padrão ou uma configuração de TCLASS que foi designada por um filtro de nível mais alto. Especificar uma cadeia nula ou em branco significa que você não tem um valor de TCLASS para o pedido.
- propagate_transaction_name
- O atributo propagate_transaction_name é opcional. Se o atributo for especificado, o valor de cadeia deve ser true ou false. Especificando um valor true, a classe de serviço do WLM do Customer Information Control System (CICS) é propagada para o servidor de aplicativos em cada pedido ou em cada pedido correspondente se o filtro service_name for especificado. O trabalho despachado no servidor de aplicativos através do adaptador local otimizado é executado sob a mesma classe de serviço que o pedido do cliente.
- service_name
- O atributo service_name é opcional. Esse atributo age como
um seletor ou filtro que designa uma classe de transação ou permite
que um elemento ola_classification_info aninhado designe a classe
de transação. É possível especificar os valores desse atributo das seguintes
maneiras:
- O nome do serviço ou o nome de início da JNDI exato do aplicativo EJB a ser orientado.
- Um valor curinga. É possível colocar um asterisco (*) em qualquer lugar em uma
cadeia para indicar que qualquer cadeia que iniciar com a cadeia precedente
ao asterisco e terminar com a cadeia que segue o asterisco será
considerada uma correspondência. Se o asterisco estiver no fim da cadeia, qualquer cadeia
que iniciar com a cadeia precedente ao asterisco será considerada uma correspondência. Exemplos:
- service_name="ejb/mySecondBean"
- service_name="ejb/my*Bean"
- service_name="ejb/my*"
- service_name="ejb/security/*"
CUIDADO:As comparações de valores que o servidor de aplicativos executa fazem distinção entre maiúsculas e minúsculas.
Atributos RAS
É possível especificar os seguintes atributos RAS no elemento ola_classification_info. Elementos aninhados herdam os atributos RAS do elemento-pai. Elementos aninhados podem substituir os atributos RAS de um elemento-pai. Todos os atributos RAS são opcionais.
- dispatch_timeout
Especifica a quantidade de tempo que uma região de controle aguarda após despachar uma solicitação para a fila do WLM. Se a região de controle não receber uma resposta no tempo especificado, ela emitirá um tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica o tempo limite da fila do WLM como uma porcentagem do tempo limite de dispatch. O intervalo para a porcentagem é 0 - 99. O tempo limite da fila é a quantidade de tempo que um pedido pode permanecer na fila do WLM sem dispatch antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica o valor de tempo limite em segundos aplicado em pedidos de saída que se originam sob pedidos com dispatch. O pedido com dispatch é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de dispatch especificado no atributo dispatch_timeout. O pedido é um pedido que o elemento de classificação classificou. Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica o tempo limite de CPU em milissegundos. O tempo limite de CPU é a quantidade de tempo de CPU permitida para o pedido antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de CPU especificado no atributo cputimeused_limit. O pedido é um pedido que o elemento de classificação classificou.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica em segundos o intervalo do Dispatch Progress Monitor (DPM). O monitor do DPM aciona a ação dump do DPM no intervalo para pedidos que o elemento de classificação classificou. Especifique a ação dump do DPM no atributo dpm_dump_action.
O atributo não substitui nenhuma propriedade do servidor. Você deve usar o comando de modificação para ativar intervalos do DPM extensivos ao servidor.
- dpm_dump_action
Especifica a ação dump do DPM que é adotada em todos os intervalos do DPM para pedidos que o elemento de classificação classifica. Especifique o intervalo de DPM no atributo dpm_interval.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica se os registros System Management Facilities (SMF) 120 de subtipo 9 são coletados para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica se serão formatados os registros de data e hora em formato legível para o ser humano no registro SMF 120 de subtipo 9 para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica se a seção de dados de segurança do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica se a seção de análise de uso de CPU do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica se serão gerados registros de rastreio para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo não substitui nenhuma propriedade do servidor. O comando de modificação TRACERECORD substitui o classification_only_trace.
Se algum elemento de classificação tiver classification_only_trace configurado como 1, o rastreio do nível de classificação está em vigor para o servidor de aplicativos. Os únicos encadeamentos que geram registros de rastreio são encadeamentos que processam pedidos que um elemento de classificação classifica. Esse elemento de classificação deve definir classification_only_trace="1". Qualquer encadeamento que não estiver processando esse pedido tem a coleta de rastreamento desativada e não gera registros de rastreio.
Se nenhum elemento de classificação define classification_only_trace="1", o rastreio do nível de classificação não está em vigor para o servidor de aplicativos. O servidor não desativa a coleta de rastreio para nenhum encadeamento. Todos os registros de rastreio são gravados para saída conforme determinado pela especificação de rastreio.
O atributo classification_only_trace não afeta como uma especificação de rastreio é definida e ativada. O atributo afeta somente quais encadeamentos gravam registros de rastreio.
- message_tag
Especifica um token de cadeia que é impresso com todos os registros de rastreio, mensagens de log e mensagens do sistema gerados para pedidos que o elemento de classificação classifica.
O atributo tem um máximo de oito caracteres.
O atributo não substitui nenhuma propriedade do servidor.
Filtros de Classificação:- Os elementos ola_classification_info elements podem ser aninhados de uma maneira
hierárquica. Aninhando os elementos, é possível criar filtros de classificação que
sejam baseados nos valores dos atributos.
<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>
- O campo de descrição é opcional. No entanto, use uma descrição em todos os elementos ola_classification_info. A cadeia de descrição é impressa como parte do suporte de comandos do operador para que se possa identificar as regras de classificação que estão sendo utilizadas. Mantenha as descrições razoavelmente curtas porque elas serão exibidas no console do MVS.
Classificação SIP
O elemento InboundClassification com o atributo type="sip" define a seção do documento que configura a classe de transação padrão para pedidos de SIP (Session Initiation Protocol). Um exemplo deste elemento é mostrado a seguir:
<InboundClassification type="sip" schema_version="1.0"
default_transaction_class="value1">
Classificação RA 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="Algumas palavras"
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
- Utilize o atributo selector do elemento sib_classification_info para designar
uma classe de transação para um bean orientado a mensagens que tenha uma cláusula selector em
seu descritor de implementação. Utilize as seguintes regras ao definir seus
elementos sib_classification_info:
- O valor do atributo selector é uma expressão SQL que seleciona uma mensagem de acordo aos valores das propriedades da mensagem. A sintaxe é a de um seletor de mensagem na especificação JMS 1.1, mas ela pode operar em mensagens SIMessage (mais que mensagens JMS). A sintaxe pode selecionar em propriedades de sistema (incluindo cabeçalhos JMS, propriedades JMSX e JMS_IBM_properties) e propriedades de usuário (que devem ter o prefixo ".user" - por exemplo, para a propriedade de usuário "Location", o seletor especificaria "user.Location" como é mostrado no exemplo anterior). Para obter informações adicionais, consulte o tópico sobre o trabalho com propriedades de mensagens.
- O valor do atributo selector deve ter a sintaxe correta para um documento XML. Você deve substituir o símbolo < pela referência de entidade < e o símbolo final > pela referência de entidade >. De forma semelhante, se você utilizar um apóstrofo ou aspas, utilize as referências de entidade ' e ".
- barramento
- O nome do barramento de integração de serviços no qual o destino-alvo está designado. A classificação se aplica ao barramento nomeado por esta propriedade, ou a qualquer barramento se ela não for especificada. Os destinos aos quais a classificação aplica-se dependem da utilização da propriedade de destino.
- destination
- O nome do destino do barramento de destino ao qual a mensagem foi entregue. Este é o nome de uma fila ou espaço de tópicos. A classificação se aplica ao destino nomeado por esta propriedade, ou a qualquer destino se ela não for especificada. Os barramentos de integração de serviço aos quais a classificação se aplica dependem do uso da propriedade de barramento.
- discriminator
- A propriedade aplica-se somente quando a propriedade destination nomeia um espaço de tópicos. Este valor de discriminator é então uma expressão de XPath que seleciona um ou mais tópicos dentro do espaço de tópicos.
- descrição
- Embora o campo de descrição seja opcional, ele deve ser utilizado em todos os elementos sib_classification_info. A descrição é exibida ao monitorar as classes de transação no console do MVS.
Atributos RAS
É possível especificar os seguintes atributos RAS no elemento sib_classification_info. Elementos aninhados herdam os atributos RAS do elemento-pai. Elementos aninhados podem substituir os atributos RAS de um elemento-pai. Todos os atributos RAS são opcionais.
- dispatch_timeout
Especifica a quantidade de tempo que uma região de controle aguarda após despachar uma solicitação para a fila do WLM. Se a região de controle não receber uma resposta no tempo especificado, ela emitirá um tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica o tempo limite da fila do WLM como uma porcentagem do tempo limite de dispatch. O intervalo para a porcentagem é 0 - 99. O tempo limite da fila é a quantidade de tempo que um pedido pode permanecer na fila do WLM sem dispatch antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica o valor de tempo limite em segundos aplicado em pedidos de saída que se originam sob pedidos com dispatch. O pedido com dispatch é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de dispatch especificado no atributo dispatch_timeout. O pedido é um pedido que o elemento de classificação classificou. Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica o tempo limite de CPU em milissegundos. O tempo limite de CPU é a quantidade de tempo de CPU permitida para o pedido antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de CPU especificado no atributo cputimeused_limit. O pedido é um pedido que o elemento de classificação classificou.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica em segundos o intervalo do Dispatch Progress Monitor (DPM). O monitor do DPM aciona a ação dump do DPM no intervalo para pedidos que o elemento de classificação classificou. Especifique a ação dump do DPM no atributo dpm_dump_action.
O atributo não substitui nenhuma propriedade do servidor. Você deve usar o comando de modificação para ativar intervalos do DPM extensivos ao servidor.
- dpm_dump_action
Especifica a ação dump do DPM que é adotada em todos os intervalos do DPM para pedidos que o elemento de classificação classifica. Especifique o intervalo de DPM no atributo dpm_interval.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica se os registros System Management Facilities (SMF) 120 de subtipo 9 são coletados para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica se serão formatados os registros de data e hora em formato legível para o ser humano no registro SMF 120 de subtipo 9 para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica se a seção de dados de segurança do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica se a seção de análise de uso de CPU do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica se serão gerados registros de rastreio para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo não substitui nenhuma propriedade do servidor. O comando de modificação TRACERECORD substitui o classification_only_trace.
Se algum elemento de classificação tiver classification_only_trace configurado como 1, o rastreio do nível de classificação está em vigor para o servidor de aplicativos. Os únicos encadeamentos que geram registros de rastreio são encadeamentos que processam pedidos que um elemento de classificação classifica. Esse elemento de classificação deve definir classification_only_trace="1". Qualquer encadeamento que não estiver processando esse pedido tem a coleta de rastreamento desativada e não gera registros de rastreio.
Se nenhum elemento de classificação define classification_only_trace="1", o rastreio do nível de classificação não está em vigor para o servidor de aplicativos. O servidor não desativa a coleta de rastreio para nenhum encadeamento. Todos os registros de rastreio são gravados para saída conforme determinado pela especificação de rastreio.
O atributo classification_only_trace não afeta como uma especificação de rastreio é definida e ativada. O atributo afeta somente quais encadeamentos gravam registros de rastreio.
- message_tag
Especifica um token de cadeia que é impresso com todos os registros de rastreio, mensagens de log e mensagens do sistema gerados para pedidos que o elemento de classificação classifica.
O atributo tem um máximo de oito caracteres.
O atributo não substitui nenhuma propriedade do servidor.
Cada elemento sib_classification_info pode conter uma ou mais dessas propriedades conforme necessário para classificar o trabalho para uma mensagem. Um elemento sib_classification_info não pode conter mais que uma instância de cada propriedade.
<sib_classification_info bus="MyBus" transaction_class="a" />
<sib_classification_info destination="MyDest" transaction_class="b" />
Uma mensagem que chegar no destino MyDest do barramento de integração de serviços MyBus terá designada a classificação "a". Uma mensagem que chegar em MyDest de outro barramento terá designada a classificação "b".
Se uma mensagem não corresponder a nenhum elemento sib_classification_info em um elemento SibClassification envolvente, a mensagem terá designada a classificação padrão do elemento SibClassification.
Se uma mensagem não corresponder a nenhum elemento sib_classification_info em nenhum elemento SibClassification, ou se não houver nenhum elemento SibClassification definido, todo trabalho receberá uma classificação padrão interna com o valor "SIBUS". É necessário executar as ações do z/OS Workload Manager requeridas para utilizar o valor TCLASS "SIBUS", conforme descrito em Classificando a Carga de Trabalho do z/OS.
Classificação de Mediação
<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
- Utilize o atributo selector do elemento sib_classification_info para designar
uma classe de transação para uma mediação que tenha uma cláusula selector em
seu descritor de implementação. Utilize as seguintes regras ao definir seus
elementos sib_classification_info:
- O valor do atributo selector é uma expressão SQL que seleciona uma
mensagem de acordo aos valores das propriedades da mensagem.
A sintaxe é a
de um seletor de mensagem na especificação JMS 1.1, mas ela pode operar
em mensagens SIMessage (mais que mensagens JMS).
A sintaxe pode selecionar em propriedades de sistema (incluindo cabeçalhos JMS, propriedades JMSX e JMS_IBM_properties)
e propriedades de usuário (que devem ter o prefixo ".user" - por exemplo,
para a propriedade de usuário "Location", o seletor especificaria "user.Location" como é mostrado no exemplo anterior).
Para obter informações adicionais, consulte o tópico sobre o trabalho com propriedades de mensagens.
- O valor do atributo selector deve ter a sintaxe correta para um documento XML. Você deve substituir o símbolo < pela referência de entidade < e o símbolo final > pela referência de entidade >. De forma semelhante, se você utilizar um apóstrofo ou aspas, utilize as referências de entidade ' e ".
- O valor do atributo selector é uma expressão SQL que seleciona uma
mensagem de acordo aos valores das propriedades da mensagem.
A sintaxe é a
de um seletor de mensagem na especificação JMS 1.1, mas ela pode operar
em mensagens SIMessage (mais que mensagens JMS).
A sintaxe pode selecionar em propriedades de sistema (incluindo cabeçalhos JMS, propriedades JMSX e JMS_IBM_properties)
e propriedades de usuário (que devem ter o prefixo ".user" - por exemplo,
para a propriedade de usuário "Location", o seletor especificaria "user.Location" como é mostrado no exemplo anterior).
- barramento
- O nome do barramento de integração de serviços no qual o destino-alvo está designado. A classificação se aplica ao barramento nomeado por esta propriedade, ou a qualquer barramento se ela não for especificada. Os destinos aos quais a classificação aplica-se dependem da utilização da propriedade de destino.
- destination
- O nome do destino do barramento de destino ao qual a mensagem foi entregue. Este é o nome de uma fila ou espaço de tópicos. A classificação se aplica ao destino nomeado por esta propriedade, ou a qualquer destino se ela não for especificada. Os barramentos de integração de serviço aos quais a classificação se aplica dependem do uso da propriedade de barramento.
- discriminator
- A propriedade aplica-se somente quando a propriedade destination nomeia um espaço de tópicos. Este valor de discriminator é então uma expressão de XPath que seleciona um ou mais tópicos dentro do espaço de tópicos.
- descrição
- Embora o campo de descrição seja opcional, ele deve ser utilizado em todos os elementos sib_classification_info. A descrição é exibida ao monitorar as classes de transação no console do MVS.
Atributos RAS
É possível especificar os seguintes atributos RAS no elemento sib_classification_info. Elementos aninhados herdam os atributos RAS do elemento-pai. Elementos aninhados podem substituir os atributos RAS de um elemento-pai. Todos os atributos RAS são opcionais.
- dispatch_timeout
Especifica a quantidade de tempo que uma região de controle aguarda após despachar uma solicitação para a fila do WLM. Se a região de controle não receber uma resposta no tempo especificado, ela emitirá um tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica o tempo limite da fila do WLM como uma porcentagem do tempo limite de dispatch. O intervalo para a porcentagem é 0 - 99. O tempo limite da fila é a quantidade de tempo que um pedido pode permanecer na fila do WLM sem dispatch antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica o valor de tempo limite em segundos aplicado em pedidos de saída que se originam sob pedidos com dispatch. O pedido com dispatch é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de dispatch especificado no atributo dispatch_timeout. O pedido é um pedido que o elemento de classificação classificou. Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica o tempo limite de CPU em milissegundos. O tempo limite de CPU é a quantidade de tempo de CPU permitida para o pedido antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de CPU especificado no atributo cputimeused_limit. O pedido é um pedido que o elemento de classificação classificou.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica em segundos o intervalo do Dispatch Progress Monitor (DPM). O monitor do DPM aciona a ação dump do DPM no intervalo para pedidos que o elemento de classificação classificou. Especifique a ação dump do DPM no atributo dpm_dump_action.
O atributo não substitui nenhuma propriedade do servidor. Você deve usar o comando de modificação para ativar intervalos do DPM extensivos ao servidor.
- dpm_dump_action
Especifica a ação dump do DPM que é adotada em todos os intervalos do DPM para pedidos que o elemento de classificação classifica. Especifique o intervalo de DPM no atributo dpm_interval.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica se os registros System Management Facilities (SMF) 120 de subtipo 9 são coletados para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica se serão formatados os registros de data e hora em formato legível para o ser humano no registro SMF 120 de subtipo 9 para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica se a seção de dados de segurança do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica se a seção de análise de uso de CPU do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica se serão gerados registros de rastreio para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo não substitui nenhuma propriedade do servidor. O comando de modificação TRACERECORD substitui o classification_only_trace.
Se algum elemento de classificação tiver classification_only_trace configurado como 1, o rastreio do nível de classificação está em vigor para o servidor de aplicativos. Os únicos encadeamentos que geram registros de rastreio são encadeamentos que processam pedidos que um elemento de classificação classifica. Esse elemento de classificação deve definir classification_only_trace="1". Qualquer encadeamento que não estiver processando esse pedido tem a coleta de rastreamento desativada e não gera registros de rastreio.
Se nenhum elemento de classificação define classification_only_trace="1", o rastreio do nível de classificação não está em vigor para o servidor de aplicativos. O servidor não desativa a coleta de rastreio para nenhum encadeamento. Todos os registros de rastreio são gravados para saída conforme determinado pela especificação de rastreio.
O atributo classification_only_trace não afeta como uma especificação de rastreio é definida e ativada. O atributo afeta somente quais encadeamentos gravam registros de rastreio.
- message_tag
Especifica um token de cadeia que é impresso com todos os registros de rastreio, mensagens de log e mensagens do sistema gerados para pedidos que o elemento de classificação classifica.
O atributo tem um máximo de oito caracteres.
O atributo não substitui nenhuma propriedade do servidor.
Cada elemento sib_classification_info pode conter uma ou mais dessas propriedades conforme necessário para classificar o trabalho para uma mensagem. Um elemento sib_classification_info não pode conter mais que uma instância de cada propriedade.
<sib_classification_info transaction_class="e" destination="themoon" description="n" />
<sib_classification_info transaction_class="f" description="n" />
Uma mensagem que chegar no destino mediado themoon terá designada a classificação "e". Uma mensagem que chegar em outro destino mediado terá designada a classificação "f".
Se uma mensagem não corresponder a nenhum elemento sib_classification_info em um elemento SibClassification envolvente, a mensagem terá designada a classificação padrão do elemento SibClassification.
Se uma mensagem não corresponder a nenhum elemento sib_classification_info em nenhum elemento SibClassification, ou se não houver nenhum elemento SibClassification definido, todo trabalho receberá uma classificação padrão interna com o valor "SIBUS". É necessário executar as ações do z/OS Workload Manager requeridas para utilizar o valor TCLASS "SIBUS", conforme descrito em Classificando a Carga de Trabalho do z/OS.
Classificação do Provedor de Sistema de Mensagens WebSphere MQ
<WMQRAClassification default_transaction_class="TC99" schema_version="1.0">
<wmqra_classification_info transaction_class="TC_4"
destination="topic://a/b/*"
description="Qualquer tópico que inicie com a/b/ mapeia para TC_4"/>
<wmqra_classification_info transaction_class="TC_3"
selector="JMSPriority>3 AND JMSPriority<8"
destination="queue://QMGR1/Q1"
queue_manager="QMGR1"
description="prioridades médias com um nome do gerenciador de filas QMGR1 e
um nome da fila de mapa Q1 para 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
- Utilize o atributo selector do elemento wmqra_classification_info para designar uma
classe de transação a uma mensagem com base em suas propriedades.
Esse atributo pode
também ser utilizado para designar uma classe de transação a um bean acionado por
mensagens que tenha uma cláusula selector em seu descritor de implementação:
- O valor do atributo selector é uma expressão SQL que seleciona uma mensagem de acordo aos valores das propriedades da mensagem. A sintaxe é aquela de um seletor de mensagem na especificação JMS 1.1.
- O valor do atributo selector deve ter a sintaxe correta para um documento XML. Você deve substituir o símbolo < pela referência de entidade < e o símbolo final > pela referência de entidade >. De forma semelhante, se você utilizar um apóstrofo ou aspas, utilize as referências de entidade ' e ".
- destination
- Uma URI representando o destino do WebSphere MQ ao qual a mensagem foi entregue. A classificação se aplica ao destino nomeado por essa propriedade, ou a qualquer destino, se você não especificar essa propriedade. Se a URI representar um destino de tipo de fila, ela pode incluir opcionalmente um nome do gerenciador de filas, mas esse nome será ignorado e não será usado para classificação. Se a URI representar um destino de tipo de tópico, ela pode fazer uso de curingas. Para obter informações adicionais sobre suporte a curinga com o WebSphere MQ consulte o centro de informações do WebSphere MQ.
- queue_manager
- O nome do gerenciador de filas do WebSphere MQ ao qual a mensagem foi entregue. A classificação se aplica ao gerenciador de filas nomeado por essa propriedade, ou a qualquer gerenciador de filas, se você não especificar essa propriedade. O nome do gerenciador de filas deve seguir as convenções de nomenclatura do WebSphere MQ.
- Observe que esse campo não deve ser configurado para o nome de um grupo de filas compartilhadas do WebSphere MQ. Em vez disso, você deve criar um elemento wmqra_classification_info para cada gerenciador de filas no grupo de filas compartilhadas ou basear a classificação em outra coisa como o atributo de destino.
- descrição
- Embora o campo de descrição seja opcional, você deve utilizá-lo em todos os elementos wmqra_classification_info.
Atributos RAS:
É possível especificar os seguintes atributos RAS no elemento wmqra_classification_info. Elementos aninhados herdam os atributos RAS do elemento-pai. Elementos aninhados podem substituir os atributos RAS de um elemento-pai. Todos os atributos RAS são opcionais.
- dispatch_timeout
Especifica a quantidade de tempo que uma região de controle aguarda após despachar uma solicitação para a fila do WLM. Se a região de controle não receber uma resposta no tempo especificado, ela emitirá um tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_wlm_dispatch_timeout.
- queue_timeout_percent
Especifica o tempo limite da fila do WLM como uma porcentagem do tempo limite de dispatch. O intervalo para a porcentagem é 0 - 99. O tempo limite da fila é a quantidade de tempo que um pedido pode permanecer na fila do WLM sem dispatch antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor control_region_iiop_queue_timeout_percent.
- request_timeout
Especifica o valor de tempo limite em segundos aplicado em pedidos de saída que se originam sob pedidos com dispatch. O pedido com dispatch é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor com.ibm.CORBA.RequestTimeout.
- stalled_thread_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de dispatch especificado no atributo dispatch_timeout. O pedido é um pedido que o elemento de classificação classificou. Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_iiop_stalled_thread_dump_action.
- cputimeused_limit
Especifica o tempo limite de CPU em milissegundos. O tempo limite de CPU é a quantidade de tempo de CPU permitida para o pedido antes do pedido atingir o tempo limite. O pedido é um pedido que o elemento de classificação classificou.
O atributo substitui a propriedade de servidor server_region_request_cputimeused_limit.
- cputimeused_dump_action
Especifica a ação dump que o servidor utiliza quando pedidos excedem seu tempo limite de CPU especificado no atributo cputimeused_limit. O pedido é um pedido que o elemento de classificação classificou.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_cputimeused_dump_action.
- dpm_interval
Especifica em segundos o intervalo do Dispatch Progress Monitor (DPM). O monitor do DPM aciona a ação dump do DPM no intervalo para pedidos que o elemento de classificação classificou. Especifique a ação dump do DPM no atributo dpm_dump_action.
O atributo não substitui nenhuma propriedade do servidor. Você deve usar o comando de modificação para ativar intervalos do DPM extensivos ao servidor.
- dpm_dump_action
Especifica a ação dump do DPM que é adotada em todos os intervalos do DPM para pedidos que o elemento de classificação classifica. Especifique o intervalo de DPM no atributo dpm_interval.
Os valores válidos são svcdump, javacore, heapdump, traceback, javatdump e none.
O atributo substitui a propriedade de servidor server_region_dpm_dump_action.
- SMF_request_activity_enabled
Especifica se os registros System Management Facilities (SMF) 120 de subtipo 9 são coletados para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_enabled.
- SMF_request_activity_timestamps
Especifica se serão formatados os registros de data e hora em formato legível para o ser humano no registro SMF 120 de subtipo 9 para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_timestamps.
- SMF_request_activity_security
Especifica se a seção de dados de segurança do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_security.
- SMF_request_activity_CPU_detail
Especifica se a seção de análise de uso de CPU do registro SMF 120 de subtipo 9 é coletada para pedidos. Os pedidos são pedidos que o elemento de classificação classificou.
Os valores válidos são 0 (não) e 1 (sim).
O atributo substitui a propriedade de servidor server_SMF_request_activity_CPU_detail.
- classification_only_trace
Especifica se serão gerados registros de rastreio para pedidos que o elemento de classificação classifica.
Os valores válidos são 0 (não) e 1 (sim).
O atributo não substitui nenhuma propriedade do servidor. O comando de modificação TRACERECORD substitui o classification_only_trace.
Se algum elemento de classificação tiver classification_only_trace configurado como 1, o rastreio do nível de classificação está em vigor para o servidor de aplicativos. Os únicos encadeamentos que geram registros de rastreio são encadeamentos que processam pedidos que um elemento de classificação classifica. Esse elemento de classificação deve definir classification_only_trace="1". Qualquer encadeamento que não estiver processando esse pedido tem a coleta de rastreamento desativada e não gera registros de rastreio.
Se nenhum elemento de classificação define classification_only_trace="1", o rastreio do nível de classificação não está em vigor para o servidor de aplicativos. O servidor não desativa a coleta de rastreio para nenhum encadeamento. Todos os registros de rastreio são gravados para saída conforme determinado pela especificação de rastreio.
O atributo classification_only_trace não afeta como uma especificação de rastreio é definida e ativada. O atributo afeta somente quais encadeamentos gravam registros de rastreio.
- message_tag
Especifica um token de cadeia que é impresso com todos os registros de rastreio, mensagens de log e mensagens do sistema gerados para pedidos que o elemento de classificação classifica.
O atributo tem um máximo de oito caracteres.
O atributo não substitui nenhuma propriedade do servidor.
Cada elemento wmqra_classification_info pode conter uma ou mais dessas propriedades, conforme necessário para classificar o trabalho para uma mensagem. Um elemento wmqra_classification_info não pode conter mais de uma instância de cada propriedade.
<wmqra_classification_info queue_manager="QMGR1" transaction_class="TC_1" />
<wmqra_classification_info destination="queue:///Q1" transaction_class="TC_2" />
Uma mensagem que chega ao destino Q1 no gerenciador de filas QMGR1 é designada à classificação "TC_1". Uma mensagem que chega ao Q1 a partir de outro gerenciador de filas é designada à classificação "TC_2".
Se uma mensagem não corresponder a nenhum elemento wmqra_classification_info em um elemento WMQRAClassification de inclusão, será designada à mensagem a classificação padrão do elemento WMQRAClassification. Se houver vários elementos WMQRAClassification, a classe de transação padrão do primeiro elemento WMQRAClassification será utilizada.
Se nenhum elemento WMQRAClassification for definido, todo o trabalho receberá a classificação padrão "WMQRA". É necessário executar as ações do z/OS Workload Manager necessárias para usar o valor TCLASS "WMQRA", conforme descrito em Classificando a Carga de Trabalho do z/OS.
Documento de classificação de carga de trabalho de amostra do z/OS sem atributos RAS
O documento de classificação de carga de trabalho de amostra do z/OS contém atributos para classificar pedidos de trabalho de entrada de HTTP, IIOP, Session Initiation Protocol (SIP) e message-driven bean (MDB) para o gerenciador de carga de trabalho do z/OS. Essa amostra não contém atributos RAS.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Classification SYSTEM "Classification.dtd" > <Classification schema_version="1.0"> <!-- Regras de Classificação Internas --> <InboundClassification type="internal" schema_version="1.0" default_transaction_class="value1"/> <!-- Regras de Classificação IIOP --> <InboundClassification type="iiop" schema_version="1.0" default_transaction_class="A0"> <iiop_classification_info transaction_class="A1" application_name="IIOPStatelessSampleApp" module_name="StatelessSample.jar" component_name="Sample20" description="Sample20 EJB Classification"> <iiop_classification_info transaction_class="" method_name="echo" description="No TCLASS for echo()" /> <iiop_classification_info transaction_class="A1B" method_name="ping" description="Ping method" /> </iiop_classification_info> <iiop_classification_info application_name="*" module_name="*" component_name="*" transaction_class="A2" description="TCLASS the rest to A2"> <iiop_classification_info transaction_class="A2A" method_name="resetFilter" description="Sp1 case resetFilter()" /> </iiop_classification_info> </InboundClassification> <!-- Regras de Classificação HTTP --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="M"> <http_classification_info transaction_class="N" host="yourhost.yourcompany.com" description="Virtual Host yourhost"> <http_classification_info transaction_class="O" port="9080" description="Def yourhost HTTP reqs"> <http_classification_info transaction_class="Q" uri="/gcs/admin" description = "Gcs" /> <http_classification_info transaction_class="S" uri="/gcs/admin/1*" description="GCS login" /> <http_classification_info transaction_class="P" port="9081" description=" Def yourhost HTTPS reqs "/> <http_classification_info transaction_class="" uri="/gcss/mgr/*" description="GCSS Mgr" /> </http_classification_info> </http_classification_info> </InboundClassification> <!-- Regras de Classificação SIP --> <InboundClassification type="sip" schema_version="1.0" default_transaction_class="value1"/> <!-- Regras de Classificação MDB --> <InboundClassification type="mdb" schema_version="1.0" default_transaction_class="qrs"> <endpoint type="messagelistenerport" name="IVPListenerPort" defaultclassification="MDBX" description="ABC"> <classificationentry selector="Location='East'" classification="MDB1" description="DEF"/> <classificationentry selector="Location<>'East'" classification="MDB2" description="XYZ" /> </endpoint> <endpoint type="messagelistenerport" name="SimpleMDBListenerPort" defaultclassification="MDBX" description="GHI" /> </InboundClassification> <SibClassification type="jmsra" schema_version="1.0" default_transaction_class="a"> <sib_classification_info transaction_class="b" selector="user.Location='East'" bus="magic" destination="nowhere" description="n" /> <sib_classification_info transaction_class="c" selector="user.Location='West'" bus="omni" description="n" /> </SibClassification> <SibClassification type="destinationmediation" schema_version="1.0" default_transaction_class="b"> <sib_classification_info transaction_class="e" selector="user.Location='East'" destination="themoon" discriminator="sides/dark" description="n" /> <sib_classification_info transaction_class="f" selector="user.Location='West'" description="n" /> </SibClassification> <WMQRAClassification default_transaction_class="TC99" schema_version="1.0"> <wmqra_classification_info transaction_class="TC_1" queue_manager="GOLD" description="mapas do gerenciador de filas gold para TC_1"/> <wmqra_classification_info transaction_class="TC_2" selector="JMSPriority>7" description="mapas de alta prioridade para TC_2"/> <wmqra_classification_info transaction_class="TC_3" selector="JMSPriority>3 AND JMSPriority<8" description="mapas de prioridades médias para TC_3"/> </WMQRAClassification> <!-- Regras de Classificação OLA --> <InboundClassification type="ola" schema_version="1.0" default_transaction_class="A0"> <ola_classification_info transaction_class="FAST1" service_name="ejb/InteractiveTransactionBean" description="classificação EJB para retorno rápido"/> <ola_classification_info transaction_class="SLOW1" service_name="ejb/BackgroundBean" description="classificação EJB para baixa prioridade" /> <ola_classification_info propagate_transaction_name="true" service_name="ejb/CalledFromCICSBean" description="use a classe de serviço de nome como cliente" /> </InboundClassification> <!-- Documento de Classificação de Carga de Trabalho para Servidores P5SR01x Histórico de Alterações _______________________________________________________ Atividade Data Autor Criada 28-01-2005 IPL --> </Classification>
Documento de classificação de carga de trabalho de amostra do z/OS contendo atributos RAS
O documento de classificação de carga de trabalho de amostra do z/OS contém atributos para classificar pedidos de trabalho de entrada de HTTP, IIOP e MDB para o gerenciador de carga de trabalho do z/OS. Essa amostra contém atributos RAS.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE Classification SYSTEM "Classification.dtd" > <Classification schema_version="1.0"> <!-- Regras de Classificação de IIOP --> <InboundClassification type="iiop" schema_version="1.0" default_transaction_class="TC"> <!-- Informação de classificação de IIOP para o aplic. "EJBApp1". O elemento de classificação define um transaction_class "TC1". Esse valor substitui a default_transaction_class do elemento InboundClassification ("TC"). O elemento de classificação também especifica uma message_tag, que é aplicada a todos os pedidos que são classificados sob esse elemento de classificação. --> <iiop_classification_info application_name="EJBApp1" transaction_class="TC1" message_tag="EJBApp1"> <!-- EJBApp1 contém um módulo jar denominado "MyEJB.jar" com um EJB denominado "MyEJBClass". A transaction_class não está definida para esse elemento; assim, o elemento herda a transaction_class de seu nó-pai, "TC1". Esse elemento também herda o atributo message_tag de seu nó-pai, "EJBApp1". Em geral, um elemento de classificação herda todos os atributos RAS de seus nós anteriores, com nós anteriores mais próximos (por exemplo, pais diretos) tendo precedência sobre nós anteriores mais tarde na cadeia (por exemplo, avós). --> <iiop_classification_info module_name="MyEJB.jar" component_name="MyEJBClass"> <!-- MyEJBClass contém métodos denominados "helloWorld" e "goodbyeWorld". helloWorld recebe um dispatch_timeout de 30 segundos e um queue_timeout_percent de 90, significando que o valor de tempo limite é 90% do valor dispatch_timeout. O elemento de classificação também especifica SMF_request_activity_enabled=1, significando que registros de SMF 120 subtipo 9 são coletados para todos os pedidos com destino contra o método helloWorld. Observe também que esse elemento de classificação não define uma transaction_class; portanto, ele herda a transaction_class do elemento anterior mais próximo que define uma. Nesse caso, o elemento anterior mais próximo que define uma transaction_class é o elemento avô, "TC1". Nota: se nenhum elemento anterior definir uma transaction_class, então o elemento de classificação herda a default_transaction_class do elemento InboundClassification. A default_transaction_class na InboundClassification é necessária. Esse elemento de classificação também herda o atributo message_tag de seu elemento avô, "EJBApp1". --> <iiop_classification_info method_name="helloWorld" dispatch_timeout="30" queue_timeout_percent="90" SMF_request_activity_enabled="1" /> <!-- O método goodbyeWorld especifica um dispatch_timeout de 60 segundos. O elemento de classificação também define uma transaction_class, "TC1gbye", que substitui a transaction_class definido por sua ancestralidade. Esse elemento herda a message_tag de sua ancestralidade, "EJBApp1". --> <iiop_classification_info method_name="goodbyeWorld" transaction_class="TC1gbye" dispatch_timeout="60" /> </iiop_classification_info> </iiop_classification_info> <!-- Informação de classificação de IIOP para o aplic. "EJBApp2". O elemento de classificação define um dispatch_timeout de 15 segundos e uma message_tag "EJBApp2". O transaction_class é herdadO da default_transaction_class na InboundClassification, "TC". Todos os pedidos que são classificados sob esse elemento de classificação possuem um tempo limite de dispatch de 15 segundos e todos os registros de rastreio e mensagens de log gerados por esses pedidos são marcados com valor de atributo message_tag, "EJBApp2". --> <iiop_classification_info application_name="EJBApp2" dispatch_timeout="15" message_tag="EJBApp2"> <!-- EJBApp2 contém dois módulos jar, "MyEJB2a.jar" e "MyEJB2b.jar". Os dois elementos de classificação a seguir definem uma transaction_class para cada módulo jar. Nenhum outro atributo é definido. Ambos os elementos herdam os atributos de seus nós anteriores (dispatch_timeout="15" e 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> <!-- O seguinte elemento de classificação define atributos para um módulo, componente e método específicos do aplicativo "EJBApp3". O módulo é "MyEJB3.jar", o componente é "MyEJB3Class" e o método é "method3". A transaction_class, dispatch_timeout queue_timeout_percent, SMF_request_activity_enabled e SMF_request_activity_timestamps são todos definidos para esse método específico no aplicativo EJBApp3. Nenhum outro método em nenhum outro EJB dentro desse aplicativo recebe esses atributos. --> <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> <!-- Regras de Classificação Internas --> <InboundClassification type="internal" schema_version="1.0" default_transaction_class="internal" /> <!-- Regras de Classificação de HTTP --> <InboundClassification type="http" schema_version="1.0" default_transaction_class="HTC"> <!-- O seguinte elemento de classificação define uma transaction_class, "HTC8080", para todos os pedidos de HTTP recebidos no host "my.server.com" e na porta "8080". O elemento de classificação também define dispatch_timeout, queue_timeout_percent, timeout_recovery e stalled_thread_dump_action de atributos RAS. Todos os elementos filhos sob esse elemento herdam 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"> <!-- O seguinte elemento de classificação aplica-se a todos os pedidos de HTTP com uma URI que começa com "/PlantsByWebSphere/". Cada pedido de HTTP recebido no host my.server.com e na porta 8080 com uma URI que começa com /PlantsByWebSphere inclui-se sob essa classificação (nota: host e porta herdados do elemento-pai ). O elemento de classificação também define o atributo message_tag, "plantsbw", que é incluído em cada registro de rastreio e mensagem de log gerados por qualquer pedido /PlantsByWebSphere/*. --> <http_classification_info uri="/PlantsByWebSphere/*" message_tag="plantsbw"> <!-- O seguinte elemento de classificação aplica-se a todos os pedidos de HTTP com uma URI que corresponde a "/PlantsByWebSphere/*.jpg (por exemplo, /PlantsByWebSphere/mypic.jpg, /PlantsByWebSphere/some/path/anotherpic.jpg). Novamente, esse filtro aplica-se somente a pedidos recebidos no host my.server.com e na porta 8080 (como designado por um nó anterior). O elemento de classificação define uma transaction_class, "HTCPjpg" e um dispatch_timeout, "10". Ele herda os atributos restantes de seus nós anteriores. --> <http_classification_info uri="*.jpg" transaction_class="HTCPjpg" dispatch_timeout="10" /> <!-- O seguinte elemento de classificação aplica-se a todos os pedidos de HTTP com uma URI que corresponde a "/PlantsByWebSphere/*.html (por exemplo, /PlantsByWebSphere/index.html, /PlantsByWebSphere/some/path/afile.html). --> <http_classification_info uri="*.html" transaction_class="HTChtml" /> </http_classification_info> </http_classification_info> <!-- O seguinte elemento de classificação define uma transaction_class, "HTC80", para todos os pedidos de HTTP recebidos na porta "80". O atributo host não é definido; dessa forma, esse elemento corresponde a qualquer host. --> <http_classification_info port="80" transaction_class="HTC80" dispatch_timeout="60" timeout_recovery="servant" message_tag="vanilla" /> </InboundClassification> <!-- Regras de Classificação de MDB --> <InboundClassification type="mdb" schema_version="1.0" default_transaction_class="mdbdflt"> <!-- Terminal para LP 1414, skLP1, para Teste de MDB Plano 'A' --> <endpoint type="messagelistenerport" name="skLP1" defaultclassification="lp1dft" description="Terminal para LP 1414, skLP1, para Teste de MDB Plano 'A'"> <classificationentry selector="JMSCorrelationID='TestCase1'" classification="lp1s1" description="Nova Amostra de MDB, TestCase1" cputimeused_limit="200101" request_timeout="20" dispatch_timeout="30" dpm_interval="0" queue_timeout_percent="20" stalled_thread_dump_action="traceback" /> </endpoint> </InboundClassification> <!-- Regras de Classificação de SIB --> <SibClassification type="jmsra" schema_version="1.0" default_transaction_class="Dclass"> <sib_classification_info transaction_class="Tclass" bus="testbus" destination="themoon" description="test1" dispatch_timeout="30" queue_timeout_percent="20" request_timeout="20" stalled_thread_dump_action="traceback" cputimeused_limit="200101" cputimeused_dump_action="traceback" dpm_interval="0" dpm_dump_action="traceback" classification_only_trace="1" message_tag="sibreqst" /> </SibClassification> </Classification>
DTD:
A seguinte DTD define os elementos e atributos usados nos documentos de classificação de carga de trabalho de amostra precedentes.
<?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>
Classificação de exemplo de uma solicitação de entrada de HTTP
Use o seguinte pedido de http com o documento de classificação de carga de trabalho de amostra descrito anteriormente do z/OS contendo atributos RAS:
http://my.server.com:8080/PlantsByWebSphere/plants/newOrder.html
Como esse pedido é um pedido de HTTP, o servidor de aplicativos varre somente os elementos http_classification_info. O servidor de aplicativos varre os elementos na ordem em que ocorrem no arquivo de classificação de carga de trabalho.
<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">
Esse elemento
possui atributos e valores de entrada host="my.server.com" e port="8080".
Como esses atributos correspondem ao pedido de HTTP de entrada, o servidor de aplicativos desce nesse elemento e compara os nós-filhos. O
servidor de aplicativos localiza o seguinte elemento filho: <http_classification_info
uri="/PlantsByWebSphere/*"
message_tag="plantsbw">
O elemento filho define
o atributo e o valor de entrada uri="/PlantsByWebSphere/*",
que corresponde à URI da URI do pedido de entrada. O servidor
de aplicativos então varre os filhos do
elemento. O servidor de aplicativos localiza o primeiro
elemento filho: <http_classification_info
uri="*.jpg"
transaction_class="HTCPjpg"
dispatch_timeout="10"
/>
Esse elemento filho contém o atributo e valor uri="*.jpg". Como esse par de atributo e valor não corresponde
à URI de entrada, o servidor de aplicativos move-se para o próximo elemento filho. O
servidor de aplicativos localiza o segundo elemento filho: <http_classification_info
uri="*.html"
transaction_class="HTChtml"
/>
Esse elemento filho contém o atributo e valor uri="*.html", que corresponde à URI de entrada.dispatch_timeout="100"
queue_timeout_percent="98"
timeout_recovery="session"
stalled_thread_dump_action="javacore"
message_tag="plantsbw"
transaction_class="HTChtml"
O servidor de aplicativos lê
quaisquer atributos RAS não definidos no arquivo de classificação de carga de trabalho
a partir da configuração extensiva ao servidor e os atribui ao pedido.
As propriedades relevantes de configuração extensiva ao servidor, incluindo
aquelas que os dados de classificação substituiram, estão na seguinte lista: protocol_http_timeout_output -- overridden by dispatch_timeout
control_region_http_queue_timeout_percent -- overridden by queue_timeout_percent
com.ibm.CORBA.RequestTimeout
server_region_http_stalled_thread_dump_action -- overridden by stalled_thread_dump_action
server_region_request_cputimeused_limit
server_region_cputimeused_dump_action
server_region_dpm_dump_action
server_SMF_request_activity_enabled
server_SMF_request_activity_timestamps
server_SMF_request_activity_CPU_detail
protocol_http_timeout_output_recovery -- overridden by timeout_recovery
Para
qualquer propriedade de configuração extensiva ao servidor que os dados de classificação não substituem, o pedido herda o valor da propriedade extensiva ao servidor.Classificação de exemplo de uma solicitação de entrada de IIOP
Use o seguinte pedido de IIOP com o documento de classificação de carga de trabalho de amostra descrito anteriormente do z/OS contendo atributos RAS:
Pedido de entrada de IIOP para MyEJB2bBean.someMethod() no módulo MyEJB2b.jar do aplicativo EJBApp2.
<iiop_classification_info
application_name="EJBApp1"
transaction_class="TC1"
message_tag="EJBApp1">
Esse elemento possui um atributo e valor de entrada
application_name="EJBApp1".
O nome do aplicativo
de EJBApp1 no atributo application_name não corresponde ao
nome do aplicativo de EJBApp2 do pedido de entrada.
Portanto, o
servidor de aplicativos ignora esse elemento de classificação e todos os seus
elementos filhos e move-se para o próximo elemento. O servidor de aplicativos
localiza o próximo elemento: <iiop_classification_info
application_name="EJBApp2"
dispatch_timeout="15"
message_tag="EJBApp2">
Esse elemento possui um atributo e valor
de entrada application_name="EJBApp2".
Como
esse par de atributo e valor corresponde ao nome do aplicativo do pedido
de entrada, o scanner desce nesse elemento. O servidor de aplicativos localiza o primeiro
elemento filho: <iiop_classification_info
module_name="MyEJB2a.jar"
transaction_class="TC2a"
/>
Esse elemento contém o atributo e o valor de entrada module_name="MyEJB2a.jar". Como esse par de atributo e valor
não corresponde ao nome do módulo MyEJB2b.jar do pedido de entrada,
o servidor de aplicativos varre o próximo elemento filho: <iiop_classification_info
module_name="MyEJB2b.jar"
transaction_class="TC2b"
/>
Esse elemento contém o atributo e o valor de entrada module_name="MyEJB2b.jar". O nome do módulo MyEJB2b.jar no atributo module_name corresponde
ao nome do módulo do pedido de entrada. Como nenhum elemento filho
adicional existe, o servidor de aplicativos classifica o pedido para
esse elemento. O pedido herda todos os atributos de saída desse
elemento e todos os seus elementos anteriores. Os
seguintes pares de atributo e valor são uma lista completa de pares de atributo e valor
de saída que o servidor de aplicativos atribui ao pedido: dispatch_timeout="15"
message_tag="EJBApp2"
transaction_class="TC2b"
O servidor de aplicativos lê
quaisquer atributos RAS não definidos no arquivo de classificação de carga de trabalho
a partir da configuração extensiva ao servidor e os atribui ao pedido.
As propriedades relevantes de configuração extensiva ao servidor, incluindo
aquelas que os dados de classificação substituiram, estão na seguinte lista: 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
qualquer propriedade de configuração extensiva ao servidor que os dados de classificação não substituem, o pedido herda o valor da propriedade extensiva ao servidor.