É possível utilizar um documento de classificação de carga de trabalho comum
para classificar pedidos de trabalho de entrada de HTTP, IIOP, Session Initiation Protocol (SIP), adaptador local otimizado e message-driven bean (MDB) para o gerenciador de carga de trabalho do z/OS.
Sobre Esta Tarefa
Um arquivo do documento de classificação de carga de trabalho é um arquivo XML
no qual você classifica os pedidos de trabalho de entrada de HTTP, IIOP, Session Initiation Protocol (SIP), adaptador local otimizado e de message-driven bean (MDB) e
os designa para uma transaction class (TCLASS). O valor TCLASS, se
designado, é transmitido ao MVS Workload Manager. O WLM utiliza o valor TCLASS para classificar os pedidos
de trabalho de entrada e para designar uma classe de serviço ou uma classe de
serviço de relatório para cada pedido.
O documento de classificação de carga de
trabalho comum é o método que você deverá usar para classificar os pedidos de
trabalho em um ambiente z/OS.
O suporte para outros mecanismos do WebSphere Application Server de classificação de trabalho em
um ambiente
z/OS foi
reprovado e você não deverá mais usar esses mecanismos.
Se
desejar classificar o trabalho para beans orientados a mensagens implementados em recursos
JCA 1.5 com o fornecedor de sistema de mensagens padrão, ou se desejar classificar
o trabalho de mediação paro uso com barramentos de integração de serviço,
será necessário definir um elemento Classification
que utiliza elementos SibClassification. É necessário também executar as ações do z/OS Workload Manager que
são obrigatórias para usar o valor TCLASS "SIBUS".
Se você substituir qualquer
porta listener por uma especificação de ativação JMS para uso de aplicativos MDB com o
provedor de sistemas de mensagens padrão Versão 6, deverá substituir as classificações
InboundClassification type="mdb" relacionadas pelas classificações SibClassifications
type="jmsra".
Para classificar o trabalho para
beans acionados por mensagens implementados em uma especificação de ativação do
provedor de sistemas de mensagens do WebSphere
MQ, é necessário definir um elemento Classification que utilize elementos
WMQRAClassification. É necessário também executar as ações do z/OS Workload
Manager que são obrigatórias para usar o valor TCLASS "WMQRA". Se você
substituir qualquer porta listener por uma especificação de ativação JMS para uso de
aplicativos MDB com o provedor de sistemas de mensagens do WebSphere MQ, deverá substituir as classificações
InboundClassification type="mdb" relacionadas pelas classificações WMQRAClassification.
- Desenvolva o documento de classificação de carga de trabalho. Use
as informações no Arquivo de Classificação de Carga de Trabalho tópico para criar o documento. O tópico contém
exemplos do documento de classificação de carga de trabalho, com e sem
atributos RAS. Use um documento de classificação de carga de trabalho se
estiver usando-o para classificar a carga de trabalho do z/OS ou para implementar a granularidade do Reliability Availability and Serviceability (RAS).
- Se você criar o documento em um sistema z/OS na página de códigos IBM-1047, a página de códigos
normal para arquivos que existem no HFS, converta o arquivo para ASCII antes de usar o arquivo. Utilize uma das opções a seguir para converter um documento
de trabalho em um documento que possa ser utilizado pelo servidor:
- native2ascii
Esse é um utilitário no Java™ SDK que pode converter um arquivo da página de códigos nativa para a página de códigos ASCII. Por exemplo, se você estiver trabalhando em um documento XML chamado x5sr02.classification.ebcdic.xml e desejar criar
um documento chamado x5sr02.classification.xml, utilize o seguinte comando:
/u/userid -> native2ascii \
x5sr02.classification.ebcdic.xml >x5sr02.classification.xml
A linha de comandos
é dividida por um caractere de barra invertida (
\) para a próxima linha,
para fins de publicação.
- iconv
Esse é um utilitário do z/OS
que pode converter arquivos de uma página de códigos designada para uma página de códigos designada diferente. Por exemplo, se você estiver trabalhando em um documento XML chamado x5sr02.classification.ebcdic.xml e desejar criar
um documento chamado x5sr02.classification.xml, utilize o seguinte comando:
/u/userid -> iconv -f IBM-1047 -t UTF-8 \
x5sr02.classification.ebcdic.xml >x5sr02.classification.xml
A linha de comandos
é dividida por um caractere de barra invertida (
\) para a próxima linha,
para fins de publicação.
- Crie o documento em sua estação de trabalho e, em seguida, envie o arquivo por FTP
para o local correto no sistema
z/OS em
formato binário. Utilizando esta opção, também é possível
criar o arquivo Classification.dtd no mesmo diretório que o documento de
classificação de carga de trabalho. Em seguida, é possível executar uma verificação de validade de XML no documento antes de instalá-lo em um servidor. Utilize qualquer tipo de analisador de validação; por exemplo, você pode usar o
ambiente de trabalho do WebSphere Application
Developer para construir e validar o documento de classificação de carga de trabalho.
- Especifique o local do documento de classificação de carga de trabalho no
console administrativo. Utilize a variável wlm_classification_file
para especificar o arquivo XML que contém as informações sobre classificação.
No console administrativo, clique em . É possível definir a variável no nível de célula, do nó ou da instância do servidor. Se você especificar a variável no nível de célula ou do nó, as informações deverão
ser acessíveis e aplicáveis a todos os servidores que herdarem a especificação
do nó ou da célula.
- Execute ações do Workload Manager do z/OS que são necessárias para usar os valores TCLASS. Cada TCLASS deve ser designado a uma classe de serviço, a uma classe de serviço de relatório ou a ambas, para o enclave no qual o trabalho é executado. As regras de classificação CB devem ser atualizadas.
Para classificar o trabalho para beans acionados por mensagens implementados em recursos
JCA 1.5 com o provedor de sistemas de mensagens padrão, ou classificar o trabalho de
mediação para uso com barramentos de integração de serviço, será necessário executar as
ações do z/OS Workload Manager
obrigatórias para utilizar o valor TCLASS "SIBUS".
As classes de transação
são utilizadas como sub-regras no estabelecimento de classes de serviço e de transação. Os valores TCLASS não são utilizados como regras de nível um. Se você decidir utilizar
TCLASS como uma regra de nível um em vez de uma sub-regra, deverá ter atenção ao
ordenar as regras. A primeira regra de nível um que se aplica ao trabalho é utilizada, portanto, as regras mais específicas devem aparecer primeiro, seguidas pelas regras amplas.
Por
exemplo, considere os dois exemplos de regras de classificação CB a seguir:Tipo de Subsistema Xref Notas Opções Ajuda
--------------------------------------------------------------------------
Modificar Regras para o Tipo de Subsistema Linha 1 a 17 de 17
Comando ===> ____________________________________________ ROLAR ===> CSR
Subsystem Type . : CB Fold qualifier names? Y (Y or N)
Descrição . . . CB Class'n w/WLM Trans. CLASSes
Códigos de ação: D=Depois C=Copiar M=Mover I=Inserir regra
A=Antes E=Excluir linha R=Repetir IS=Inserir subregra
More ===>
--------Qualifier-------- -------Class--------
Action Type Name Start Service Report
DEFAULTS: CBCLASS RWASDEF
____ 1 CN P5SR01* 1 CBCLASS RTP5CLUS
____ 1 TC A0 ___ CBHUTCH RP5A0
____ 1 TC A1 ___ CBHUTCH RP5A1
____ 1 TC A1B ___ CBHUTCH RP5A1B
____ 1 CN WSIVP2* ___ CBSLOW RWSIVP
____ 1 CN T%SERV* 1 CBFAST RTSMIGT
____ 1 CN B4* ___ CBFAST ________
No exemplo
anterior, as designações de TCLASS feitas para enclaves em execução
no servidor P5SR01x nunca são utilizadas pelo Workload Manager. Quando a seguinte
regra é executada, não é feita nenhuma procura adicional da tabela de classificação:
____ 1 CN P5SR01* 1 CBCLASS
As designações
de TCLASS não são utilizadas. Todos os enclaves executados nos servidores
P5SR01x são designados à classe de serviço
CBCLASS e à classe de serviço de relatório RTP5CLUS.
Tipo de Subsistema Xref Notas Opções Ajuda
--------------------------------------------------------------------------
Modificar Regras para o Tipo de Subsistema Linha 1 a 17 de 17
Comando ===> ____________________________________________ ROLAR ===> CSR
Subsystem Type . : CB Envolver nomes de qualificadores? Y (Y or N)
Descrição . . . CB Class'n w/WLM Trans. CLASSes
Códigos de ação: D=Depois C=Copiar M=Mover I=Inserir regra
A=Antes E=Excluir linha R=Repetir IS=Inserir subregra
Mais ===>
--------Qualifier-------- -------Class--------
Action Type Name Start Service Report
DEFAULTS: CBCLASS RWASDEF
____ 1 TC A0 ___ CBHUTCH RP5A0
____ 1 TC A1 ___ CBHUTCH RP5A1
____ 1 TC A1B ___ CBHUTCH RP5A1B
____ 1 CN P5SR01* 1 CBCLASS RTP5CLUS
____ 1 CN WSIVP2* ___ CBSLOW RWSIVP
____ 1 CN T%SERV* 1 CBFAST RTSMIGT
____ 1 CN B4* ___ CBFAST ________
No exemplo
anterior, se um valor TCLASS de A0, A1 ou A1B for fornecido na classificação,
ele será utilizado, independente de qual servidor está executando
o trabalho. Neste caso, o nome do servidor será utilizado somente se estes três
valores TCLASS não estiverem presentes.
- Implemente as alterações no arquivo. É possível reiniciar o servidor de aplicativos ou recarregar o documento de classificação de carga de trabalho sem ter que reiniciar o servidor:
Se o documento de classificação de carga de trabalho não for um documento XML bem formado e válido, ele será ignorado pelo servidor de aplicativos e
será exibida a seguinte mensagem:
BBOJ0085E PROBLEMAS ENCONTRADOS NA ANÁLISE DO ARQUIVO XML DE CLASSIFICAÇÃO DO WLM (0)
- Utilize o comando do operador DISPLAY WORK para exibir informações
sobre classificação. Utilize este comando para determinar se seu esquema de classificação
está classificando o trabalho conforme o esperado. Emita o
seguinte comando para exibir as informações de classificação de IIOP, HTTP, internal, SIP, MDB e do adaptador local otimizado:
MODIFY|F <servername>, DISPLAY,WORK,CLINFO
Emita
este comando em cada servidor de aplicativos. O exemplo a seguir
mostra um possível resultado da emissão do novo comando do operador:
00- SY1 f bbos001,display,work,clinfo
SY1 BBOJ0129I: O arquivo de classificação de carga de trabalho /tmp/wlm4.class.xml foi carregado em
2009/07/14 19:33:35.297 (GMT).
SY1 BBOO0281I CONTADORES DE CLASSIFICAÇÃO PARA TRABALHO DE IIOP
SY1 BBOO0282I VERIFICADOS 0, COMPARADOS 0, USADOS 0, CUSTO 2, DESC: IIOP root
SY1 BBOO0282I VERIFICADOS 0, COMPARADOS 0, USADOS 0, CUSTO 4, DESC: leotag
SY1 BBOO0282I VERIFICADOS 0, COMPARADOS 0, USADOS 0, CUSTO 3, DESC: byetag
SY1 BBOO0282I VERIFICADOS 0, COMPARADOS 0, USADOS 0, CUSTO 4, DESC: hellotag
SY1 BBOO0283I FOR IIOP WORK: TOTAL CLASSIFICADO 0, CUSTO TOTAL PESADO 0
SY1 BBOO0281I CONTADORES DE CLASSIFICAÇÃO PARA TRABALHO DE HTTP
SY1 BBOO0282I VERIFICADOS 2, COMPARADOS 2, USADOS 0, CUSTO 2, DESC: HTTP root
SY1 BBOO0282I VERIFICADOS 2, COMPARADOS 2, USADOS 0, CUSTO 4, DESC: plantta4
SY1 BBOO0282I VERIFICADOS 2, COMPARADOS 1, USADOS 1, CUSTO 3, DESC: giftag4
SY1 BBOO0282I VERIFICADOS 1, COMPARADOS 1, USADOS 1, CUSTO 4, DESC: jpgtag4
SY1 BBOO0283I PARA TRABALHO DE HTTP: TOTAL CLASSIFICADO 2, CUSTO TOTAL PESADO 7
SY1 BBOO0188I FIM DA SAÍDA PARA O COMANDO DISPLAY,WORK,CLINFO
A seguir está uma explicação da saída de comando:- BBOJ0129I: O arquivo de classificação de carga de trabalho file foi carregado às time. A mensagem indica o arquivo de classificação de carga de trabalho atualmente ativo e o horário que ele foi carregado.
- BBOO0281I CLASSIFICATION COUNTERS FOR type WORK.
A mensagem do cabeçalho para mensagens que exibem o uso das regras de classificação
de carga de trabalho. O valor de type pode
ser HTTP, IIOP, INTERNAL, SIP, OLA,
ou MDB.
- BBOO0282I CHECKED n1, MATCHED n2,
USED n3, COST n4, DESC: text.
Esta mensagem exibe informações sobre uma regra específica na classificação de
carga de trabalho. Esta mensagem exibe as seguintes informações:
- n1 - O número de vezes em que a regra foi examinada.
- n2 - O número de vezes em que essa regra foi
comparada pelo pedido.
- n3 - O número de vezes em que essa regra foi
utilizada.
- n4 - O custo de uso da regra ou o número de comparações que são necessárias para determinar se essa regra é a regra correta para usar.
- text - O texto descritivo da regra de classificação para que
seja possível informar qual regra de classificação está sendo exibida.
O custo total n2 dividido pelo número total de pedidos classificados
n1 igual ao custo de utilização da tabela. Quanto mais próximo o valor estiver de um,
menor será o custo de utilização de regras definidas. Um valor de 1 indica que existe
apenas a classificação padrão, portanto, os pedidos não correspondem a ela.
- Repita estas etapas até obter a distribuição e os custos apropriados
da carga de trabalho.