Nó MQeOutput

Atenção: A utilização dos fluxos de mensagens que contêm os nós MQeInput e MQeOutput no WebSphere Message Broker Versão 6.0 está 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 MQe e substituí-los por nós MQ configurados para suas próprias especificações e coordenados com sua configuração de Gateway 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:

Finalidade

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

O nó MQeOutput encaminha mensagens para os gerenciadores de filas do WebSphere MQ Everyplace. Se você especificar um gerenciador de filas de destino não-local, assegure-se de que exista uma rota para o gerenciador de filas ou um serviço de filas armazenar-e-redirecionar para o gerenciador de filas, se 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ó input do fluxo de mensagens determinam o comportamento transacional do fluxo.

Você não pode utilizar nós MQeOutput em fluxos de mensagens implementados em sistemas z/OS.

Se você criar um fluxo de mensagens a ser utilizado como um subfluxo, não poderá utilizar o nó output padrão, será necessário utilizar uma instância do nó Output para criar um terminal de saída para o subfluxo através do qual propagar a mensagem.

Se não desejar que seu fluxo de mensagens envie mensagens para uma fila do WebSphere MQ Everyplace, poderá escolher outro nó output suportado.

O nó MQeOutput é representado no workbench 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 observa que uma área em seus campos não está sendo irrigada então utiliza seu PDA e um link da Global Satellite Navigation para verificar a válvula do fluxo de água e descobre que está com defeito. Essas informações estão disponíveis porque o dispositivo SCADA remoto responsável por controlar a válvula publicou uma mensagem de diagnóstico, que foi recuperada pelo intermediário e redirecionada a um nó MQeOutput e ao cliente do WebSphere MQ Everyplace em 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 Página da Web do WebSphere MQ.

Configurando o Nó MQeOutput

Quando tiver colocado uma instância do nó MQeOutput 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ó MQeOutput da seguinte forma:

  1. Digite o Nome do Gerenciador de Filas e o Nome da Fila que especificam o destino da mensagem de saída, se você selecionar o Nome da Fila no Modo de Destino (descrito abaixo). Se você selecionar outra opção para Modo de Destino, não será necessário definir essas propriedades.
  2. Selecione Avançado no navegador do diálogo de propriedades e selecione o Modo de Destino da lista drop down. Isso identifica as filas nas quais entregar a mensagem de saída.
    • Nome da Fila.A mensagem é enviada para a fila denominada 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.Este é o padrão.
    • Fila Responder para.A mensagem é enviada para a fila denominada no campo ReplyToQ no MQMD.
    • Lista de Destino. A mensagem é enviada para a lista de filas denominada no Ambiente Local (também conhecida como Lista de Destino) associada à mensagem.
  3. Selecione Pedido no navegador do diálogo de propriedades e defina as propriedades para definir as características de cada mensagem de saída gerada.
    1. Selecione a caixa de opções Pedido 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.
    2. Insira um nome de gerenciador de filas do WebSphere MQ Everyplace em Gerenciador de Filas Responder para.Ele é inserido no MQMD de cada mensagem de saída como o gerenciador de filas Responder para. Este novo valor substitui o valor atual no MQMD.
    3. Insira um nome de fila do WebSphere MQ Everyplace em Fila Responder para.Ele é inserido no MQMD de cada mensagem de saída como a fila Responder para. Este novo valor substitui o valor atual no MQMD.
  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 alterações no nó MQeOutput 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.

Conectando Terminais

Conecte o terminal in ao nó a partir do qual as mensagens de transmissão ligadas são roteadas.

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 fizer isso, o Ambiente Local associado à mensagem será aperfeiçoado 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 Ambiente Local.

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

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

Propriedade M C Padrão Descrição
Nome do Gerenciador de Fila Não Sim   O nome do gerenciador de filas do WebSphere MQ Everyplace para o qual a fila de saída, especificada no Nome de Fila, está definida.
Nome da Fila Não Sim   O nome da fila de saída do WebSphere MQ Everyplace no qual esse nó coloca as mensagens.

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

Propriedade M C Padrão Descrição
Modo de Destino Sim Não Lista de Destinos As filas nas quais a mensagem de saída é enviada. Os valores válidos são Nome da Fila, Fila Responder Para e Lista de Destino.

As propriedades de 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 Indica se cada mensagem de saída deve ser gerada como uma mensagem de pedido. Se você selecionar a caixa de opções, a ação será executada.
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, está definida.
Fila Responder para Não Sim   O nome da 'fila responder para', na qual será colocada uma resposta a esse pedido.

As propriedades de Descrição do nó MQeOutput 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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04610_