Este tópico contém as seguintes seções:
Utilize o nó MQOutput para enviar mensagens a clientes que se conectam ao intermediário utilizando o WebSphere MQ Enterprise Transport e que façam uso das interfaces de programação de aplicativos MQI e AMI.
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 de destino que você especifica.
Se apropriado, você pode definir a fila como uma fila em cluster ou fila compartilhada do WebSphere MQ.Ao utilizar uma fila em cluster do WebSphere MQ, deixe o nome do gerenciador de filas em branco.
Você pode configurar o nó MQOutput para colocar uma mensagem em uma fila específica do WebSphere MQ, definida em qualquer gerenciador de filas acessível pelo gerenciador de filas do intermediário.
Você pode definir outras propriedades para controlar a forma em que 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 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 WebSphere MQ, poderá escolher outro nó de saída suportado.
O nó MQOutput é representado no workbench pelo seguinte ícone:
Para obter um exemplo de como utilizar esse nó, suponha que você tenha gravado um aplicativo de publicação que publica atualizações de ações regularmente. O aplicativo envia as mensagens ao intermediário em um nó MQInput e o fluxo de mensagens disponibiliza as publicações para vários assinantes por meio de um nó Publication. Você inclui um nó MQOutput para enviar a mensagem a um aplicativo que registra cada alteração de preço ocorrida.
Quando tiver colocado uma instância do nó MQOutput em um fluxo de mensagens, poderá configurá-lo. Clique com o botão direito na exibiçã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ó MQOutput da seguinte forma:
Limpe a caixa de opções, se você não deseja gerar um novo ID. Observe que um novo ID de mensagem ainda é gerado se você selecionar a caixa de opções Pedido no painel Pedido do diálogo de propriedades.
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
Informações adicionais sobre as opções para as quais estas propriedades são mapeadas estão disponíveis no WebSphere MQ Application Programming Reference.
Observe que um novo identificador de mensagens é gerado mesmo se a caixa de opções Novo ID de Mensagem não estiver selecionada no painel Avançado do navegador do diálogo de propriedades.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
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 envie a mensagem para um destino adicional.
Ao definir um nó MQOutput, a opção que você selecionar para a propriedade Modo de Transação define se a mensagem está gravada no ponto de sincronização:
Outra propriedade do nó MQOutput, o Modo de Persistência, define se a mensagem de saída está marcada como persistente quando é colocada na fila de saída:
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ó. |
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ó 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 no Nome de Fila, está definida. | |
Nome da Fila | Não | Sim | O nome da fila de saída do WebSphere MQ para o qual esse nó coloca as 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 , Fila Responder para e Nome da 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. |
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. |
Novo ID da Mensagem | Sim | Não | Limpo | Define se o WebSphere MQ gera um novo identificador de mensagem para substituir o conteúdo do campo MsgId no MQMD. Se você selecionar a caixa de opções, esta ação é executada. |
Novo ID de Correlação | Sim | Não | Limpo | Define se o WebSphere MQ gera um novo identificador de correlação para substituir o conteúdo do campo CorrelId no MQMD. Se você selecionar a caixa de opções, esta ação é executada. |
Segmentação Permitida | Sim | Não | Limpo | 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. |
Contexto da Mensagem | Sim | Não | Transmitir Tudo | Como manipular o contexto de origem. 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 | Limpo | Define se a autoridade alternativa é utilizada quando a mensagem de saída é colocada. Se você selecionar a caixa de opções, esta ação é executada. |
As propriedades de Pedido do nó MQOutput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Pedido | Sim | Não | Limpo | Define se é necessário gerar cada mensagem de saída como uma mensagem de pedido. Se você selecionar a caixa de opções, esta ação é executada. |
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, está definido. | |
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 de Descrição do nó MQOutput 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. |