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

MQReply

Utilize o nó MQReply para enviar uma resposta para o originador da mensagem de entrada.

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

Finalidade

O nó MQReply é um formato especializado do nó MQOutput que coloca a mensagem de saída na fila do WebSphere MQ que é identificada pelo campo ReplyToQ do cabeçalho de mensagem de entrada. Se apropriado, você pode definir a fila como uma fila em cluster ou fila compartilhada do WebSphere MQ.

O nó MQReply utiliza as opções que são enviadas no campo Relatório no MQMD. Pelo padrão (se nenhuma opção for configurada), o nó MQReply gera um novo campo MsgId na mensagem de resposta e copia o ID de mensagem da mensagem de entrada para o campo CorrelId na mensagem de resposta. Se o aplicativo de recebimento esperar outros valores nesses campos, assegure-se de que o aplicativo que coloca a mensagem na fila de entrada do fluxo de mensagens defina as opções de relatórios necessárias ou de que você configure as opções adequadas no MQMD durante o processamento de mensagens no fluxo de mensagens; por exemplo, utilize um nó Compute para configurar as opções de Relatório na mensagem.

Mais informações sobre o campo Relatório estão disponíveis na seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

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

 Ícone do nó MQReply

Utilizando este nó em um fluxo de mensagens

Examine a amostra a seguir para ver como utilizar esse nó:

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.

Você pode utilizar este nó quando receber um pedido de um cliente. Quando a mensagem de pedido é processada, uma resposta é enviada para cliente confirmando o recebimento do pedido e fornecendo uma possível data de entrega.

Trabalhando com Dados na Pasta WrittenDestination

Após a mensagem ter sido colocada na fila de resposta, a pasta WrittenDestination na árvore de ambiente local é atualizada com as informações de destino. Uma pasta WrittenDestination para um nóMQOutput possui o seguinte formato:
WrittenDestination = (
   MQ  = (
      DestinationData = (
         queueName        = 'OUT'
         queueManagerName = 'MYQUEUEMANAGER'
         replyIdentifier = X'4d...2e'
         msgId           = X'3c...2c'
         correlId        = X'2a...00'
         GroupId         = X'3a...00'
      )
   )
)

Configurando o Nó MQReply

Quando tiver colocado uma instância do nó MQReply 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.

Configure o nó MQReply da seguinte forma:

  1. Opcional: na guia Descrição, digite uma descrição curta e/ou longa. Você também pode renomear o nó nessa guia.
  2. Na guia Avançado:
    1. Selecione Segmentação Permitida (Segmentation Allowed) para que o WebSphere MQ divida a mensagem em segmentos no gerenciador de filas, quando apropriado. Também é necessário definir MQMF_SEGMENTATION_ALLOWED no campo MsgFlags no MQMD para que a segmentação ocorra.

      Mais informações sobre as opções para as quais esta propriedade é mapeada estão disponíveis na seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

    2. Escolha o modo de persistência que deseja para a mensagem de saída.
      • Se você selecionar Automático (o padrão), a persistência será conforme especificada na mensagem de entrada.
      • Se selecionar Sim, a mensagem será colocada de forma persistente.
      • Se selecionar Não, a mensagem será colocada de forma não persistente.
      • Se selecionar Conforme Definido para a Fila, a persistência da mensagem será conforme definida na fila do WebSphere MQ.
    3. Escolha o modo de transação que deseja para a mensagem de saída.
      • Se você selecionar Automático (o padrão), a transacionalidade da mensagem será derivada de como ela foi especificada no nó MQInput.
      • Se você selecionar Sim, a mensagem será colocada de forma transacional.
      • Se selecionar Não, a mensagem será colocada de forma não transacional.
  3. Na guia Validação, configure as propriedades de validação; consulte Propriedades de Validação. Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada.

    Para obter detalhes adicionais, consulte Validando Mensagens.

A mensagem de resposta é colocada (utilizando MQPUT) na fila chamada na mensagem de entrada MQMD como a fila ReplyTo. Não é possível alterar este destino.

Conectando os terminais de saída a outro nó

Conecte o terminal de Saída ou Falha deste nó a outro nó no fluxo de mensagens para processar a mensagem posteriormente, processar os erros ou enviar a mensagem para um destino adicional.

Se você usar agregação em seus fluxos de mensagens, você deve conectar esses terminais de saída.

Configurando para Transações Coordenadas

Quando você define um nó MQReply, a opção que seleciona para a propriedade Modo de Transação define se a mensagem é gravada no ponto de sincronização:
  • Se você selecionar Sim, a mensagem será gravada sob o ponto de sincronização (isto é, em uma WebSphere MQ unidade de trabalho).
  • Se você selecionar Automático (o padrão), a mensagem será gravada no ponto de sincronização se a mensagem de entrada que chega for marcada como persistente.
  • Se você selecionar Não, a mensagem não será gravada no ponto de sincronização.
Outra propriedade do nó MQReply, Modo de Persistência, define se a mensagem de saída será marcada como persistente quando for colocada na fila de saída:
  • Se você selecionar Sim (Yes), a mensagem será marcada como persistente.
  • Se você selecionar Automático (Automatic) (o padrão), a persistência de mensagem será determinada pelas propriedades da mensagem que chega, conforme definido no MQMD (o descritor de mensagens do WebSphere MQ).
  • Se você selecionar Não (No), a mensagem não será marcada como persistente.
  • Se você selecionar Conforme Definido para a Fila, a persistência de mensagem será configurada conforme definido na fila do WebSphere MQ; o nó MQReply especifica a opção MQPER_PERSISTENCE_AS_Q_DEF no MQMD.

Terminais e Propriedades

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

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem será roteada se for detectado um defeito quando a mensagem for colocada na fila de saída.
Saída O terminal de saída para o qual a mensagem é roteada se ela tiver sido colocada com êxito na fila de saída e se for necessário processamento adicional nesse fluxo de mensagens.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória; a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando você inclui o fluxo de mensagens no arquivo BAR para implementação).

As propriedades Descrição do nó MQReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do 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 Avançadas do nó MQReply são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Segmentação Permitida Sim Não Limpo Se você selecionar esta caixa de opção, WebSphere MQ quebrará a mensagem em segmentos no gerenciador de filas.
Modo de Persistência Sim Não Automático Essa propriedade controla se a mensagem é colocada de maneira persistente. Os valores válidos são Automático, Sim, Não, e Como Definido para Fila.
Modo de Transação Sim Não Automático Essa propriedade controla se a mensagem é colocada de maneira transacional. Os valores válidos são Automático, Sim, e Não.

As propriedades Validação do nó MQReply são descritas na tabela a seguir.

Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validate Não Sim Herdar Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar. validateMaster
Ação de Defeito Não Não Exception 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, Registro de Erros Local, Exceção e Lista de Exceções.  

O nó MQReply também possui as seguintes propriedades que não podem ser acessadas ou modificadas por meio da interface do WebSphere Message Broker Toolkit. No entanto, esses valores são utilizados pelo broker quando a mensagem é processada no fluxo de mensagens.

Propriedade Descrição
Nome do Gerenciador de Fila O nome do gerenciador de filas do WebSphere MQ para o qual a fila de saída, identificada em Nome da Fila, está definida. Esse nome é recuperado a partir do campo ReplyTo do cabeçalho MQMD da mensagem de entrada.
Nome da Fila O nome da fila do WebSphere MQ na qual a mensagem de saída é colocada. Esse nome é recuperado a partir do campo ReplyTo do cabeçalho MQMD da mensagem de entrada.
Destino Esta propriedade sempre possui o valor reply.
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:16


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