Visualizando a Árvore Mensagem Lógica na Saída do Rastreio

Para visualizar a estrutura da árvore de mensagens lógica em qualquer ponto no fluxo de mensagens, inclua um nó Trace e grave algumas ou todas as mensagens (incluindo cabeçalhos e todas as quatro árvores de mensagens) no destino de saída do rastreio.

Talvez você ache útil a saída de rastreio para verificar ou registrar o conteúdo de uma mensagem antes e depois de o nó fazer alterações nela, ou no seu recebimento pelo nó de entrada. Por exemplo, se você incluir um nó Compute que cria uma lista de destino em LocalEnvironment, talvez você queira um registro da estrutura que ele criou como parte de uma trilha de auditoria ou queira verificar se o nó Compute está trabalhando conforme esperado.

UNIX platform Início da mudançaNo UNIX, entradas syslog são limitadas por extensão e mensagens enviadas ao syslog são truncadas pelo caractere da nova linha. Para registrar uma grande quantidade de dados em um log no UNIX, configure a propriedade Destino no nó Trace para Arquivo ou Rastreio de Usuário em vez de Log de Erros Local.Fim da mudança

  1. Alterne para o Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
  2. Abra o fluxo de mensagens para o qual você deseja visualizar as mensagens. Abra um fluxo de mensagens existente ou crie um novo fluxo de mensagens.
  3. Inclua um nó Trace sempre que quiser visualizar parte ou toda a estrutura de árvore de mensagens. Você pode incluir quantos nós Trace escolher; entretanto, cada nó apresenta alguma sobrecarga para o processamento do fluxo de mensagens.
  4. Defina as propriedades do nó Trace para rastrear a mensagem ou partes da mensagem que você deseja visualizar. Especifique as partes da mensagem utilizando as referências de campo ESQL. Vários exemplos são incluídos abaixo.
  5. Se você incluiu um nó Trace para investigar um determinado comportamento do fluxo de mensagens, e agora resolveu suas preocupações ou verificou que o fluxo de mensagens está funcionando corretamente, remova o nó, ou os nós, Trace e implemente o fluxo de mensagens novamente.

Considere que tenha configurado um fluxo de mensagens que recebe uma mensagem XML em uma fila WebSphere MQ em um nó MQInput . A mensagem de entrada inclui um cabeçalho MQRFH2. O conteúdo da mensagem é mostrado abaixo:

<Trade type='buy'
 Company='IBM'
 Price='200.20'
 Date='2000-01-01'
 Quantity='1000'/>

Você pode incluir e configurar um nó Trace para produzir a saída que mostra uma ou mais das árvores criadas a partir dessa mensagem: o corpo da mensagem e as árvores Ambiente, LocalEnvironment e Exceção. Se você escolher por registrar o conteúdo do corpo da mensagem, a árvore Propriedades e o conteúdo de todos os cabeçalhos (neste exemplo, pelo menos um MQMD e um MQRFH2) serão incluídos. Você especifica que deseja ser registrado quando definir a propriedade Padrão do nó Trace. Você pode utilizar a maioria dos nomes de correlação para definir esse padrão (você não pode utilizar esses nomes que são específicos para o nó Compute).

Corpo da Mensagem
Se você quiser que o nó Trace grave a árvore do corpo da mensagem incluindo Propriedades e todos os cabeçalhos, defina Padrão como $Root. Se você deseja apenas os dados da mensagem, defina o Padrão como ${Body}.

A saída do rastreio gerada para a árvore de mensagens da mensagem mostrada acima com Padrão definido como $Root deve ser semelhante a:

Root
        Properties
           CreationTime=GMTTIMESTAMP '1999-11-24 13:10:00' (um campo de timestamp GMT)
     ... e outros campos ...
       MQMD         PutDate=DATE '19991124' (um campo de data)
          PutTime=GMTTIME '131000'                                 (um campo GMTTIME)
     ... e outros campos ...
       MQRFH          mcd          msd='xml' (um campo de cadeia de caracteres)
          .. e outros campos ...
       XML
                  Trade
          type='buy'                                             (um campo de cadeia de caracteres)
          Company='IBM'                                           (um campo de cadeia de caracteres)
          Price='200'                                             (um campo de cadeia de caracteres)
          Date='2000-01-01'                                       (um campo de cadeia de caracteres)
          Quantity='1000'                                         (um campo de cadeia de caracteres)
