Nó MQOutput

Este tópico contém as seguintes seções:

Finalidade

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:

 Ícone do nó MQOutput

Utilizando este nó em um fluxo de mensagens

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.

Configurando o Nó MQOutput

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:

  1. Se você deseja enviar a mensagem de saída para uma única fila de destino que é definida por esse nó, digite o nome da fila para o qual o fluxo de mensagens envia as mensagens no Nome da Fila. Digite o nome do gerenciador de filas para o qual essa fila é definida no Nome do Gerenciador da Fila. Você deverá definir essas propriedades se definiu a propriedade Modo de Destino Avançado (descrito a seguir) para Nome da Fila.Se você definir o Modo de Destino para outro valor, essas propriedades são ignoradas.
  2. Selecione Avançado no navegador do diálogo de propriedades. Essas propriedades definem o controle transacional para a mensagem e a maneira como a mensagem é colocada na fila. Várias dessas propriedades são mapeadas para opções na chamada MQPUT.
    • Selecione o Modo de Destino da lista drop down.Isso identifica as filas nas quais a mensagem de saída é colocada.
      • 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.
    • Selecione Modo de Transação da lista drop down para determinar como a mensagem é colocada.
      • Se você selecionar Automático (padrão), a capacidade de transação da mensagem será derivada da forma que ela foi especificada no nó input.
      • Se você selecionar Sim, a mensagem será colocada de forma transacional.
      • Se selecionar Não, a mensagem será colocada de forma não transacional.
      Consulte a seção Configurando para Transações Coordenadas para obter mais informações.
    • Selecione Modo de Persistência da lista drop-down para determinar se a mensagem foi colocada de forma persistente.
      • Se você selecionar Automático (o padrão), a persistência será conforme especificada na mensagem de entrada.
      • Se selecionar Sim, a mensagem será colocada de forma persistente.
      • Se selecionar Não, a mensagem será colocada de forma não persistente.
      • Se selecionar Conforme Definido para a Fila, a persistência da mensagem será conforme definida para a fila do WebSphere MQ.
    • Selecione a caixa de opções Novo ID de Mensagem para gerar um novo ID de mensagem para essa mensagem. Isso é mapeado para a opção MQPMO_NEW_MSG_ID do MQPMO do MQI.

      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.

    • Selecione a caixa de opções Novo ID de Correlação para gerar um novo ID de correlação para essa mensagem. Isso é mapeado para a opção MQPMO_NEW_CORREL_ID do MQPMO do MQI. Limpe a caixa de opções, se você não deseja gerar um novo ID.

      Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.

    • Selecione a caixa de opções Segmentação Permitida se desejar que o WebSphere MQ segmente a mensagem no gerenciador de filas, quando apropriado.Também é necessário definir MQMF_SEGMENTATION_ALLOWED no campo MsgFlags no MQMD para que a segmentação ocorra.Limpe a caixa de opções, se você não deseja a segmentação.

      Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.

    • Selecione Contexto da Mensagem para indicar como o contexto de origem deve ser tratado.Escolha uma das seguintes opções:
      • Transmitir Tudo (é mapeado para a opção MQPMO_PASS_ALL_CONTEXT do MQPMO do MQI.)
      • Transmitir Identidade (é mapeado para a opção MQPMO_PASS_IDENTITY_CONTEXT do MQPMO do MQI.)
      • Definir Tudo (é mapeado para a opção MQPMO_SET_ALL_CONTEXT do MQPMO do MQI.)
      • Definir Identidade (é mapeado para a opção MQPMO_SET_IDENTITY_CONTEXT do MQPMO do MQI.)
      • Padrão (é mapeado para a opção MQPMO_DEFAULT_CONTEXT do MQPMO do MQI.)
      • Nenhum (é mapeado para a opção MQPMO_NO_CONTEXT do MQPMO do MQI.)

      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.

    • Selecione a caixa de opções Autoridade do Usuário Alternativa se desejar que a opção MQOO_ALTERNATE_USER_AUTHORITY seja definida nas opções abertas (MQOO) do MQI.Se você selecionar essa caixa, esta opção será especificada quando a fila for aberta para saída. As informações alternativas do usuário são recuperadas das informações do contexto na mensagem. Limpe a caixa de opções se não desejar especificar autoridade do usuário alternativa. Se você limpar a caixa, o ID do usuário do serviço do intermediário será utilizado quando a mensagem for colocada.
  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.
    • Selecione a caixa de opções Pedido para marcar cada mensagem de saída no MQMD como uma mensagem de pedido (MQMT_REQUEST) e limpar o campo do identificador de mensagens (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.

      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.

    • Digite um nome de gerenciador de filas em Gerenciador de Filas Responder para. Ele é inserido no MQMD de cada mensagem de saída como o gerenciador de filas Responder para.
    • Digite um nome de fila em Fila Responder para. Ele é inserido no MQMD de cada mensagem de saída como a fila responder para.
  4. Selecione Validação no navegador do diálogo de propriedades se desejar que o analisador MRM valide o corpo de mensagens no dicionário gerado a partir do conjunto de mensagens. (Se uma mensagem for propagada para o terminal failure do nó, ela não será validada).

    Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.

  5. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  6. Clique em Aplicar para fazer as alterações no nó MQOutput 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 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ó:

  • 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 fluxos de mensagens, deve utilizar os terminais out.

Configurando para Transações Coordenadas

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:

  • Se Sim, a mensagem está gravada sob o ponto de sincronização (ou seja dentro de uma unidade de trabalho WebSphere MQ).
  • Se Automático (o padrão), a mensagem será gravada sob o ponto de sincronização se a mensagem de entrada for marcada como persistente.
  • Se Não, a mensagem não será gravada sob o 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:

  • Se Sim, a mensagem será marcada como persistente.
  • Se Automático (o padrão), a persistência da mensagem será determinada a partir das propriedades da mensagem de entrada, conforme definido no MQMD (o descritor de mensagens WebSphere MQ).
  • Se Não, a mensagem não será marcada como persistente.
  • Se Conforme Definido para a Fila, a persistência de mensagem será definida como na fila do WebSphere MQ pelo nó MQOutput, especificando a opção MQPER_PERSISTENCE_AS_Q_DEF no MQMD.

Terminais e Propriedades

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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04570_