A árvore do ambiente local é uma parte da árvore de mensagem lógica na qual você pode armazenar informações enquanto o fluxo de mensagens processa a mensagem.
A raiz da árvore de ambiente local é denominada LocalEnvironment. Esta árvore está sempre presente na mensagem de entrada, e é criada quando uma mensagem é recebida pelo nó de entrada. Alguns nós de entrada criam campos de ambiente local, outros deixam-na vazia.
Utilize a árvore de ambiente local para armazenar variáveis que podem ser referidas e atualizadas por nós de processamento de mensagens que ocorram posteriormente no fluxo de mensagens. Você também pode utilizar a árvore de ambiente local para definir destinos (que são internos e externos para o fluxo de mensagens) para os quais uma mensagem é enviada. O WebSphere Message Broker também armazena informações no LocalEnvironment em algumas circunstâncias e faz referência a ele para acessar valores que podem ser sido configurados para destinos. (Compare com a estrutura em árvore Ambiente, que o broker usará apenas em situações específicas; consulte Estrutura da Árvore Ambiente.)
A figura a seguir mostra um exemplo de estrutura em árvore de ambiente local. Os filhos de Destino são dependentes de protocolo.
Na estrutura em árvore mostrada, LocalEnvironment possui vários filhos:
Variáveis no ambiente local podem ser alteradas por qualquer nó de processamento de mensagem subsequente e as variáveis persistem até o nó que as criou ficar sem escopo.
As variáveis nesta subárvore são persistentes apenas em uma única instância de um fluxo de mensagens. Se você tiver várias instâncias de uma mensagem que passa pelo fluxo de mensagens e precisar transmitir informações entre elas, será necessário utilizar um banco de dados externo.
As informações de transporte são usadas por alguns nós de entrada e de saída, incluindo Email, Arquivo, FTE, HTTP, JMS, MQ, SOAP e TCPIP.
LocalEnvironment.Destination.CICS
Você também pode configurar valores LocalEnvironment para canais e contêineres do CICS. Para obter informações adicionais, consulte Estruturas de Dados COMMAREA ou de Canal.
LocalEnvironment.Destination.CORBA
$LocalEnvironment/Destination/CORBA/Request/OperationName
Para obter informações adicionais sobre o nome da operação, consulte Nó CORBARequest.LocalEnvironment.Destination.Email
Se o fluxo de mensagens incluir um nó EmailOutput, as informações definidas nesta subárvore especificarão ou substituirão as informações de conexão do servidor SMTP e os anexos associados a cada e-mail enviado pelo nó. Múltiplos anexos podem ser especificados para inclusão no e-mail enviado, incluindo a especificação do nome, conteúdo e tipo de anexo. Consulte o Nó EmailOutput.
LocalEnvironment.Destination.File
Se o fluxo de mensagens incluir um nó FileOutput, você poderá substituir suas propriedades directory e name por elementos nesta subárvore. Consulte o Usando Variáveis de Ambiente Locais com Nós de Arquivo.
LocalEnvironment.Destination.FTE
Se o fluxo de mensagens incluir um nó FTEOutput, você pode substituir suas propriedades por elementos nessa subárvore. Consulte o Usando Variáveis de Ambiente Locais com Nós de Arquivo.
LocalEnvironment.Destination.HTTP
Se o fluxo de mensagens for iniciado com um nó HTTPInput, um único elemento de nome HTTP será incluído no Destino. O elemento HTTP.RequestIdentifier é criado e inicializado para que possa ser utilizado por um nó HTTPReply. Você também pode criar outros campos na estrutura HTTP para uso pelo nó HTTPRequest; por exemplo, a URL do serviço para o qual o pedido é enviado. O tópico de cada nó contém informações adicionais sobre o conteúdo de Destino para o protocolo WebSphere MQ Web Services Transport.
LocalEnvironment.Destination.JMSDestinationList
Um nó JMSOutput pode ser configurado para enviar múltiplas Filas JMS ou para publicar em múltiplos Tópicos JMS usando uma lista de destino criada no ambiente local por um nó de transformação.
O nó JMSOutput procura o ambiente local para os elementos de dados denominados DestinationData na pasta Destination.JMSDestinationList. O nó envia a mensagem JMS para cada entrada DestinationData localizada nessa pasta. Consulte o exemplo em Preenchendo o Destino na Árvore de Ambiente Local.
LocalEnvironment.Destination.MQ
Se o fluxo de mensagens incluir um nó MQOutput, cada elemento é um elemento de nome, MQ (Existe uma alternativa reprovada, chamada MQDestinationList. Utilize MQ para todos os novos fluxos de mensagens). Se existir mais de um elemento, cada um será será processado pelo nó de forma seqüencial. Consulte o exemplo em Preenchendo o Destino na Árvore de Ambiente Local.
É possível configurar nós MQOutput para examinar a lista de destinos e enviar a mensagem para esses destinos, configurando a propriedade Modo de Destino para Lista de Destino. Se fizer isso, deverá criar essa subárvore e seu conteúdo para definir esses destinos, fornecendo a ela o nome de Destino. Se você não fizer isso, o nó MQOutput não poderá entregar as mensagens.
Se você preferir, poderá configurar o nó MQOutput para enviar mensagens a um único destino fixado, configurando a propriedade Modo de Destino para Nome da Fila ou Resposta à Fila. Se você selecionar qualquer uma dessas opções fixas, a lista de destinos não terá nenhum efeito nas operações do broker e não será necessário criar essa subárvore.
Você pode construir o elemento MQ de modo a conter um único elemento opcional Defaults. O elemento Defaults, se criado, deverá ser o primeiro filho e deverá conter um conjunto de elementos de nome/valor que fornecem os valores padrão para o destino da mensagem e suas opções PUT para esse pai.
Você também pode criar vários elementos chamados DestinationData no MQ. Cada um deles pode ser configurado com um conjunto de elementos de nome/valor que definem um destino de mensagem e suas opções PUT.
O conjunto de elementos que definem um destino é descrito em Tipos de Dados para Elementos na Subárvore MQ DestinationData.
O conteúdo de cada instância de Dados de Destino é igual ao conteúdo de Padrões para cada protocolo e pode ser utilizado para substituir os valores padrão em Padrões. Você pode configurar Padrões para conter valores que são comuns a todos os destinos e definir apenas os valores exclusivos em cada subárvore DestinationData. Se você não configurar um valor em DestinationData ou Defaults, o valor configurado para a propriedade do nó correspondente é utilizado. De maneira semelhante, se você especificar um nome ou valor de campo com a ortografia ou tipo errado, ele é ignorado e o valor definido para a propriedade de nó correspondente é utilizado.
As informações inseridas no DestinationData dependem da característica da propriedade do nó correspondente: essas informações estão descritas em Acessando a Árvore de Ambiente Local.
LocalEnvironment.Destination.SOAP
É possível colocar as informações do cabeçalho WS-Addressing de saída no ambiente local para substituir os padrões que são gerados pelos nós SOAPReply, SOAPRequest ou SOAPAsyncRequest. Consulte o Informações de WS-Addressing no Ambiente Local.
Se um fluxo de mensagens incluir os nós SOAPRequest ou SOAPAsyncRequest, é possível substituir suas propriedades de Transporte HTTP e de transporte JMS nessa subárvore. Consulte Nó SOAPRequest, Nó SOAPAsyncRequest ou Substituições do Ambiente Local para o Nó de SOAPRequest.
Se o fluxo de mensagens incluir um nó SOAPAsyncRequest, você poderá usar esta subárvore para transmitir informações de estado e correlação para um nó SOAPAsyncResponse em outro fluxo de mensagens. Consulte o WS-Addressing com Nós SOAPAsyncRequest e SOAPAsyncResponse.
Se o fluxo de mensagens incluir nós SOAPReply, SOAPRequest ou SOAPAsyncRequest, você poderá substituir o uso de suas mensagens MTOM de saída nesta subárvore. Consulte o Utilizando SOAP MTOM com os Nós SOAPReply, SOAPRequest e SOAPAsyncRequest.
LocalEnvironment.Destination.TCPIP
Se o fluxo de mensagens incluir um nó TCPIPClientOutput ou um nó TCPIPServerOutput, você poderá substituir sua conexão TCPIP por elementos nesta subárvore. Consulte Nó TCPIPClientOutput e Nó TCPIPServerOutput.
O filho de Destino é Lista de Roteadores. Ele possui um único elemento filho chamado Dados de Destino, que possui uma única entrada chamada Nome do Rótulo. Se estiver utilizando um cenário de roteamento dinâmico que envolve os nós RouteToLabel e Label, será necessário configurar a subárvore Destino com um RouterList que contenha rótulos de referência.
No nó FileInput, é possível especificar um padrão de nome de arquivo que contenha caracteres curinga.
Detalhes adicionais sobre as informações armazenadas nesta subárvore estão em Usando Variáveis de Ambiente Locais com Nós de Arquivo.
O tópico para cada nó que suporta informações de WrittenDestination contém detalhes sobre os dados que ele contém.
As ligações para eventos ou métodos de negócios EIS são criadas pelo assistente de Conexão de Adaptador.
Para um nó da solicitação do WebSphere Adapters:
MethodName é o nome do método de negócios que o nó de pedido deve utilizar.
Há mais detalhes sobre as informações armazenadas nessas subárvores em Usando Variáveis de Ambiente Locais com Nós de Arquivo.
A subárvore LocalEnvironment.Database.Input.Event.Usr contém dados definidos pelo usuário associados a um evento. Ela é inicializada no procedimento ReadEvents do módulo ESQL associado ao nó DatabaseInput.
LocalEnvironment.Database.Input.Event.Key contém uma chave exclusiva para um evento. Ela é configurada no procedimento ReadEvents do módulo ESQL associado ao nó DatabaseInput.
LocalEnvironment.Database.Input.Event.FailureCount contém um valor para o número de vezes que uma tentativa de processar um evento falha. Essa contagem inclui todas as exceções não manipuladas que ocorrem no módulo ESQL ou no fluxo de mensagens.
Estas informações descrevem o arquivo e também contêm dados sobre o registro atual.
Detalhes adicionais sobre as informações armazenadas nesta subárvore estão em Usando Variáveis de Ambiente Locais com Nós de Arquivo.
Há mais detalhes sobre as informações armazenadas nessas subárvores em Usando Variáveis de Ambiente Locais com Nós de Arquivo.
Se o fluxo de mensagens incluir um nó JMSReceive, você poderá substituir suas propriedades de conexão JMS com elementos desta subárvore.
Mais detalhes sobre essas informações que estão armazenadas nessa subárvore estão em Substituições do Ambiente Local para o Nó de JMSReceive.
Se o fluxo de mensagens incluir um nó Mapeamento, será possível substituir a rotina de mapeamento usada para transformar uma instância da mensagem especificando-se uma nova rotina de mapeamento no campo MappingRoutine. Você deve especificar a nova rotina de mapeamento na subárvore LocalEnvironment.Mapping que é o envio de dados do nó Mapeamento que você precisa modificar.
Detalhes adicionais sobre as informações armazenadas nesta subárvore estão em Definindo Dinamicamente os Critérios de Procura, Saída do Nó EndpointLookup e Saída do Nó RegistryLookup.
Detalhes adicionais sobre as informações armazenadas nesta subárvore estão em Informações de WS-Addressing no Ambiente Local.
Detalhes adicionais sobre as informações armazenadas nesta subárvore estão em WS-Addressing com Nós SOAPAsyncRequest e SOAPAsyncResponse.
Se o fluxo de mensagens incluir um nó TCPIPClientReceive ou um nó TCPIPServerReceive, você poderá substituir sua conexão TCPIP por elementos nesta subárvore. Consulte Nó TCPIPClientReceive e Nó TCPIPServerReceive.
Esta subárvore contém informações que são armazenadas pelos nós TCPIPClientInput, TCPIPClientReceive, TCPIPServerInput e TCPIPServerReceive.
Estas informações descrevem a conexão que o nó está usando.
Mais detalhes sobre as informações que são armazenadas nesta subárvore estão em Nó TCPIPClientInput, Nó TCPIPClientReceive, Nó TCPIPServerInput e Nó TCPIPServerReceive.
Quando o processamento do fluxo de mensagens é concluído, a árvore de ambiente local é descartada.
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.