Nó MQeOutput

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 .

O nó MQeOutput encaminha mensagens para os gerenciadores de filas do . 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ó de entrada 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ó de saída 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 , poderá escolher outro nó de saída suportado:

  • MQReply
  • MQOutput
  • SCADAOutput
  • Publication
  • Um nó de saída definido pelo usuário

O nó MQeOutput é representado no 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 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 em seu PDA.

Documentação do

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

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 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ó 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 mandató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 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 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 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 é 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 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 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 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 Limpo 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.

Conceitos relacionados

Fluxos de Mensagem
Extensões Definidas pelo Usuário
Árvore Ambiente Local
Implementação de Aplicativo de Fluxo de Mensagens

Tarefas relacionadas
Trabalhando com Cenários de Exemplo do
Decidindo Quais Nós Utilizar
Utilizando as Filas de Clusters para Entrada e Saída
Utilizando as Filas Compartilhadas do para Entrada e Saída (z/OS)
Configurando Fluxos de Mensagens Coordenados
Tratando Erros em Fluxos de Mensagens
Criando Listas de Destino
Configurando Fluxos de Agregação
Editando Propriedades Configuráveis

Referências relacionadas

Nó MQeInput
Nó MQOutput
Nó MQReply
Nó SCADAOutput
Nó Output