MQReply

Utilize o nó MQReply para enviar uma resposta para o originador da mensagem de entrada.

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

Propósito

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.

Início da mudançaInformaçõ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.Fim da mudança

O nó MQReply está contido no repositório da paleta do WebSphere MQ e é representado no ambiente de trabalho pelo seguinte ícone:

 Ícone do nó MQReply

Utilizando este nó em um fluxo de mensagens

Examine a amostra a seguir para ver como utilizar esse nó: Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers 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.

Configurando o Nó MQReply

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:

  1. Opcional: na guia Descrição, digite uma descrição breve e/ou longa. Você também pode renomear o nó nessa guia.
  2. Na guia Avançado:
    1. Selecione Segmentação Permitida (Segmentation Allowed) para que o WebSphere MQ divida a mensagem em segmentos no gerenciador de filas, quando apropriado. Também é necessário definir MQMF_SEGMENTATION_ALLOWED no campo MsgFlags no MQMD para que a segmentação ocorra.

      Início da mudançaInformaçõ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.Fim da mudança

    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 transacionalidade da mensagem será derivada de como 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.
  3. Na guia Validação, configure as propriedades de validação se desejar que o analisador MRM valide o corpo de mensagens em relação ao dicionário gerado a partir do conjunto de mensagens. (Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada).

    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.

Conectando os terminais de saída a outro nó

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ê conectar um terminal de saída a outro nó no fluxo de mensagens, as informações sobre o destino no qual a mensagem foi colocada serão incluídas no LocalEnvironment associado à mensagem. Os valores a seguir são gravados em WrittenDestination na estrutura em árvore do LocalEnvironment:
  • Nome da Fila
  • Nome do gerenciador de filas
  • Identificador de resposta de mensagem (é definido com o mesmo valor do ID da mensagem)
  • ID da mensagem (do MQMD)
  • ID de correlação (do MQMD)

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.

Configurando para Transações Coordenadas

Quando você define um nó MQReply, a opção que seleciona para a propriedade Modo de Transação define se a mensagem é gravada no ponto de sincronização:
  • Se você selecionar Sim, a mensagem será gravada no ponto de sincronização (ou seja, dentro de uma unidade de trabalho do WebSphere MQ).
  • Se você selecionar Automático (o padrão), a mensagem será gravada no ponto de sincronização se a mensagem de entrada que chega for marcada como persistente.
  • Se você selecionar Não, a mensagem não será gravada no ponto de sincronização.
Outra propriedade do nó MQReply, Modo de Persistência, define se a mensagem de saída será marcada como persistente quando for colocada na fila de saída:
  • Se você selecionar Sim (Yes), a mensagem será marcada como persistente.
  • Se você selecionar Automático (Automatic) (o padrão), a persistência de mensagem será determinada pelas propriedades da mensagem que chega, conforme definido no MQMD (o descritor de mensagens do WebSphere MQ).
  • Se você selecionar Não (No), a mensagem não será marcada como persistente.
  • Se você selecionar Conforme Definido para a Fila, a persistência de mensagem será configurada conforme definido na fila do WebSphere MQ; o nó MQReply especifica 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
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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:40

ac04580_