Estrutura em Árvore Environment

A árvore de ambiente faz parte da árvore de mensagem lógica na qual você pode armazenar informações enquanto a mensagem é transmitida através do fluxo de mensagens.

A raiz da árvore de ambiente é chamada de Ambiente. Esta árvore está sempre presente na mensagem de entrada; uma árvore de ambiente vazia é criada quando uma mensagem é recebida e analisada pelo nó de entrada. Você pode utilizar essa árvore como quiser e criar seu conteúdo e estrutura.

WebSphere Message Broker refere-se a (mas nunca cria) um campo nesta árvore em apenas uma situação. Se você solicitou a coleta de dados para a contabilidade e estatísticas do fluxo de mensagens e indicou que o suporte básico de origem da contabilidade é obrigatório, o intermediário verificará a existência do campo Environment.Broker.AccountingOrigin. Se existir, o intermediário utilizará seu valor para definir a origem da contabilidade para o registro de dados atual. Para obter informações adicionais sobre o uso deste campo, consulteDefinindo a Origem da Contabilidade de Fluxo de Mensagens e da Contabilidade de Estatísticas. (Compare com o Estrutura em árvore do ambiente local, utilizado pelo intermediário em várias situações.)

A árvore de ambiente difere da árvore de ambiente local no fato de que uma única instância dela é mantida por todo o fluxo de mensagens. Se você incluir um nó Compute, um nó Mapeamento ou um nó JavaCompute em seu fluxo de mensagens, você não precisará especificar se deseja que a árvore de ambiente seja incluída na mensagem de saída. A árvore de ambiente é incluída automaticamente e o conteúdo inteiro da árvore de ambiente de entrada é retido na árvore de ambiente de saída, sujeito a qualquer modificação que você faça no nó. Qualquer alteração feita torna-se disponível nos nós subseqüentes no fluxo de mensagens e em nós anteriores se os fluxos de mensagens voltarem (por exemplo, para um nó FlowOrder ou nó TryCatch).

Se você desejar criar suas próprias informações, crie-as na árvore de ambiente em uma subárvore chamada Variáveis.

A figura a seguir mostra um exemplo de uma árvore de ambiente:

Uma árvore Ambiente, com uma subárvore Variáveis que contém cinco filhos. O quinto filho também contém filhos.

Você pode utilizar as seguintes instruções ESQL para criar o conteúdo mostrado acima.

SET Environment.Variables =       ROW('granary' AS bread,
'riesling' AS wine, 'stilton' AS cheese);
SET Environment.Variables.Colors[] =
      LIST{'yellow', 'green', 'blue', 'red', 'black'};
SET Environment.Variables.Country[] = LIST{ROW('UK' AS name, 'pound'
AS currency),
   ROW('USA' AS name, 'dollar' AS currency)};

Quando o processamento do fluxo de mensagens estiver concluído, a árvore Ambiente será descartada.

Conceitos relacionados
Modelagem de Mensagens
Estrutura em árvore do ambiente local
Nomes de Correlação
Tarefas relacionadas
Desenvolvendo Fluxos de Mensagens
Acessando a Árvore de Ambiente
Definindo a Origem da Contabilidade de Fluxo de Mensagens e da Contabilidade de Estatísticas
Gravando ESQL
Gravando Java
Referências relacionadas
Nós Internos
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac12620_