Este tópico contém as seguintes seções:
Utilize o nó MQReply para enviar uma resposta para o originador da mensagem de entrada. MQReply é um formato especializado do nó MQOutput que coloca a mensagem de saída na fila do WebSphere MQ identificada pelo campo ReplyToQ do cabeçalho da mensagem de entrada.Se apropriado, você pode definir a fila como uma fila em cluster ou fila compartilhada do WebSphere MQ.
O nó MQReply aceita as opções definidas no campo Relatório no MQMD. Por padrão (se nenhuma opção for definida), o nó MQReply gerará um novo MsgID e CorrelID na mensagem de resposta. Se o aplicativo de recepção esperar outros valores nesses campos, será necessário assegurar-se de que o aplicativo que coloca a mensagem na fila de entrada do fluxo de mensagens definirá as opções de relatório necessárias, ou que você definiu as opções adequadas dentro do MQMD durante o processamento da mensagem no fluxo de mensagens. Por exemplo, utilize o nó Compute para definir as opções do Relatório na mensagem.
Você pode localizar informações adicionais sobre o campo Relatório no WebSphere MQApplication Programming Reference.
O nó MQReply é representado no workbench pelo seguinte ícone:
Veja a amostra a seguir para consultar como utilizar este nó:
Você pode achar apropriado utilizar este nó ao 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, será possível configurá-lo. Clique com o botão direito do mouse na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.
Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.
Configure o nó MQReply da seguinte forma:
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
A mensagem de resposta é colocada (utilizando MQPUT) na fila denominada no MQMD da mensagem de entrada como a fila ReplyTo. Não é possível alterar este destino.
Conecte o terminal out ou failure deste nó a outro nó desse fluxo de mensagens se deseja que processe mais a mensagem, processe os erros ou envie a mensagem para um destino adicional.
Se você conectar um desses terminais de saída a outro nó no fluxo de mensagens, o Ambiente Local associado à mensagem será melhorado com as seguintes informações para cada destino em que a mensagem foi colocada:
Esses valores são gravados em WrittenDestination na estrutura de árvore Ambiente Local.
Se você não conectar um desses terminais out, a árvore Ambiente Local será inalterada.
Se você utilizar a agregação nos seus fluxos de mensagem, será necessário utilizar esses terminais out.
Ao definir um nó MQReply, a opção que você selecionar para a propriedade Modo de Transação define se a mensagem está gravada no ponto de sincronização:
Outra propriedade do nó MQReply, Modo de Persistência, define se a mensagem de saída está marcada como persistente quando é colocada na fila 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 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 (marcado com um asterisco no diálogo de propriedades 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 no arquivo bar para implementá-lo).
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 apropriado, o WebSphere MQ divide a mensagem em segmentos no gerenciador de filas. Se você selecionar a caixa de opções, esta ação é executada. |
Modo de Persistência | Sim | Não | Automático | Define se a mensagem é colocada persistentemente. 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 | Define se a mensagem é transacional. Os valores válidos são Automático, Sim e Não. |
As propriedades de Validação do nó MQReply são descritas na tabela a seguir.
Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa destas propriedades.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validate | Sim | Sim | Herdar | Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar. |
Ação de Defeito | Sim | Não | Exceção | O que acontece 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ção. |
Incluir Todas as Limitações do Valor | Sim | Não | Selecionado | Essa propriedade não pode ser editada. A ação padrão, indicada pela seleção da caixa de opções, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor. |
Fix | Sim | Não | Nenhum | Essa propriedade não pode ser editada. |
As propriedades de Descrição do nó MQReply são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
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. |
O nó MQReply também possui as seguintes propriedades que você não pode acessar ou modificar através da interface do workbench. 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. |