Utilize o nó MQOutput para enviar mensagens para clientes que se conectam ao intermediário utilizando o WebSphere MQ Enterprise Transport e que utilizam as interfaces de programação de aplicativos MQI e AMI.
Este tópico contém as seguintes seções:
O nó MQOutput entrega uma mensagem de saída de um fluxo de mensagens para uma fila do WebSphere MQ. O nó utiliza MQPUT para colocar a mensagem na fila ou filas de destino especificadas.
Se apropriado, defina a fila como uma fila em cluster ou compartilhada do WebSphere MQ. Ao utilizar um fila em cluster do WebSphere MQ, deixe o Nome do Gerenciador de Filas vazio.
Você pode configurar o nó MQOutput para colocar uma mensagem em uma fila do WebSphere MQ específica que esteja definida em qualquer gerenciador de filas que seja acessível pelo gerenciador de filas do intermediário ou para os destinos identificados no LocalEnvironment (também conhecido como DestinationList) que esteja associado à mensagem.
Defina outras propriedades para controlar a maneira na qual as mensagens são enviadas, fazendo com que as opções MQPUT apropriadas sejam definidas; por exemplo, você pode solicitar que uma mensagem seja processada sob controle de transação. Você também pode especificar que o WebSphere MQ pode, se apropriado, dividir a mensagem em segmentos no gerenciador de filas.
Se você criar um fluxo de mensagens para ser utilizado como um subfluxo, não poderá utilizara um nó de saída padrão; utilize uma instância do nó Saída para criar um terminal Out para o subfluxo pelo qual a mensagem será propagada.
Se você não quiser que o fluxo de mensagens envie mensagens para uma fila do WebSphere MQ, escolha outro nó de saída suportado.
O nó MQOutput está contido no repositório da paleta do WebSphere MQ e é representado no ambiente de trabalho pelo seguinte ícone:
Veja as amostras a seguir para consultar sobre como utilizar este nó:
Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers Toolkit.
Para obter um exemplo de como utilizar este nó, suponha que você tenha gravado um aplicativo de publicação que publica atualizações de estoque regularmente. O aplicativo envia as mensagens para o intermediário em um nó MQInput e o fluxo de mensagens disponibiliza as publicações para vários assinantes por meio de um nó Publicação. Você configura um nó Compute para criar uma nova mensagem de saída sempre que uma ação específica é alterada e conecta este nó a um nó MQOutput para registrar cada alteração de preço para esta ação.
Quando tiver colocado uma instância do nó MQOutput 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ó, dê um clique duplo no nó ou clique com o botão direito do mouse 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ó MQOutput.
Ao selecionar essa opção, o nó MQOutput constrói uma mensagem de resposta WebSphere MQ. Consulte Conteúdo da mensagem de resposta WebSphere MQ para obter informações adicionais sobre as configurações utilizadas pelo nó MQOutput e pela pasta Root.MQMD nesta situação.
Limpe a caixa de opções, se você não deseja gerar um novo ID. Um novo ID de mensagem ainda será gerado se você selecionar Pedido na guia Pedido.
Informaçõ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.
Informaçõ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.
Informaçõ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.
Informaçõ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.
Será gerado um novo identificador de mensagem mesmo que a caixa de opção Novo ID de Mensagem não estiver selecionada na guia Avançado.
Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.
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 para processar a mensagem melhor, processar os erros ou enviar a mensagem para um destino adicional.
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 fluxos de mensagens, deverá utilizar os terminais output.
MQMD.Report = 0; MQMD.PutApplType = MQAT_BROKER; MQMD.PutDate = Obtido da registro de data e hora atual MQMD.PutTime = Obtido da registro de data e hora atual MQMD.PutApplName = MsgTree.MQMD.ReplyToQMgr (primeiros 28 caracteres)
MQMD.Version MQMD.Format MQMD.Priority MQMD.Persistence MQMD.Expiry MQMD.Encoding MQMD.CodedCharSetId MQMD.GroupId MQMD.MsgSeqNumber MQMD.Offset MQMD.MsgFlags MQMD.OriginalLength
IF MsgTree.MQMD.MsgType = MQMT_REQUEST THEN MQMD.MsgType = MQMT_REPLY; IF Nodes Message Context is Default, PassAll or PassIdentity THEN MQMD.UserIdentifer = MsgTree.MQMD.UserIdentifier; IF MsgTree.MQMD.Report contains MQRO_PASS_CORREL_ID THEN MQMD.CorrelId = MsgTree.MQMD.CorrelId; ELSE MQMD.CorrelId = MsgTree.MQMD.MsgId; IF MsgTree.MQMD.Report contains MQRO_PASS_MSG_ID THEN MQMD.MsgId = MsgTree.MQMD.MsgId; ELSE MQMD.MsgId = MQMI_NONE;
Quando a estrutura do MQMD de saída tiver sido construída, o Contexto da Mensagem no nó MQOutput será ignorado, e o comportamento será como configurar Tudo.
Os valores que são substituídos, são executados apenas na estrutura do MQMD de saída; não são feitas atualizações na pasta do MQMD na árvore de mensagens.
Os terminais do nó MQOutput são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | 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ó MQOutput 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ó, MQOutput | 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ó MQOutput 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 para o qual a fila de saída, especificada em Nome da Fila (Queue Name), está definida. | |
Nome da Fila | Não | Sim | O nome da fila de saída WebSphere MQ onde este nó coloca mensagens (utilizando MQPUT). |
As propriedades Avançadas do nó MQOutput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Modo de Destino | Sim | Não | Nome da Fila | As filas nas quais a mensagem de saída é enviada. Os valores válidos são Lista de Destino, Fila Responder para e Nome da 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. |
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. |
Novo ID da Mensagem | Sim | Não | Não Selecionada | Se você selecionar essa caixa de opções, o WebSphere MQ gerará um novo identificador de mensagem para substituir o conteúdo do campo MsgId no MQMD. |
Novo ID de Correlação | Sim | Não | Não Selecionada | Se você selecionar essa caixa de opções, o WebSphere MQ gerará um novo identificador de correlação para substituir o conteúdo do campo CorrelId no MQMD. |
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. |
Contexto da Mensagem | Sim | Não | Transmitir Tudo | Essa propriedade controla como o contexto de origem é tratado. Os valores válidos são Transmitir Tudo, Transmitir Identidade, Definir Tudo, Definir Identidade e Padrão. |
Autoridade de Usuário Alternativa | Sim | Não | Não Selecionada | Se você selecionar essa caixa de opções, a autoridade alternativa será utilizada quando a mensagem de saída for colocada. |
As propriedades Pedido do nó MQOutput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Pedido | Sim | Não | Não Selecionada | Se você selecionar a caixa de opções, cada mensagem de saída será gerada como uma mensagem de pedido. |
Gerenciador de Filas Responder para | Não | Sim | O nome do gerenciador de filas do WebSphere MQ para o qual a fila de saída, especificada em Fila Responder para (Reply-to Queue), está definida. | |
Responder para a Fila | Não | Sim | O nome da fila do WebSphere MQ na qual será colocada uma resposta para este pedido. |
As propriedades Validação do nó MQOutput 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 | Exceção | 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 a 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 | Nenhuma | Não é possível editar essa propriedade. |