[z/OS]

Usando Rastreio em Adaptadores Locais Otimizados

O WebSphere Application Server para z/OS fornece suporte para a configuração de níveis de rastreio de adaptador local otimizado para ajudar no diagnóstico de aplicativo, conexão ou servidor. É possível configurar o nível de rastreio para três níveis para capturar dados detalhados, espessos ou sem rastreio. Estes são designados como níveis de rastreio 2, 1 e 0.

Antes de Iniciar

O suporte a rastreio dinâmico em adaptadores locais otimizados fornece várias maneiras de configurar ou alterar níveis de rastreio existentes, sem reiniciar o servidor, incluindo:
  • Rastreamento predefinido de todo o servidor nos arquivos de propriedades. Isto permite que um conjunto de rastreio seja definido quando o servidor for iniciado para que o processamento de adaptadores locais otimizados esteja imediatamente pronto com o rastreio ativado. É possível usar o console administrativo do WebSphere Application Server para z/OS e o comando modify SETOLATRACEPROPS do sistema para designar o arquivo de propriedades e ativá-lo.
  • Definição do nível de rastreio. É possível usar o arquivo de propriedades de rastreio para especificar níveis de rastreio padrão para todo o servidor e níveis de rastreio individuais para conexões que ainda serão registradas para o adaptador local otimizado. O nível de rastreio pode ser configurado para 0, 1 ou 2 para cada entrada no arquivo de propriedades.
  • Use o comando modify SETOLATRACE do operador do z/OS para configurar um nível de rastreio específico para registros existentes. O comando também pode configurar o nível de rastreio para um nome de registro, nome de tarefa ou um bloco de controle Registration Entry (RGE) específico no armazenamento controlado do servidor.
  • Use um símbolo asterisco (*) como um caractere curinga no arquivo de propriedades de rastreio e o comando SETOLATRACE modify para indicar uma configuração para vários grupos de conexões. O recurso curinga pode especificar vários nomes de registros no arquivo de propriedades ou no padrão do sistema e pode configurar vários nomes de registros e nomes de tarefas no comando modify SETOLATRCE.
  • O desenvolvedor de um aplicativo que usa os adaptadores locais otimizados também pode configurar o rastreamento da vida da conexão do programa quando o registro é feito configurando os sinalizadores de rastreio na chamada BBOA1REG.

Sobre Esta Tarefa

