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 ou filas 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árioou nos destinos identificados no Ambiente Local (também conhecido como Lista de Destino) associado à mensagem.
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ó 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, poderá escolher outro nó output suportado.
O nó MQOutput é representado no workbench pelo seguinte ícone:
Veja as amostras a seguir para consultar sobre como utilizar este nó:
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. Configure um nó Compute para criar uma nova mensagem de saída sempre que uma determinada ação for alterada e transmita isto para um nó MQOutput para registrar cada alteração de preço referente a essa ação.
Quando tiver colocado uma instância do nó MQOutput em um fluxo de mensagens, poderá configurá-lo. Clique com o botão direito do mouse 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.
Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
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 processe mais a mensagem, processe os erros ou envie a mensagem para um destino adicional.
Se você conectar um desses terminais de saída a outro nó no fluxo de mensagens, o Ambiente Local associado à mensagem será melhorado com as seguintes informações para cada destino em que a mensagem foi colocada por esse nó:
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, deve utilizar os terminais out.
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 Lista de Destino, 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 | Não selecionada | 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 | Não selecionada | 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 | Não selecionada | 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 | Não selecionada | 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 | Não selecionada | 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 Validação do nó MQOutput são descritas na tabela a seguir.
Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa destas propriedades.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validate | Sim | Sim | Herdar | Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar. |
Ação de Defeito | Sim | Não | Exceção | O que acontece 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ção. |
Incluir Todas as Limitações do Valor | Sim | Não | Selecionado | Essa propriedade não pode ser editada. A ação padrão, indicada pela seleção da caixa de opções, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor. |
Fix | Sim | Não | Nenhum | Essa propriedade não pode ser editada. |
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. |