Environment
Para rastrear dados na árvore de ambientes, defina Padrão como ${Environment}. Essa configuração produz uma saída semelhante a esta:
 (0x1000000)Environment = (
         (0x1000000)Variables = (
                (0x1000000)MyVariable1 = (
                    (0x2000000) = '3'
        )
                (0x1000000)MyVariable2 = (
                    (0x2000000) = 'Hello'
        )
      )
  ) 

Para rastrear determinadas variáveis na pasta de variáveis da árvore de ambientes, você pode utilizar um padrão mais específico, por exemplo ${Environment.Variables.MyVariable1} . Essa configuração retorna o valor apenas (por exemplo, ela retorna apenas o valor 3).

LocalEnvironment
Para rastrear dados na árvore Ambiente Local, defina Padrão como ${Ambiente Local}. A saída obtida é similar ao exemplo a seguir, que mostra uma lista de destino criada dentro da árvore Ambiente Local:
(0x1000000)Destination = (
        (0x1000000)MQ                = (
            (0x1000000)DestinationData = (
                (0x3000000)queuename = 'MQOUT'
      )
    )
          (0x1000000)MQDestinationList = (
            (0x1000000)DestinationData = (
                (0x3000000)queuename = 'OLDMQOUT'
      )
    )
        (0x1000000)RouterList        = (
            (0x1000000)DestinationData = (
                (0x3000000)labelname = 'continue'
      )
            (0x1000000)DestinationData = (
                (0x3000000)labelname = 'custdetails'
      )
            (0x1000000)DestinationData = (
                (0x3000000)labelname = 'trade'
      )
    )
  )      

Outro exemplo, mostrado a seguir, inclui uma pasta WrittenDestination. Esse exemplo representa um rastreio que foi gravado por um nó Trace que é incluído depois de um nó MQOutput, onde o terminal Out do nó MQOutput está conectado a uma seqüência de nós que incluem o nó Trace. Quando um terminal Out é conectado, LocalEnvironment é aumentado com informações sobre a ação que o nó de saída executou.

(0x1000000)Destination = (
        (0x1000000)MQ                = (
            (0x1000000)DestinationData = (
                (0x3000000)queuename = 'MQOUT'
      )
    )
    (0x1000000)WrittenDestination = (
        (0x1000000)MQ                = (
            (0x1000000)DestinationData = (
                (0x3000000)queueName        = 'MQOUT'
                (0x3000000)queueManagerName = 'MQSI_SAMPLE_QM'
                (0x3000000)replyIdentfier   =
X'414d51204d5153495f53414d504c455f1f442f3b12600100'
                (0x3000000)msgId            =
X'414d51204d5153495f53414d504c455f1f442f3b12600100'
                (0x3000000)correlId         =
X'000000000000000000000000000000000000000000000000'
	(0x03000000):GroupId          = X'414d512042524f4b45523220202020203f59934620001803'
      )
    )
  )
)
ExceptionList
Para rastrear dados na lista de exceções, defina Padrão como ${Lista de Exceção}.

Você também pode exibir a estrutura de mensagens e outras informações dentro do fluxo de mensagens, quando utilizar o depurador de fluxo.

Conceitos relacionados
Visão Geral de Fluxos de Mensagens
Estrutura de Árvore Lógica
Nomes de Correlação
Visão Geral do Depurador de Fluxo
Tarefas relacionadas
Projetando um Fluxo de Mensagens
Manipulando o Conteúdo do Corpo da Mensagem
Manipulando Outras Partes da Árvore de Mensagem
Testando e Depurando Aplicativos do fluxo de mensagens
Referências relacionadas
Nó Trace
Nó MQInput
Nó MQOutput
Estrutura da Lista de Exceções
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:49

ac16810_