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, 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:

 Ícone do nó MQReply

Utilizando este nó em um fluxo de mensagens

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.

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 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:

  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 Validação no navegador do diálogo de propriedades se desejar que o analisador MRM valide o corpo de mensagens no 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 mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.

  5. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  6. 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.

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 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:

  • 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)

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.

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 é 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.
Referências relacionadas
Nó MQInput
Nó MQOutput
Nó SCADAOutput
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04580_