Sintaxe para Rastreios do RAS1

Essa sintaxe é utilizada para especificar um rastreio do RAS1 no arquivo KppENV. Após incluir esse comando no arquivo KppENV, deve-se parar e reiniciar o espaço de endereço para que ele entre em vigor. Após isso, ele permanece em vigor pela duração do espaço de endereço. Para terminar esse rastreio do RAS1, deve-se editar o arquivo KppENV novamente e reconfigurar o nível de rastreio e parar e iniciar o espaço de endereço.

A sintaxe básica dos comandos de rastreio do RAS1 para rastreio de erro é como segue:


>>-KBB_RAS1=global_class-+-----------------------+-+---------------------+-->
                         '-(COMP:component_type)-' '-(ENTRY:entry_point)-'   

>--+-------------------------+---------------------------------><
   '-(UNIT:unit_name, class)-'

Em que:

Parâmetro	Descrição
`global_class`	As mensagens que exibem os dados coletados pelo método TakeSample podem ser visualizadas incluindo o rastreio RAS1 (`UNIT:KRA OUTPUT`) ou (`UNIT:KRA ALL`) na instrução do rastreio do agente. `ERROR` (ER): retorna somente mensagens de erro grave (esse é o padrão para a maioria dos aplicativos). `STATE` (ST): grava a condição ou a configuração atual de sinalizações e variáveis dentro do processo. Se o rastreio de estado estiver ativado, é possível ver o estado atual de variáveis ou sinalizadores específicos conforme o processo estiver em execução. `FLOW` (FL): faz com que uma mensagem seja gerada em um ponto de entrada ou de saída de uma função. `DETAIL` (DE): produz um nível detalhado de rastreio. `INPUT` (IN): registra dados que são criados na execução de uma função ou de um processo de API específica. `ALL`: faz com que todas as mensagens disponíveis sejam gravadas, uma combinação de todas as outras formas de rastreio.
CONCL	A palavra-chave que indica que esse rastreio incluirá um tipo de componente. A palavra-chave COMP é utilizada para rastrear grupos de rotinas relacionados por função (ou componente). Não utilize esse parâmetro, a menos que isso seja solicitado pelo IBM® Software Support.
`component_type`	O identificador de um tipo de componente. Se um representante do IBM Software Support instruí-lo a executar um rastreio de componente, você receberá um código para esse componente. Não utilize esse parâmetro, a menos que isso seja solicitado pelo IBM Software Support.
ENTRY	A palavra-chave utilizada para restringir uma rotina de filtragem a um ENTRY POINT específico. Como múltiplos pontos de entrada para uma rotina única não são comuns, essa palavra-chave geralmente não é utilizada, devendo ser utilizada somente sob solicitação explícita de um representante do IBM Software Support.
`entry_point`	Uma variável que representa o nome do ponto de entrada. Se for solicitado a especificar um valor para a palavra-chave ENTRY, um representante do IBM Software Support irá dizer qual valor especificar para `entry_point`.
UNIT	A palavra-chave que indica que esse rastreio incluirá informações de coleção utilizando a unidade de compilação, completa ou parcialmente completa. Uma correspondência é desempenhada entre a unidade de compilação com dispatch e a unidade de compilação especificada na instrução do RAS1. Uma correspondência resulta em uma entrada de rastreio.
`unit_name`	Uma variável que representa o nome da unidade de compilação. Esse nome pode ser qualquer coisa relacionada ao nome do arquivo de objeto ou ao nome da compilação de unidade. Na maioria das instâncias, esse nome define o componente que está sendo rastreado. Esse valor pode ser um dos componentes na Tabela 5, mas, na prática, será mais provavelmente o identificador de componente de três caracteres para o agente de monitoramento (por exemplo, ks3 para OMEGAMON for Storage on z/OS).
`classe`	Um dos mesmos valores para Classe Global, mas devido à sua posição dentro dos parênteses, a classe é restrita no escopo para se aplicar apenas ao unit_name especificado. Os seguintes são valores possíveis. As abreviações válidas estão entre parênteses. `ERROR` (ER): retorna somente mensagens de erro grave (esse é o padrão para a maioria dos aplicativos. `STATE` (ST): grava a condição ou a configuração atual de sinalizações e variáveis dentro do processo. Se o rastreio de estado estiver ativado, é possível ver o estado atual de variáveis ou sinalizadores específicos conforme o processo estiver em execução. `FLOW` (FL): faz com que uma mensagem seja gerada em um ponto de entrada ou de saída de uma função. `DETAIL` (DE): produz um nível detalhado de rastreio. `INPUT` (IN): registra dados que são criados na execução de uma função ou de um processo de API específica. `ALL`: faz com que todas as mensagens disponíveis sejam gravadas, uma combinação de todas as outras formas de rastreio.

Nota:

A configuração padrão para todos os componentes é KBB_RAS1=ERROR, significando que apenas o rastreio está ativado.
É possível especificar qualquer combinação de palavras-chave UNIT, COMP e ENTRY. Nenhuma dessas palavras-chave é necessária. No entanto, o valor do RAS1 configurado com a classe global aplica-se a todos os componentes.

Seguem alguns exemplos de sintaxe de rastreio do RAS1.

Exemplo 1: rastreando solicitações e respostas a partir do Tivoli Enterprise Monitoring Server:

Para mostrar pedidos para e respostas a partir do Tivoli Enterprise Monitoring Server, especifique esse rastreio:

KBB_RAS1=ERROR (UNIT:KRA ST ERR)

Os valores de unidade ST e ERR indicam que você está coletando informações de estado e de erro para o componente de estrutura do agente (KRA).

Esse tipo de rastreio de agente é utilizado apenas se você estiver tentando depurar um problema específico, porque ele aumenta grandemente o número de mensagens geradas pelo agente. Com esse tipo de rastreio, as mensagens incluem um dump detalhado de todas as linhas de dados do agente que transmitiram filtragem, o que inclui nomes e valores de atributo, nomes de pedido, nomes de tabela e intervalo de coleta. Lembre-se de desativar essa forma intensiva de recurso de rastreio imediatamente após ter concluído seu rastreio.

Exemplo 2: rastreando controlador de proxy e problemas do agente distribuído:

A partir do Tivoli Enterprise Monitoring Server para rastrear problemas do controlador de proxy e do agente distribuído do Tivoli Enterprise Monitoring Server, emita esse comando:

KBB_RAS1=ERROR (COMP:KUX ST ER) (UNIT:KRA ALL) (UNIT:KDS FL)

Nesse exemplo:

KUX é um identificador de componente fornecido por um representante do IBM Software Support para poder coletar informações de estado e de erro sobre esse subcomponente.
KRA é o nome da unidade para o componente de estrutura do agente. Todas as informações de rastreio sobre esse componente estão sendo capturadas.
KDS é o componente do Tivoli Enterprise Monitoring Server, e o fluxo (FL) de pontos de entrada ou de saída por meio desse componente é documentado com registros gravados no RKLVLOG.

As mensagens que exibem os dados coletados pelo método TakeSample podem ser visualizadas incluindo o rastreio RAS1 (UNIT:KRA OUTPUT) ou (UNIT:KRA ALL) na instrução do rastreio do agente.