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 WebSphere Message Broker Toolkit pelo seguinte ícone:
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.
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 |
---|---|
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. |
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. |