Nó MQReply

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

Finalidade

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.

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:

 Ícone do nó MQReply

Utilizando este nó em um fluxo de mensagens

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 .

Configurando o Nó MQReply

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 na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades mandató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:

  1. Selecione a caixa de opções Segmentação Permitida se desejar que o WebSphere MQ divida a mensagem em segmentos no gerenciador de filas, se apropriado.Também é necessário definir MQMF_SEGMENTATION_ALLOWED no campo MsgFlags no MQMD para que a segmentação ocorra.

    Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.

  2. Selecione o Modo de Persistência desejado 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. Selecione o Modo de Transação desejado para a mensagem de saída.
    • Se você selecionar Automático (o padrão), a capacidade de transação da mensagem será derivada da forma que 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.
  4. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  5. Clique em Aplicar para fazer as alterações no nó MQReply sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    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. Para obter mais opções sobre o destino da mensagem de saída, utilize o nó de saída alternativo:

  • MQOutput
  • MQeOutput
  • SCADAOutput

Conectando os terminais de saída a outro nó

Conecte o terminal out ou failure deste nó a outro nó desse fluxo de mensagens se deseja que envie a mensagem para um destino adicional.

Configurando para Transações Coordenadas

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:

  • Se Sim, a mensagem está gravada sob o ponto de sincronização (ou seja dentro de uma unidade de trabalho WebSphere MQ).
  • Se Automático (o padrão), a mensagem será gravada sob o ponto de sincronização se a mensagem de entrada for marcada como persistente.
  • Se Não, a mensagem não será gravada sob o 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:

  • Se Sim, a mensagem será marcada como persistente.
  • Se Automático (o padrão), a persistência de mensagem será determinada pelas propriedades da mensagem de entrada, conforme definido no MQMD (o descritor de mensagens do WebSphere MQ).
  • Se Não, a mensagem não será marcada como persistente.
  • Se Conforme Definido para a Fila, a persistência de mensagem será definida como na fila do WebSphere MQ pelo nó MQReply, especificando 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 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 é mandató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 propriedades é 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 Limpo 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 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.

Conceitos relacionados
Fluxos de Mensagem
Implementação de Aplicativo de Fluxo de Mensagens

Tarefas relacionadas
Decidindo Quais Nós Utilizar
Tratando Erros em Fluxos de Mensagens
Utilizando as Filas de Clusters WebSphere MQ para Entrada e Saída
Utilizando as Filas Compartilhadas do WebSphere MQ para Entrada e Saída (z/OS)

Referências relacionadas
Nó MQeOutput
Nó MQInput
Nó MQOutput
Nó SCADAOutput

Página da Web da Biblioteca do WebSphere MQ