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, defina a fila como uma fila em cluster ou compartilhada do WebSphere MQ.
O nó MQReply utiliza as opções que são enviadas no campo Relatório no MQMD. Por padrão (se nenhuma opção estiver configurada), o nó MQReply gera um novo MsgId e CorrelId na mensagem de resposta. Se o aplicativo de recebimento esperar outros valores nestes campos, certifique-se de que o aplicativo que coloca a mensagem na fila de entrada do fluxo de mensagens configure as opções do relatório necessárias ou que você configure as opções apropriadas 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.
Informações adicionais sobre o campo Relatório estão disponíveis na seção Application Programming
Reference do WebSphere MQ Versão 6: centro de informações on-line, ou no manual da Versão 5.3
na WebSphere MQ.
O nó MQReply está contido no repositório da paleta do WebSphere MQ e é representado no ambiente de trabalho pelo seguinte ícone:
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.
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. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em Propriedades.
Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.
Configure o nó MQReply da seguinte forma:
Informações
adicionais sobre as opções para as quais esta propriedade mapeia estão disponíveis
na seção Referência de Programação do Aplicativo do WebSphere MQ Versão 6: centro de informações on-line,
ou no manual da Versão 5.3 no WebSphere MQ.
Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.
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 Out ou Failure desse nó a outro nó nesse fluxo de mensagens para processar a mensagem melhor, processar os erros ou enviar a mensagem para um destino adicional.
Se você não conectar um desses terminais de saída, a árvore LocalEnvironment ficará inalterada.
Se você utilizar a agregação nos fluxos de mensagens, será necessário utilizar 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ó. |
Failure | 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 será roteada se for colocada com êxito na fila de saída e se for requerido 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 (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).
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 | 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 | C | Padrão | Descrição |
---|---|---|---|---|
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. |
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. |
Incluir Todas as Limitações do Valor | Sim | Não | Selecionado | Não é possível editar essa propriedade. Se essa caixa de opções for selecionada, verificações básicas de limitação de valor serão incluídas na validação Conteúdo e Valor (Content and Value). |
Correção | Sim | Não | Nenhum | Não é possível editar essa propriedade. |
O nó MQReply também possui as seguintes propriedades que não podem ser acessadas ou modificadas por meio da interface do ambiente de trabalho. No entanto, esses valores são utilizados pelo intermediário 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. Este nome é recuperado do campo ReplyTo do MQMD da mensagem de entrada. |
Nome da Fila | O nome da fila do WebSphere MQ na qual a mensagem de saída é colocada.Este nome é recuperado do campo ReplyTo do MQMD da mensagem de entrada. |
Destino | Esta propriedade sempre possui o valor reply. |