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

JMSReply

Utilize o nó JMSReply para enviar mensagens para destinos JMS.

Este tópico contém as seguintes seções:

Propósito

O nó JMSReply possui uma função semelhante ao nó JMSOutput, mas o nó JMSReply envia mensagens JMS apenas para o destino de resposta fornecido no campo de cabeçalho JMSReplyTo da árvore de mensagens JMS. Use o nó JMSReply quando deseja tratar uma mensagem JMS que seja produzida a partir de um fluxo de mensagens como uma resposta a uma mensagem de entrada JMS e onde você não tem nenhum outro requisito de roteamento.

O nó JMSReply está contido no repositório JMS da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó JMSReply

Utilizando o Nó JMSReply em um Fluxo de Mensagens

Considere uma situação em que você cria um fluxo de mensagens no qual uma mensagem do nó JMSInput obtém mensagens ponto a ponto de um destino JMS chamado MyJMSInputQueue. O fluxo de mensagens atualiza um banco de dados utilizando o conteúdo da mensagem, em seguida, responde a um destino JMS chamado MyJMSReplyQueue, que é configurado pela geração do aplicativo no cabeçalho JMSReplyTo da mensagem de entrada.

Em um cenário semelhante para o modelo de mensagem de Publicação/Assinatura, um nó JMSInput efetua assinatura em TopicA, e o nó JMSReply publica no destino TopicB, que foi recuperado do cabeçalho JMSReplyTo da mensagem de entrada.

Chamando uma Função de Retorno de Chamada de Mensagem de Saída

A função cciOutputMessageCallback pode ser registrada como um retorno e chamada sempre que uma mensagem for enviada por um nó JMSReply. Consulte o cciOutputMessageCallback.

Se o estado de saída do usuário estiver ativo, a função cciOutputMessageCallback será chamada para cada mensagem de saída que é enviada com êxito a partir de um nóJMSReply em que a chamada de retorno é registrada.

Se o nó fornece informações WrittenDestination na árvore LocalEnvironment, o retorno de chamada será chamado após estas informações serem criadas. Consulte o Usando Variáveis LocalEnvironment com Nós JMSOutput e JMSReply.

Trabalhando com o ID de Mensagem JMS

O ID de mensagem JMS é gerado pelo provedor JMS quando uma mensagem é enviada pelo nó JMSReply. Você não pode configurar o ID de mensagem no fluxo de mensagens, mas pode utilizar um dos seguintes métodos para obter o ID gerado após a mensagem ter sido enviada:
  • Conectar um nó Compute ao terminal Out.

    Conecte um nó Compute ao terminal de Saída de um nó JMSReply e interrogue a Lista WrittenDestination. Para obter informações adicionais, consulte Visualizando a Árvore Mensagem Lógica na Saída do Rastreio.

    Uma entrada para um nó JMSReply possui o seguinte formato:
    WrittenDestination = (
       JMS = (
          DestinationData = (
            destinationName = 'queue://jmsQueue1'
            initialContext = 'com.sun.jndi.fscontext.RefFSContextFactory'
            JMSMessageID = ID:414d512054657374514d2020202020206ab98b4520017a02'
            JMSCorrelationID = 'ABCDEFGHIJKLMNOPQRSTUVW'
      )
     )
    )
  • Configure uma saída de usuário para processar um evento de retorno de chamada da mensagem de saída. Para obter informações adicionais, consulte Explorando Saídas de Usuário.

Terminais e Propriedades

Quando tiver colocado uma instância do nó JMSReply em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco.

Os terminais do nó JMSReply são descritos na tabela a seguir.

Terminal Descrição
Failure O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. Mesmo que a propriedade Validação (Validation) esteja definida, as mensagens propagadas para esse terminal não serão validadas.
Saída O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila do WebSphere MQ.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco se você precisar inserir um valor quando nenhum padrão estiver definido), a coluna com cabeçalho C indica se a propriedade é configurável (você pode alterar o valor quando incluir o fluxo de mensagens no arquivo BAR para implementá-lo).

