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:
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.