MQeOutput

Utilize o nó MQeOutput para enviar mensagens aos clientes que se conectam ao intermediário utilizando o protocolo WebSphere MQ Mobile Transport.

Atenção: A utilização de fluxos de mensagens que contêm os nós MQeInput e MQeOutput na Versão 6.0 é obsoleta. O comportamento descrito aqui é direcionado somente para quando você estiver implementando da Versão 6.0 para uma versão anterior e para fornecer uma rota para migração. Projete novamente seus fluxos para remover os nós do MQe e substituí-los por nós do MQ que estão configurados para suas próprias especificações e coordenados com a configuração de gateway do MQe. Para obter detalhes adicionais, consulte Migrando um Fluxo de Mensagens que Contém Nós do WebSphere MQ Everyplace.

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

Propósito

O nó MQeOutput redireciona mensagens para gerenciadores de filas do WebSphere MQ Everyplace. Se você especificar um gerenciador de filas de destino não local, assegure-se de que haja uma rota para o gerenciador de filas ou serviços de fila de armazenamento e redirecionamento para o gerenciador de filas, se ele existir.

Você não pode utilizar o nó MQeOutput para alterar as características transacionais do fluxo de mensagens. As características transacionais definidas pelo nó de entrada do fluxo de mensagens determinam o comportamento transacional do fluxo.

z/OS platform Você não pode utilizar os nós MQeOutput nos fluxos de mensagens que você implementa nos sistemas z/OS.

Se você criar um fluxo de mensagens a utilizar como um subfluxo, não é possível utilizar um nó de saída padrão; você deve utilizar uma instância do nó Saída para criar um terminal de saída para o subfluxo através do qual propagar a mensagem.

Se você não quiser que o fluxo de mensagens envie mensagens para uma fila do WebSphere MQ Everyplace, escolha outro nó de saída suportado.

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

Ícone do nó MQeOutput

Utilizando este nó em um fluxo de mensagens

Para obter um exemplo de como este nó pode ser utilizado, considere um fazendeiro que verifica seus campos para saber se estão sendo bem irrigados. Ele leva um dispositivo PDA com o WebSphere MQ Everyplace instalado.Ele vê que seus campos não estão sendo irrigados e utiliza seu PDA e um link da Global Satellite Navigation para verificar a válvula do fluxo de água e descobre que ela está com defeito. Essas informações estão disponíveis porque o dispositivo SCADA remoto que é responsável pelo controle da válvula publicou uma mensagem de diagnóstico, que foi recuperada pelo intermediário e encaminhada para um nó MQeOutput e para um cliente WebSphere MQ Everyplace no seu PDA.

Documentação do WebSphere MQ Everyplace

Você pode localizar informações adicionais sobre o WebSphere MQ Everyplace, as propriedade do nó, na documentação do WebSphere MQ Everyplace no WebSphere MQ.

Conectando Terminais

Conecte o terminal In ao nó do qual as mensagens de saída ligadas são roteadas.

Conecte o terminal Out ou Failure desse nó a outro nó nesse fluxo de mensagens se você quiser processar a mensagem melhor, processar os erros ou enviar a mensagem para um destino adicional. Se você propagar a mensagem, o LocalEnvironment associado à mensagem será aprimorado com as seguintes informações para cada destino no qual a mensagem foi colocada por este nó:

  • 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 LocalEnvironment.

Se você não conectar nenhum desses terminais, a árvore Ambiente Local permanecerá inalterada.

Se você utilizar a agregação nos seus fluxos de mensagem, será necessário utilizar esses terminais.

Terminais e Propriedades

Quando tiver colocado uma instância do nó MQeOutput 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.

Os terminais do nó MQeOutput 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ó MQeOutput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não MQeOutput 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 Básicas do nó MQeOutput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do gerenciador de filas Não Sim   O nome do gerenciador de filas do WebSphere MQ Everyplace para o qual a fila de saída, especificada em Nome da Fila, está definida. Digite um valor para esta propriedade se você selecionar Nome da Fila em Modo de Destino (na guia Avançado). Se você selecionar outra opção para o Modo de Destino, você não precisará configurar esta propriedade.
Nome da Fila Não Sim   O nome da fila de saída do WebSphere MQ Everyplace no qual esse nó coloca as mensagens. Digite um valor para esta propriedade se você selecionar Nome da Fila em Modo de Destino (na guia Avançado). Se você selecionar outra opção para Modo de Destino, não será necessário configurar essas propriedades.

A propriedade Avançada do nó MQeOutput está descrita na tabela a seguir.

Propriedade M C Padrão Descrição
Modo de Destino Sim Não Lista de Destinos As filas para as quais a mensagem de saída é enviada:
  • Nome da Fila: a mensagem é enviada para a fila que é nomeada na propriedade Nome da Fila. As propriedades Nome do Gerenciador de Filas e Nome da Fila (na guia Básico) são obrigatórias se você selecionar essa opção.
  • Resposta à Fila: a mensagem é enviada à fila que é nomeada no campo ReplyToQ no MQMD.
  • Lista de Destino (o padrão): a mensagem é enviada à lista de filas que são nomeadas no LocalEnvironment (também conhecida como DestinationList) associada à mensagem.

As propriedades Pedido do nó MQeOutput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Pedido Sim Não Não Selecionada Selecione Pedido (Request) para indicar que cada mensagem de saída seja marcada no MQMD como uma mensagem de pedido (MQMD_REQUEST), e o campo do identificador de mensagem seja limpo (definido como MQMI_NONE) para assegurar que o WebSphere MQ gere um novo identificador. Limpe a caixa de opções para indicar que cada mensagem de saída não está marcada como uma mensagem de pedido. Você não poderá selecionar esta caixa de opções se tiver selecionado um Modo de Destino de Fila Responder para.
Gerenciador de Filas Responder para Não Sim   O nome do gerenciador de filas no qual a fila de saída, especificada na Fila Responder para (Reply-to queue), está definida. Esse nome é inserido no MQMD de cada mensagem de saída como o gerenciador de filas de resposta. Este novo valor substitui o valor atual no MQMD.
Fila Responder para Não Sim   O nome da 'fila responder para', na qual será colocada uma resposta a esse pedido. Esse nome é inserido no MQMD de cada mensagem de saída como a fila de resposta. Este novo valor substitui o valor atual no MQMD.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac04610_