As propriedades Descrição do nó JMSReply são descritas na tabela a seguir.
Propriedade M P Default Descrição
Nome de nó Não Não O tipo de nó O nome do nó.
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.
As propriedades Básicas do nó JMSReply são descritas na tabela a seguir.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Enviar para a lista de destino no ambiente local Não Sim Não selecionada Quando você tiver construído uma lista de destinos JMS no ambiente local, selecione esta caixa de opção para usar a lista de destino. Se você não selecionar esta caixa de opção, o nó utilizará o destino JMS configurado. Se você selecionar esta caixa de opção mas não tiver criado uma lista de destinos de JMS no ambiente local, o nó usará o destino de JMS configurado. useDistList
As propriedades Conexão JMS do nó JMSReply são descritas na tabela a seguir.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Nome do provedor JMS Sim Não WebSphere MQ Selecione um nome de fornecedor JMS na lista ou digite um nome de sua preferência. Quando você selecione um nome na lista, a propriedade Gerador de Contexto Inicial é atualizada automaticamente com a classe Java™ relevante. Se você digitar seu próprio nome de provedor JMS, também deverá digitar um valor para o Gerador de Contexto Inicial. O valor padrão é WebSphere MQ.

Alternativamente, é possível especificar o serviço configurável JMSProviders.

 
Fábrica de Contexto Inicial Não Sim
com.sun.jndi.fscontext. 
RefFSContextFactory
Essa propriedade é o ponto de início de um namespace JNDI. Um aplicativo JMS utiliza o contexto inicial para obter e consultar a connection factory e objetos de fila ou tópico para o provedor JMS. Se você selecionar um nome de provedor JMS na lista em Nome de Provedor JMS, a propriedade Gerador de Contexto Inicial é atualizada automaticamente com a classe Java relevante. Se você digitar seu próprio nome de provedor JMS, também deverá digitar um valor para o Gerador de Contexto Inicial.
O valor padrão de
com.sun.jndi.fscontext.
RefFSContextFactory
define o factory de contexto inicial com base em arquivo para o provedor JMS do WebSphere MQ.

Se o nó for configurado para utilizar seu próprio Provedor JMS e a Propriedade de serviços configuráveis da definição mqsichangeproperties tiver o conjunto de atributos InitialContextFactory, isso substituirá a configuração no nó.

initialContextFactory
Ligações JNDI de Local Não Sim   Esta propriedade especifica o caminho do sistema de arquivo ou o local de LDAP para o arquivo de ligações. O arquivo de ligações contém definições para objetos administrados JNDI que são utilizados pelo nó JMSReply.

Ao digitar um valor para Ligações JNDI de Local (Location JNDI Bindings), assegure-se de que ele esteja de acordo com as seguintes instruções:

  • Construa o arquivo de ligações antes de implementar um fluxo de mensagens que contém um nó JMSReply.
  • Não inclua o nome do arquivo de ligações nesse campo.
  • Se você tiver especificado um local do LDAP que exija autenticação, configure o proprietário LDAP (ID do usuário) e as credenciais LDAP (senha) separadamente. Estes valores são configurados no nível do broker. Para obter informações sobre como configurar esses valores, consulte os comandos mqsicreatebroker e mqsichangebroker.
  • O valor da cadeia deve incluir um prefixo URL suportado que tenha um manipulador de URL que esteja disponível no caminho de classe.

Para obter informações sobre como construir o arquivo de ligações de objetos administrados por JNDI, consulte a documentação fornecida com o provedor JMS.

Se o nó estiver configurado para usar seu próprio Provedor JMS e a Propriedade de serviços configuráveis correspondente da definição mqsichangeproperties possuir o atributo jndiBindingsLocation configurado, isso substituirá a configuração no nó.

