WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Estrutura em árvore do ambiente local

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.

A árvore de ambiente local é formada pela seguinte estrutura:

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.

O Diagrama Mostra uma Estrutura em Árvore do Ambiente Local Criada por um Nó de Entrada e Analisador Fornecidos.

Na estrutura em árvore mostrada, LocalEnvironment possui vários filhos:

LocalEnvironment.Variables
Essa subárvore é opcional. Se você criar variáveis de ambiente local, armazene-as em uma subárvore chamada Variáveis. Ela fornece uma área de trabalho que pode ser utilizada para transmitir informações entre nós. Essa subárvore nunca é inspecionada ou modificada por nenhum nó fornecido.

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.

LocalEnvironment.Destination
O Diagrama Mostra a Subárvore de Destino, que É Descrita pelo Texto a seguir
Esta subárvore consiste em um número de filhos que indicam os tipos de transporte para os quais a mensagem é direcionada (os identificadores de Transporte) ou os nós Label de destino que são usados por um nó RouteToLabel.
  • Informações sobre transporte

    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

    Se o fluxo de mensagens incluir um nó CICSRequest, você pode substituir as seguintes propriedades com elementos nesta subárvore:
    • Nome do Programa
    • Comprimento da Commarea
    • ID de transação espelhada
    • Configurar EIBTRNID somente
    • Domínio de mensagem
    • Conjunto de Mensagens
    • Tipo de Mensagem
    • Formato de Mensagem
    • ID do conjunto de caracteres codificados de mensagens
    • Codificação de mensagens
    Para informações adicionais, consulte Substituições do Ambiente Local para o Nó de CICSRequest.

    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

    Se o fluxo de mensagens incluir um nó CORBARequest, é possível substituir sua propriedade Nome da operação especificando um valor no seguinte local:
    $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.

  • Informações sobre roteamento

    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.

LocalEnvironment.Wildcard
Esta subárvore contém informações sobre os caracteres curinga armazenados pelo nó FileInput.

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.

LocalEnvironment.WrittenDestination
O Diagrama Mostra a Subárvore de Destino Gravada, que É Descrita no seguinte Texto.
Esta subárvore 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:
  • Conecte um nó de transformação ao terminal de Saída.
  • 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.

LocalEnvironment.Adapter
Essa subárvore contém informações armazenadas pelos nós dos WebSphere Adapters.
Para um nó de entrada dos WebSphere Adapters:
  • MethodName é o nome do método de negócios que corresponde ao evento Enterprise Information System (EIS) que acionou a entrega dessa mensagem.

    As ligações para eventos ou métodos de negócios EIS são criadas pelo assistente de Conexão de Adaptador.

  • Tipo descreve o tipo de adaptador utilizado:
    • SAP
    • Siebel
    • PeopleSoft
    • JD Edwards

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.

LocalEnvironment.CD e LocalEnvironment.CD.Transfer
Essas subárvores contêm informações que são armazenadas pelo nó CDInput. A subárvore LocalEnvironment.CD contém informações sobre o registro atual. A subárvore LocalEnvironment.CD.Transfer contém informações recebidas do IBM® Sterling Connect:Direct relacionadas ao arquivo.

Há mais detalhes sobre as informações armazenadas nessas subárvores em Usando Variáveis de Ambiente Locais com Nós de Arquivo.

LocalEnvironment.Database
Essa subárvore contém informações que são propagadas a partir do nó DatabaseInput.

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.

LocalEnvironment.File
Esta subárvore contém informações armazenadas pelo nó FileInput.

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.

LocalEnvironment.FTE and LocalEnvironment.FTE.Transfer
Essas subárvores contêm informações que são armazenadas pelo nó FTEInput. A subárvore LocalEnvironment.FTE contpem informações sobre o registro atual. A subárvore LocalEnvironment.FTE.Transfer contém informações recebidas do WebSphere MQ File Transfer Edition em relação ao arquivo.

Há mais detalhes sobre as informações armazenadas nessas subárvores em Usando Variáveis de Ambiente Locais com Nós de Arquivo.

LocalEnvironment.JMS
Esta subárvore contém informações armazenadas pelo nó JMSReceive.

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.

LocalEnvironment.Mapping
Essa subárvore contém informações armazenadas pelo nó Mapeamento.

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.

LocalEnvironment.ServiceRegistry
Esta subárvore contém informações para consultas pelos nós EndpointLookup e RegistryLookup.

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.

LocalEnvironment.SOAP
Esta subárvore contém informações armazenadas pelos nós SOAPInput, SOAPAsyncResponse ou SOAPRequest.

Detalhes adicionais sobre as informações armazenadas nesta subárvore estão em Informações de WS-Addressing no Ambiente Local.

Se o fluxo de mensagens incluir um nó SOAPAsyncResponse, você poderá usar esta subárvore para receber informações de estado e correlação transmitidas por um nó SOAPAsyncRequest em outro fluxo de mensagens.

Detalhes adicionais sobre as informações armazenadas nesta subárvore estão em WS-Addressing com Nós SOAPAsyncRequest e SOAPAsyncResponse.

LocalEnvironment.TCPIP

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.

As seguintes amostras demonstram como usar o ambiente local para rotear mensagens dinamicamente com base na lista de destino: As amostras a seguir usam a árvore de ambiente local para armazenar informações que, posteriormente, são incluídas na mensagem de saída criada pelo fluxo de mensagens:

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.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:13


Tópico de ConceitoTópico de Conceito | Versão 8.0.0.5 | ac00520_