Utilize o nó MQReply para enviar uma resposta para o originador da mensagem de entrada.
Este tópico contém as seguintes seções:
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 IBM® Integration Toolkit pelo seguinte ícone:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao IBM Integration 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 IBM Integration 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.
WrittenDestination = (
MQ = (
DestinationData = (
queueName = 'OUT'
queueManagerName = 'MYQUEUEMANAGER'
replyIdentifier = X'4d...2e'
msgId = X'3c...2c'
correlId = X'2a...00'
GroupId = X'3a...00'
)
)
)
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:
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.
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.
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.
Os terminais do nó MQReply são descritos na tabela a seguir.
| Terminal | Descrição |
|---|---|
| In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
| Falha | 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. |
| Out | 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 | A | Padrão | Descrição |
|---|---|---|---|---|
| Nome do Nó | Não | Não | O tipo de nó. | O nome do nó. |
| Descrição Curta | 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 | A | Padrão | Descrição |
|---|---|---|---|---|
| Segmentação Permitida | SIM | Não | Não selecionada | 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 | A | 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 | 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, 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 IBM Integration 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. |
| Queue Name | 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. |
| Propriedade | M | A | Padrão | Descrição |
|---|---|---|---|---|
| Eventos | Não | Não | Nenhuma | 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. |