locationJndiBindings
Nome da Connection Factory Não Sim   O nome da connection utilizada pelo nó JMSReply para criar uma conexão com o provedor JMS. Esse nome já deve existir no arquivo de ligações. connectionFactoryName
As propriedades Avançadas do nó JMSReply são descritas na tabela a seguir.
Propriedade M P Default Descrição
Novo ID de Correlação Não Sim Não selecionada Se o nó JMSReply precisar gerar um novo ID de Correlação para a mensagem, selecione a caixa de opção. A caixa de opções fica desmarcada por padrão; se você deixar a caixa de opções desmarcada, o ID de Correlação (Correlation ID) da mensagem de saída será obtido do campo JMSCorrelationID na seção JMSTransport_Header_Values da árvore de mensagens.
Modo de Transação Não Não Não
Essa propriedade controla se a mensagem é recebida em uma transação JMS. Os valores válidos são Sim e Não.
  • Selecione Não para receber a mensagem usando uma sessão JMS não transacional.
  • Selecione Sim para receber a mensagem usando uma sessão JMS transacional. A transação JMS pode ser local ou coordenada por XA. Para usar uma transação coordenada por XA usando uma sessão JMS XA, você também deve selecionar a propriedade de fluxo de mensagens Transação Coordenada nas propriedades do arquivo BAR. Consulte o Configurando para Transações JMS Coordenadas.
O valor configurado para Modo de Transação no nó JMSReply é herdado pelo recebimento de dados de nós no fluxo de mensagens que têm seu Modo de Transação configurado como Automático. Outros recursos que executam trabalho no fluxo de mensagens, como DB2 ou WebSphere MQ, usam transações independentemente da configuração Modo de Transação do nó e confirmam suas transações após o processamento da mensagem.
Modo de Entrega Não Sim Automático Essa propriedade controla o modo de persistência que um provedor JMS utiliza para uma mensagem. Os valores válidos são:
  • Automático (Automatic): o modo da mensagem de entrada é herdado
  • Persistente (Persistent): a mensagem permanecerá se o provedor JMS tiver uma falha do sistema
  • Não-persistente: a mensagem será perdida se o provedor JMS tiver um falha do sistema
Expiração da Mensagem (Message Expiration (ms)) Sim Sim 0 Esta propriedade controla o período de tempo, em milissegundos, durante o qual o provedor JMS mantém a mensagem JMS de saída. O valor padrão, 0, é utilizado para indicar que a mensagem não deve expirar.
Selecione Herdar do Cabeçalho ou digite um inteiro que representa um número de milissegundos. Se você selecionar Herdar do Cabeçalho, a propriedade herdará o valor do campo JMSExpiry na mensagem JMS, que está localizada no seguinte local:
OutputRoot.JMSTransport.Transport_Folders.Header_Values.JMSExpiration
Prioridade de Mensagem Não Sim 4 Esta propriedade designa a importância relativa à mensagem e pode ser utilizada para seleção de mensagem por um aplicativo cliente JMS de recebimento ou um nó JMSReply.

Selecione um valor entre 0 (prioridade mais baixa) e 9 (prioridade mais alta) ou selecione Herdar do Cabeçalho.

O valor padrão é 4, que indica prioridade média. As prioridades no intervalo de 0 a 4 estão relacionadas à entrega normal. As prioridades no intervalo de 5 a 9 estão relacionadas a graus de entrega expedida. Se você selecionar Herdar do Cabeçalho, a propriedade herdará o valor do campo JMSPriority na mensagem JMS, que está localizada no seguinte local:
OutputRoot.JMSTransport.Transport_Folders.Header_Values.JMSPriority
Tipo de Mensagem Não Sim TextMessage Esta propriedade controla a classe da mensagem de saída JMS. O valor padrão é TextMessage. Os valores válidos são:
  • TextMessage
  • BytesMessage
  • MapMessage
  • StreamMessage
  • ObjectMessage
  • Mensagem JMS base sem carga útil
Se você não configurar esta propriedade, o nó assumirá o tipo de saída do campo PayLoadType de metadados na árvore de mensagens JMS.
As propriedades Validação do nó JMSReply são descritas na tabela a seguir. Consulte Propriedades de Validação para obter uma descrição completa dessas propriedades.
Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Herdar Essa propriedade controla se a validação ocorre. Os valores válidos são:
  • Nenhuma
  • Conteúdo e Valor (Content and Value)
  • Conteúdo
  • Herdar
Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada.
validateMaster
Ação de Defeito Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são:
  • Rastreio do Usuário
  • Local Error Log
  • Exceção (Exception) (valor padrão)
  • Lista de Exceções (Exception List)
 
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

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


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac37130_