Procedimento

  1. Predefina níveis de rastreio. A predefinição de níveis de rastreio prepara-o para capturar dados de rastreio de registro e de conexão tão logo quanto a inicialização de adaptadores locais otimizados. Você também fica preparado para seguir a atividade para conexões ainda não registradas; quando os registros indicados forem feitos, o rastreio ocorrerá automaticamente. Predefina os níveis de rastreio da seguinte forma:
    1. Crie um arquivo de propriedades de rastreio no HFS. Este arquivo deve estar em EBCDIC e ser acessível pelo daemon do WebSphere Application Server para z/OS.
      A sintaxe do arquivo de propriedades de rastreio segue a sintaxe do arquivo de propriedades do WebSphere Application Server de <keyword>=<parameter>. Neste caso, a propriedade tem uma sintaxe conforme a seguir:
      <registration_name>=<trace_level>
      em que:

      <registration_name> é uma sequência alfanumérica

      <trace_level> é 0, 1 ou 2

      Para esclarecer, você pode usar a sintaxe de estilo de aspas simples ou duplas ao indicar o nome de registro, por exemplo:
      MYREGNAME=1 "CICSREG"=2 'SHORTREG'=0 
      Também é possível agrupar registros com nomes semelhantes em uma linha usando asteriscos como caracteres curinga, por exemplo:
      REGNAME*=1 *NAME=2 "REG*NAME"=0
      Um caractere inicial # indica o início de um comentário, a menos que esteja dentro de uma sequência de caracteres entre aspas.
      Importante:
      • Qualquer nível de rastreio inválido é tratado como 0. Por exemplo, REGNAME=ALL é tratado como o nível de rastreio 0.
      • Um nome de registro de "*" é tratado como o nível de rastreio padrão, por exemplo, se *=1 for especificado, o padrão para os novos registros será um nível grande de rastreio.
      • O arquivo de propriedades pode ter um máximo de 1.024 especificações de rastreio.
      O comando SETOLATRACEPROPS emite uma mensagem de resposta que exibe quantas definições de rastreio foram processadas para registros diferentes do padrão do sistema.
    2. Crie uma variável de ambiente WAS_DAEMON_ONLY_ola_trace_settings_file no console administrativo.
    3. Configure a variável como uma cadeia para o caminho completo e nome do arquivo do arquivo de propriedades de rastreio no HFS e ative a variável.
      Se essa variável de ambiente for configurada e salva na configuração do WebSphere Application Server, o arquivo de propriedades será processado na inicialização do servidor. É possível atualizar o arquivo de propriedades de rastreio e ativar as novas definições emitindo o comando modify SETOLATRACEPROPS e as novas propriedades de rastreio afetarão novos registros. A sintaxe é:
      F daemonname,SETOLATRACEPROPS 
      Atenção: A ativação de um arquivo de propriedades de configurações de rastreio desativa as propriedades de rastreio ativas no momento.
  2. Modifique as configurações de rastreio para conexões existentes. Para conexões atuais que usam adaptadores locais otimizados, você pode ativar ou desativar o rastreio com o comando modify SETOLATRACE. O comando tem estes formatos:
    F servername,SETOLATRACE=tracelevel,REGNAME=namestring
    F servername,SETOLATRACE=tracelevel,JOBNAME=namestring
    F servername,SETOLATRACE=tracelevel,RGE=hexaddress
    O nível de rastreio pode ser 0, 1 ou 2 para, em ordem: nenhum rastreio, nível de rastreio espesso e rastreio detalhado.
    A cadeia de nomes especifica o nome de registro ou nome de tarefa para o registro existente a ser modificado. A cadeia de nomes pode ser delimitada com aspas simples ou duplas correspondentes. Da mesma forma, é possível usar um asterisco como um caractere curinga para modificar mais de uma tarefa ou registro com nome semelhante. Um único asterisco afeta cada registro existente. É possível desativar todo o rastreio de registros atuais usando qualquer um destes comandos:
    F servername,SETOLATRACE=0,REGNAME=*
    F servername,SETOLATRACE=0,JOBNAME=*

    Nos casos em que você deseja direcionar um registro específico pelo endereço do RGE no armazenamento controlado do servidor, pode usar o formato RGE=hexaddress do comando. O endereço hexa é uma cadeia sem aspas de numerais hexadecimais. Provavelmente, esta é uma abordagem que a equipe de suporte da IBM® o orientaria a usar.

    O comando SETOLATRACE exibe uma mensagem de resposta que indica quantos registros foram afetados.

  3. Especifique configurações de rastreio no registro. É possível solicitar o rastreio em código que chama a API BBOA1REG para criar o registro para o adaptador local otimizado. A interface para BBOA1REG contém um parâmetro chamado registerflags. As configurações de nível de rastreio para um registro podem ser modificadas pela configuração de um ou mais dos valores no parâmetro registerflags:
    reg_flag_trcmod    EQU X'80000000' modify trace level 
    reg_flag_trcmore   EQU X'40000000' trace level=2        
    reg_flag_trcsome   EQU X'20000000' trace level=1 

    Configure reg_flag_trcmod se desejar modificar as configurações de rastreio para o registro. Se você não configurar este sinalizador, não será feita nenhuma mudança na configuração de rastreio e os padrões do sistema ou configurações de rastreio predefinidas aplicáveis ao nome do registro ou nome da tarefa serão usadas.

    Configure reg_flag_trcmore ou reg_flag_trcsome se desejar um rastreio detalhado ou um rastreio de nível simples. Deixar ambos configurados como "off" não força nenhum rastreio, independentemente de quais predefinições ou padrões estejam configurados.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_usetraceinfoola
Nome do arquivo: tdat_usetraceinfoola.html