A árvore de ambiente local possui
seu próprio nome de correlação, LocalEnvironment, e você deve usar este
nome em todas as instruções ESQL que se referem a ou configuram o conteúdo
desta árvore.
A árvore de ambiente local é usada
pelo intermediário e você pode consultar e modificar estas informações. Também pode estender a árvore para conter informações
criadas por você mesmo.
É possível criar subárvores desta árvore que você pode usar como uma área de rascunho
ou área de trabalho.
O fluxo de mensagens configura informações em
duas subárvores, Destination e WrittenDestination, abaixo da raiz
LocalEnvironment. É possível consultar o conteúdo de ambas as subárvores e
você pode gravar na árvore Destino para influenciar a maneira na qual
o fluxo de mensagens processa sua mensagem. Entretanto, se você gravar na árvore Destino,
siga a estrutura definida para assegurar que a árvore permaneça válida.
A subárvore WrittenDestination
contém os endereços nos quais a mensagem foi gravada. Seu nome é fixo e é criada pelo fluxo de mensagens
quando uma mensagem é propagada através do terminal
Out de um nó de pedido, de saída ou de resposta. A subárvore inclui informações específicas de transporte
(por exemplo, se a mensagem de saída tiver sido colocada em uma fila do
WebSphere MQ,
ela incluirá o gerenciador de filas e os nomes de filas). É possível utilizar um dos seguintes
métodos para obter informações sobre os detalhes de uma mensagem quando ela tiver sido
enviada pelos nós:
- Conectar um nó Compute ao terminal
Out.
- Configurar uma saída de usuário para processar um evento de retorno de chamada de mensagem de saída,
conforme descrito em Explorando Saídas de Usuário.
O tópico para cada nó que suporta informações de WrittenDestination
contém detalhes sobre os dados que ele contém.
Se
você desejar que a árvore de ambiente local seja incluída na mensagem de saída
que é propagada pelo nó Compute,
deverá configurar a propriedade Modo de Cálculo do
nó Compute com um valor que inclua o ambiente
local (por exemplo, Todos). Se você não o fizer, a árvore de
ambiente local não será copiada na mensagem de saída.
As informações inseridas em Dados de Destino ou em
Padrões dependem da característica da propriedade do nó
correspondente:
- Se uma propriedade do nó estiver representada por uma caixa de opção (por exemplo, Novo ID de Mensagem), configure o elemento Defaults ou DestinationData
como Sim (equivalente a selecionar
a caixa de opção) ou Não (equivalente
a desmarcar a caixa de opção).
- Se uma propriedade do nó estiver representada por uma lista drop-down (por exemplo, Modo de Transação), configure o elemento Defaults ou DestinationData
como a cadeia de caracteres apropriada (por exemplo, Automático).
- Se uma propriedade do nó estiver representada por um campo de
entrada de texto (por exemplo, Nome do Gerenciador de
Filas), será necessário definir o elemento Defaults ou
DestinationData para a cadeia de caracteres que seria inserida nesse
campo.
Se necessário, configure o nó de envio para indicar onde estão as
informações de destino. Por exemplo, para o nó de saída MQOutput,
configure Modo de Destino:
- Se você definir Modo de Destino como Nome da Fila, a mensagem de saída
será enviada para a fila identificada nas propriedades do nó output Nome da Fila e Nome do Gerenciador de Filas. Destino não é referido
pelo nó.
- Se você definir Modo de Destino como Lista de Destino, o nó
extrairá as informações de destino da subárvore Destino. Se utilizar este valor, você poderá enviar uma única mensagem para
vários destinos, se configurar Destino e um único nó de saída corretamente. O nó verifica as propriedades do nó apenas
se um valor não está disponível no Destino (conforme descrito acima).
- Se você definir Modo de Destino como Fila Responder para,
a mensagem será enviada para a fila responder para no MQMD nesta mensagem
(campo ReplyToQ). Destino não é referido
pelo nó.
Para localizar mais informações sobre procedimentos ESQL que executam
atualizações típicas no ambiente local, consulte Preenchendo o Destino na Árvore de Ambiente Local.
Revise as instruções ESQL nestes procedimentos para ver como modificar
o ambiente local. Você pode utilizar estes procedimentos inalterados, ou modificá-los de acordo com seus próprios requisitos.
Para localizar mais informações
sobre como estender o conteúdo desta árvore para seus próprios propósitos,
consulte Usando Áreas de Rascunho no Ambiente Local.
Para obter outro
exemplo de como você pode usar o ambiente local para modificar o comportamento
de um fluxo de mensagens, consulte o fluxo de mensagens XML_PassengerQuery no
programa de amostra a seguir:
O nó
Compute neste fluxo de mensagens grava
uma lista de destinos na subárvore RouterList de Destino
que são utilizados como rótulos por um nó
RouteToLabel
posteriormente, que propaga a mensagem para o nó
Label correspondente.
Você
só pode visualizar informações sobre amostras quando usa o centro de informações
que está integrado ao WebSphere Message Broker Toolkit ou o centro de
informações on-line. Você só poderá
executar amostras quando usar o centro de informações que está integrado ao
WebSphere Message Broker Toolkit.