WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

JMSOutput

Utilize o nó JMSOutput para enviar mensagens para destinos JMS.

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

Finalidade

O nó JMSOutput age como um produtor de mensagens JMS e pode publicar todos os seis tipos de mensagens que são definidos na Java™ Message Service Specification, versão 1.1. As mensagens são publicadas utilizando chamadas de método, que são descritas na especificação JMS.

O nó JMSOutput está contido no repositório JMS da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó JMSOutput

Utilizando o Nó JMSOutput em um Fluxo de Mensagens

A amostra a seguir contém um fluxo de mensagens no qual o nó JMSOutput é utilizado. Observe essa amostra para obter um exemplo de como utilizar o nó JMSOutput.

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Os fluxos de mensagens que manipulam mensagens recebidas de conexões com provedores JMS devem sempre ser iniciados com um nó JMSInput. Se você incluir o nó JMSOutput em um fluxo de mensagens, não precisará incluir um nó JMSInput; mas se não incluir um nó JMSInput, será necessário incluir o nó MQJMSTransform para transformar a mensagem no formato esperado pelo nó JMSOutput.

Se estiver propagando mensagens JMS e criando um fluxo de mensagens para utilizar como um subfluxo, utilize uma instância do nó JMSOutput como o último nó para criar um terminal de saída para o subfluxo.

Controlando o Tipo da Mensagem de Saída JMS

Na árvore de mensagens JMS, o tipo de mensagem JMS é representado pelo campo PayloadType da subpasta Message_MetaData. Para controlar o tipo de mensagem JMS criado pelo nó JMSOutput, utilize o código ESQL para definir o valor de Carga Útil, conforme mostra o exemplo a seguir:
SET OutputRoot.JMSTransport.Transport_Folders.Message_MetaData.PayloadType=Valor de Carga Útil

Para obter mais informações sobre a árvore de mensagens JMS e os valores de carga útil, consulte Representação de Mensagens no Transporte JMS.

Enviando uma Mensagem JMS para uma Lista de Destino

Para enviar uma mensagem JMS a uma lista de destino, assegure que as condições a seguir sejam atendidas.
  • Selecione Enviar para lista de destino no ambiente local na guia de propriedades Básico do nó JMSOutput.
  • Configure a lista no ambiente local, conforme mostrado no exemplo a seguir.
    CREATE PROCEDURE CreateJMSDestinationList() BEGIN
      SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[1]  = 'jndi://TestDestQueue1';
      SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[2]  = 'jndi://TestDestQueue2';
      SET OutputLocalEnvironment.Destination.JMSDestinationList.DestinationData[3]  = 'jndi://TestDestQueue3';
    END;
  • Certifique-se de que o modelo de mensagem (ponto a ponto ou Publicação/Assinatura) corresponda ao modelo utilizado pelo nó JMSOutput. Neste caso, o modelo é ponto a ponto.
  • Se o nome do destino na lista for prefixado com a cadeia “jndi://”, ele indicará ao nó JMSOutput que o valor representa o nome de um objeto administrado JNDI, que precisa ser consultado. Como alternativa, se o formato específico do provedor JMS para um destino for conhecido, ele poderá ser utilizado; por exemplo, queue://qmgrname/queuename para WebSphere MQ. Caso contrário, o valor será utilizado para criar um destino temporário.
  • Os itens aos quais o destino JMS se refere representam destinos JMS que podem ser filas JMS ou tópicos JMS. Estes tipos de destinos devem ser consistentes com o tipo de connection factory especificado no nó JMSOutput que processará a lista de destino. Por exemplo, um destino de fila JMS pode ser processado por um factory de conexão da fila JMS ou por um factory de conexão JMS genérico. Da mesma forma, um destino de tópico JMS pode ser processado por um factory de conexão de tópico JMS ou por um factory de conexão JMS genérico.
Para obter informações adicionais sobre como usar variáveis de ambiente local em um nó JMSOutput, consulte Usando Variáveis LocalEnvironment com Nós JMSOutput e JMSReply.

Disponibilizando o Cliente do Provedor JMS para os Nós JMS

Os serviços configuráveis são definidos para vários provedores JMS. Você pode escolher um dos serviços predefinidos ou pode criar um novo serviço para um novo provedor ou para um dos provedores existentes. Os serviços predefinidos estão listados em Propriedades de Serviços Configuráveis.

  • Se desejar utilizar o provedor JMS do WebSphere MQ e tiver instalado o WebSphere MQ no local padrão no sistema do broker, as propriedades já estarão configuradas e não será necessário fazer alterações.
  • Se você quiser usar o provedor JMS do WebSphere MQ e tiver instalado o WebSphere MQ em um local diferente (não padrão), ou quiser usar um dos outros serviços definidos, será necessário configurar a propriedade jarsURL para identificar o local dos arquivos JAR de serviço no sistema do broker. No Windows, o local do arquivo não pode ser uma unidade de rede mapeada em um computador Windows remoto; o diretório deve ser local ou estar em um disco de Rede de Área de Armazenamento (SAN).

    Utilize o comando mqsireportproperties para visualizar as propriedades do provedor e o comando mqsichangeproperties para configurar ou modificar as propriedades.

  • Se nenhum serviço estiver definido para seu provedor JMS, ou se você desejar criar outro serviço para um provedor JMS existente, utilize o comando mqsicreateconfigurableservice para identificar o novo serviço e configurar suas propriedades.
  • Quando você configurar o nó, selecione o serviço apropriado na lista de serviços predefinidos mostrada para a propriedade Nome do Provedor JMS ou digite o nome de seu novo serviço.
  • Alguns provedores JMS fornecem uma interface alternativa a partir da especificação JMS padrão para chamadas de API JMS específicas. Nestes casos, a IBM® fornece um arquivo Java JAR para fazer interface com essa API proprietária. Por exemplo, se os nós JMS usarem BEA WebLogic como o provedor JMS e os nós precisarem participar de um fluxo de mensagens coordenado por XA, você deverá modificar as propriedades de serviços configuráveis que estão associadas a esse fornecedor. Para informações adicionais, consulte Configurando o Intermediário para Ativar uma API do Proprietário do Provedor JMS.
  • Para conectar-se a diferentes versões de um provedor JMS, crie um serviço configurável JMSProviders para cada versão do provedor JMS e depois configure a propriedade jarsURL como um caminho exclusivo.

Utilizando o Modo de Destino da Mensagem

O nó JMSOutput age como um produtor de mensagens e suporta os seguintes cenários de mensagem: Para obter informações adicionais sobre como construir listas de destino JMS, consulte Preenchendo o Destino na Árvore de Ambiente Local.

Enviando uma Mensagem de Datagrama

Datagrama é uma entidade de dados independente e completa que contém informações suficientes para serem roteadas do computador de origem para o de destino, sem confiar em trocas anteriores entre o computador de origem e de destino e a rede de transportes. As instruções a seguir descrevem como enviar uma mensagem de datagrama:
  1. Na guia Básico, configure o destino da mensagem, dependendo do modelo de mensagem que está sendo utilizado. Defina uma das seguintes propriedades com um nome de objeto válido administrado por JNDI:
    • Tópico de Publicação
    • Fila de Destino
  2. Deixe em branco o campo Responder ao Destino (Reply To Destination).
O nó resolve o nome do objeto administrado da JNDI, que é fornecido na propriedade Tópico de Publicação ou Fila de Destino e envia a mensagem para esse destino JMS.

Enviando uma Mensagem de Resposta

O emissor de uma mensagem poderá querer que o destinatário responda à mensagem. Nesse caso, a mensagem JMSOutput pode tratar a mensagem de saída como uma resposta, e roteá-la de acordo com o valor obtido da propriedade JMSReplyTo da mensagem de solicitação. Você pode modificar o valor da propriedade JMSReplyTo em MbMessage; por exemplo, utilizando um nó Compute ou um nó JavaCompute. Esta ação permite o roteamento dinâmico de mensagens do nó JMSOutput. O nó envia a mensagem para o nome do destino JMS que está configurado no campo JMSReplyTo da Árvore MbMessage.

O valor JMSReplyTo na Árvore MbMessage (MbMessage Tree) representa o nome do Destino JMS (JMS Destination) que é resolvido pelo JNDI. Exemplo:
queue://QM_mn2/myJMSQueue4
Nesse caso, o valor é a representação específica do provedor JMS de um destino JMS para o provedor JMS do WebSphere MQ.
Se não desejar especificar um nome do destino JMS resolvido, o nó JMSOutput também poderá aceitar um nome de objeto administrado JNDI no campo JMSReplyTo. No entanto, o nó deve resolver um nome de objeto administrado através da JNDI antes de poder rotear a mensagem para o destino JMS subjacente. Neste caso, o valor no campo JMSReplyTo deve ser prefixado com a cadeia: jndi://. Por exemplo:
jndi://jmsQ4
em que jmsQ4 é o nome do objeto administrado por JNDI.

O desempenho pode ser afetado quando você usa este método, por causa da necessidade de consultar o objeto administrado no JNDI.

Enviando uma Mensagem de Pedido

O nó JMSOutput pode enviar uma mensagem para um destino JMS com a expectativa de uma resposta do consumidor de mensagem que processa a solicitação. As instruções a seguir descrevem como enviar uma mensagem de pedido:
  1. Na guia Básico, configure o destino da mensagem, dependendo do modelo de mensagem que está sendo utilizado. Defina uma das seguintes propriedades com um nome de objeto válido administrado por JNDI:
    • Tópico de Publicação
    • Fila de Destino
  2. O destino JMSReplyTo na mensagem de saída pode ser derivado do campo JMSReplyTo da Árvore MbMessage transmitida ao nó. Como alternativa, esse valor pode ser anulado por um nome de objeto administrado por JNDI que é definido na propriedade do nó Reply To Destination (Responder ao Destino).

    Para permitir que o nó JMSOutput configure a propriedade JMSReplyTo dinamicamente na mensagem de saída, deixe o campo Responder ao Destino em branco na guia Básico e configure o valor JMSReplyTo em MbMessage utilizando um nó Compute ou um nó JavaCompute.

O nó procura primeiro um valor no campo JMSReplyTo da MbMessage. Se o nó encontrar o valor, ele o transmitirá no campo JMSReplyTo da mensagem de saída. No entanto, se o campo Responder ao Destino da guia Básico tiver sido especificado, este valor substituirá tudo o que foi configurado anteriormente na propriedade JMSReplyTo da mensagem de saída, depois de resolver primeiro o nome do objeto administrado JNDI.

O nó resolve o nome do objeto administrado pela JNDI que é fornecido no Tópico de Publicação ou na Fila de Destino e envia a mensagem a esse destino JMS.

Invocando uma Função de Retorno de Chamada da Mensagem de Saída

A função cciOutputMessageCallback pode ser registrada como um retorno de chamada e invocada sempre que uma mensagem é enviada por um nó do JMSOutput. Consulte o cciOutputMessageCallback.

Se o estado da saída de usuário for ativo, a função cciOutputMessageCallback será invocada para cada mensagem de saída que é enviada com êxito a partir de um nó do JMSOutput no qual o retorno de chamada é registrado.

Se o nó fornecer informações de WrittenDestination na árvore LocalEnvironment, o retorno de chamada será chamado após a criação destas informações. Consulte o Usando Variáveis LocalEnvironment com Nós JMSOutput e JMSReply.

Trabalhando com o ID de Mensagem JMS

O ID de mensagem JMS é gerado pelo provedor JMS quando uma mensagem é enviada pelo nó JMSOutput. Você não pode configurar o ID de mensagem no fluxo de mensagens, mas pode utilizar um dos seguintes métodos para obter o ID gerado após a mensagem ter sido enviada:
  • Conecte um nó Compute ao terminal de Saída.

    Conecte um nó Compute ao terminal de Saída de um nó JMSOutput e interrogue a Lista WrittenDestination. Para informações adicionais, consulte Visualizando a Árvore Mensagem Lógica na Saída do Rastreio.

    Uma entrada para um nó JMSOutput possui o seguinte formato:
    WrittenDestination = (
       JMS = (
          DestinationData = (
            destinationName = 'queue://jmsQueue1'
            initialContext = 'com.sun.jndi.fscontext.RefFSContextFactory'
            JMSMessageID = ID:414d512054657374514d2020202020206ab98b4520017a02'
            JMSCorrelationID = 'ABCDEFGHIJKLMNOPQRSTUVW'
      )
     )
    )
  • Configure uma saída de usuário para processar um evento de retorno de chamada da mensagem de saída. Para informações adicionais, consulte Explorando Saídas de Usuário.

Configurando para Transações Coordenadas

Quando incluir um nó JMSOutput em um fluxo de mensagens, o valor configurado para o Modo de Transação define se as mensagens são enviadas sob o ponto de sincronização.

  • Se você configurar o Modo de Transação como Sim e a propriedade de fluxo Transação coordenada estiver selecionada, a mensagem será enviada sob coordenação do ponto de sincronização externo; ou seja, em uma unidade de trabalho do WebSphere MQ. Todas as mensagens enviadas subseqüentemente por um nó de saída na mesma instância do fluxo de mensagens serão colocadas no ponto de sincronização, a menos que o nó de saída substitua essa configuração explicitamente.
  • Se você configurar o Modo de Transação como Sim e a propriedade de fluxo Transação coordenada não estiver selecionada, a mensagem será enviada sob controle do ponto de sincronização local do nó JMSOutput. Nenhuma mensagem enviada subseqüentemente por um nó de saída no fluxo será colocada no ponto de sincronização local, a menos que um nó de saída individual especifique que a mensagem deve ser colocada no ponto de sincronização local.
  • Se você configurar o Modo de Transação como Não, a mensagem não será enviada no ponto de sincronização. Nenhuma mensagem enviada subseqüentemente por um nó de saída no fluxo será colocada no ponto de sincronização, a menos que um nó de saída individual especifique que a mensagem deve ser colocada no ponto de sincronização.
Quando desejar enviar mensagens sob o ponto de sincronização externo, será necessário desempenhar etapas de configuração adicionais, que precisam ser aplicadas apenas na primeira vez que um JMSOutput ou JMSInput for implementado no broker para um provedor JMS específico:
  • Em sistemas distribuídos, o coordenador do ponto de sincronização externo para o broker é WebSphere MQ. Antes de implementar um fluxo de mensagens no qual o Modo de Transação está configurado como Sim e a propriedade de fluxo Transação Coordenada está selecionada, modifique o arquivo .ini do gerenciador de filas para incluir definições extras de cada gerenciador de recursos do provedor JMS que participa das transações coordenadas por XA:
    • Windows platformNo Windows em sistemas x86:
      1. Inicie o WebSphere MQ Explorer.
      2. Clique com o botão direito do mouse no nome do gerenciador de filas, na área de janela esquerda, e clique em Propriedades (Properties).
      3. Clique em Gerenciadores de recursos XA (XA resource managers) na área de janela esquerda.
      4. Configure a propriedade SwitchFile para o seguinte valor:
        install_dir/bin/ JMSSwitch.dll  
        XAOpenString=Initial Context,location JNDI,Optional_parms
        ThreadOfControl=THREAD 
      Para obter informações adicionais, consulte a seção Guia de Administração do Sistema do Centro de Informações Online do WebSphere MQ Versão 7.
    • Windows platformNo Windows em sistemas x86-64:
      1. Inicie o WebSphere MQ Explorer.
      2. Clique com o botão direito do mouse no nome do gerenciador de filas, na área de janela esquerda, e clique em Propriedades (Properties).
      3. Clique em Gerenciadores de recursos XA (XA resource managers) na área de janela esquerda.
      4. Configure a propriedade SwitchFile para o seguinte valor:
         JMSSwitch
              XAOpenString=Initial Context,location JNDI,Optional_parms
              ThreadOfControl=THREAD 
      5. Copie o arquivo do comutador JMSSwitch32.dll no subdiretório \exits no diretório de instalação WebSphere MQ e o renomeie para JMSSwitch.dll. Copie o arquivo do comutador JMSSwitch.dll para o subdiretório \exits64 no diretório de instalação do WebSphere MQ.
      Para obter informações adicionais, consulte a seção Guia de Administração do Sistema do Centro de Informações Online do WebSphere MQ Versão 7.
    • Linux platformUNIX platformNos sistemas Linux e UNIX, inclua uma sub-rotina no arquivo .ini do gerenciador de filas para cada provedor JMS.
      Exemplo:
      XAResourceManager:
      Name=Jms_Provider_Name 
      SwitchFile=/install_dir/bin/JMSSwitch.so
      XAOpenString=Initial Context,location JNDI,Optional_parms
      ThreadOfControl=THREAD
      Em que:
      Nome
      é um nome definido pela instalação que identifica um gerenciador de recursos do provedor JMS.
      SwitchFile
      é o caminho do sistema de arquivo para a biblioteca JMSSwitch que é fornecida no diretório bin do intermediário.
      XAOpenString pode ter os seguintes valores:
      • Contexto Inicial é o valor configurado na propriedade básica do nó JMSInput, Initial Context Factory.
      • JNDI local é o valor configurado na propriedade básica do nó do JMSInput Local das Ligações JNDI. Este valor deve incluir a palavra-chave inicial, que é file://, iiop:// ou ldap://
      Os parâmetros a seguir são opcionais:
      • Proprietário LDAP (LDAP Principal) corresponde ao valor configurado para o intermediário utilizando os comandos mqsicreatebroker ou mqsichangebroker.
      • Credenciais LDAP (LDAP Credentials) corresponde ao valor configurado para o intermediário utilizando os comandos mqsicreatebroker ou mqsichangebroker.
      • Nome da Connection Factory de Recuperação (Recovery Connection Factory Name) é a connection factory administrada por JNDI definido no arquivo de ligações. Se um valor não for especificado, um valor padrão para recoverXAQCF deverá ser incluído no arquivo de ligações. Em ambos os casos, o Gerador de Conexão de Recuperação deve ser definido com um Gerador de Conexão de Fila XA para o provedor JMS que está associado ao Gerador de Contexto Inicial.

      Os parâmetros opcionais são separados por vírgula e posicionais. Portanto, quaisquer parâmetros que estejam faltando devem ser representados por uma vírgula.

      1. Atualize a variável de ambiente CLASSPATH Java para o gerenciador de filas do broker incluir uma referência a xarecovery.jar; por exemplo:
        install_dir/classes/xarecovery.jar
      2. Atualize a variável de ambiente PATH Java para que o gerenciador de filas do broker aponte para o diretório bin, que é onde o arquivo do comutador está localizado; por exemplo:
        install_dir/bin

      Para obter informações adicionais, consulte a seção Guia de Administração do Sistema do Centro de Informações Online do WebSphere MQ Versão 7.

    • z/OS platformNo z/OS, o gerenciador de ponto de sincronização externo é o RRS (Resource Recovery Services). O único provedor JMS suportado no z/OS é o WebSphere MQ JMS. A única opção de transporte suportada para o WebSphere MQ JMS no z/OS é a opção ligação.

      O controle do ponto de sincronização para o provedor JMS é gerenciado com a coordenação do ponto de sincronização RRS do gerenciador de filas do broker. Não é necessário modificar o arquivo .ini .

Se o nó JMSOutput usar BEA WebLogic como o provedor JMS e os nós precisarem participar de um fluxo de mensagens coordenado, consulte Disponibilizando o Cliente do Provedor JMS para os Nós JMS.

Conectando Terminais

Conecte o terminal In do nó JMSOutput ao nó a partir do qual as mensagens de saída são roteadas.

Conecte o terminal Out do nó JMSOutput a outro nó no fluxo de mensagens para processar a mensagem posteriormente, para processar erros ou para enviar a mensagem para um destino adicional.

Terminais e Propriedades

Quando tiver colocado uma instância do nó JMSOutput 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. Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco.

Os terminais do nó JMSOutput 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 é encaminhada se um ocorrer erro. Mesmo que a propriedade Validação (Validation) esteja definida, as mensagens propagadas para esse terminal não serão validadas.
Saída O terminal de saída para o qual a mensagem será roteada se tiver sido colocada com sucesso no destino de saída (tópico ou fila).

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 se você precisar inserir um valor quando nenhum padrão estiver definido), a coluna com cabeçalho C indica se a propriedade é configurável (você pode alterar o valor quando incluir o fluxo de mensagens no arquivo BAR para implementá-lo).

As propriedades Descrição do nó JMSOutput são descritas na tabela a seguir.
Propriedade M A O padrão Descrição
Nome de nó Não Não O tipo de nó, JMSOutput 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ó JMSOutput são descritas na tabela a seguir.
Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Fila de Destino Não Sim   O nome da fila para a qual o nó publica mensagens de saída. Se o nó JMSOutput tiver que ser utilizado para enviar mensagens ponto a ponto, digite o nome da Fila de Destino para o nome da fila JMS listado no arquivo de ligações. destinationQueueName
Tópico de Publicação Não Sim   O nome do tópico no qual o nó publica mensagens.
  • Se essa propriedade estiver configurada, o nó operará somente no domínio de mensagem de Publicação/Assinatura.
  • Essa propriedade é mutuamente exclusiva com a propriedade Fila de Destino (Destination queue).
  • O nome do Tópico de Publicação (Publication Topic) deve estar de acordo com os padrões do provedor JMS que está sendo utilizado pelo nó.
tópico
Responder ao destino (Reply to destination) Não Sim   O nome do destino de JMS para o qual o aplicativo de recebimento deve enviar uma mensagem de resposta. Para retornar uma mensagem de resposta a esse destino JMS, o nome do destino JMS deve ser conhecido para o domínio do provedor JMS que é utilizado pelo cliente receptor. Você pode digitar um destino JMS, que pode ser uma fila de assinatura ou um tópico de destino.

O valor padrão é vazio e, neste caso, a mensagem de saída JMS pode ser considerada um datagrama. Se o campo estiver em branco, o nó JMSOutput não esperará uma resposta do cliente JMS de recebimento.

replyToDestination
Enviar para a lista de destino no ambiente local Não Sim Limpo Quando você tiver construído uma lista de destinos JMS no ambiente local, selecione esta caixa de opção para usar a lista de destino. Se você não selecionar esta caixa de opção, o nó utilizará o destino JMS configurado. Se você selecionar esta caixa de opção mas não tiver criado uma lista de destinos de JMS no ambiente local, o nó usará o destino de JMS configurado. useDistList
As propriedades Conexão JMS do nó JMSOutput são descritas na tabela a seguir.
Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Nome do provedor JMS Sim Não WebSphere MQ Selecione um nome de fornecedor JMS na lista ou digite um nome de sua preferência. Quando você selecione um nome na lista, a propriedade Gerador de Contexto Inicial é atualizada automaticamente com a classe Java relevante. Se você digitar seu próprio nome de provedor JMS, também deverá digitar um valor para o Gerador de Contexto Inicial. O nome deve corresponder ao nome de um serviço configurável definido para o broker para o qual o fluxo de mensagens é implementado. Alternativamente, é possível especificar o serviço configurável JMSProviders.  
Depósito de Informações do Provedor de Contexto Inicial Não Sim com.sun.jndi.fscontext. RefFSContextFactory Essa propriedade é o ponto de início de um espaço de nomes JNDI. Um aplicativo JMS utiliza o contexto inicial para obter e consultar a connection factory e objetos de fila ou tópico para o provedor JMS.

Se você selecionar um nome de provedor JMS na lista em Nome de Provedor JMS, a propriedade Gerador de Contexto Inicial é atualizada automaticamente com a classe Java relevante. Se você digitar seu próprio nome de provedor JMS, também deverá digitar um valor para o Gerador de Contexto Inicial. O valor padrão é com.sun.jndi.fscontext.RefFSContextFactory, que define o depósito de informações de contexto inicial baseado em arquivo para o provedor JMS do WebSphere MQ.

Se o nó estiver configurado para usar seu próprio provedor JMS, e a Propriedade de serviços configuráveis correspondente da definição do mqsichangeproperties tiver o conjunto de atributos InitialContextFactory, isso substituirá a configuração do nó.

initialContextFactory
Ligações JNDI de Local Não Sim   O caminho do sistema ou local LDAP para o arquivo de ligações O arquivo de ligações contém definições para objetos administrados JNDI que são utilizados pelo nó JMSOutput.
Ao digitar um valor para Ligações JNDI de Local (Location JNDI Bindings), assegure-se de que ele esteja de acordo com as seguintes instruções:
  • Construa o arquivo de ligações antes de implementar um fluxo de mensagens que contém um nó JMSOutput.
  • Não inclua o nome do arquivo de ligações nesse campo.
  • Se você tiver especificado um local do LDAP que exija autenticação, configure o proprietário LDAP (ID do usuário) e as credenciais LDAP (senha) separadamente. Estes valores são configurados no nível do broker. Para obter informações sobre esses valores, consulte Comando mqsicreatebroker and Comando mqsichangebroker.
  • O valor da cadeia deve incluir um prefixo URL suportado que tenha um manipulador de URL que esteja disponível no caminho de classe.

Para obter informações sobre a construção de arquivo de ligações de objetos administrados por JNDI, consulte a documentação que é fornecida com o provedor JMS.

Se o nó estiver configurado para usar seu próprio provedor JMS e a Propriedade de serviços configuráveis correspondente da definição mqsichangeproperties tiver o atributo jndiBindingsLocation configurado, isso substituirá a configuração no nó.

locationJndiBindings
Nome da Connection Factory Não Sim   O nome da connection utilizada pelo nó JMSOutput para criar uma conexão com o provedor JMS. Esse nome já deve existir no arquivo de ligações. A Connection factory pode ser uma QueueConnectionFactory JMS ou uma TopicConnectionFactory JMS, mas ela deve corresponder ao modelo de mensagem que é usado pelo nó. Como alternativa, você pode especificar o ConnectionFactory JMS genérico, que pode ser utilizado para destinos de fila JMS ou de tópico JMS. connectionFactoryName
As propriedades Avançadas do nó JMSOutput são descritas na tabela a seguir.
Propriedade M A O padrão Descrição
Novo ID de Correlação Não Sim   Se o nó JMSOutput for necessário para gerar um novo ID de Correlação para a mensagem, selecione Novo ID de Correlação. Se deixar a caixa de opção desmarcada, o ID de Correlação da mensagem de saída é obtido no campo JMSCorrelationID na seção JMSTransport_Header_Values da árvore de mensagens.
Modo de Transação Sim Não Não
Essa propriedade controla se a mensagem é recebida em uma transação JMS. Os valores válidos são Sim e Não.
  • Selecione Não para receber a mensagem usando uma sessão JMS não transacional.
  • Selecione Sim para receber a mensagem usando uma sessão JMS transacional. A transação JMS pode ser local ou coordenada por XA. Para usar uma transação XA usando uma sessão JMS XA, você também deve selecionar a propriedade de fluxo de mensagens Transação Coordenada nas propriedades do arquivo BAR. Consulte o Configurando para Transações JMS Coordenadas.
O valor configurado para Modo de Transação no nó JMSOutput é herdado pelo recebimento de dados de nós no fluxo de mensagens que têm seu Modo de Transação configurado como Automático. Outros recursos que executam trabalho no fluxo de mensagens, como DB2 ou WebSphere MQ, usam transações independentemente da configuração Modo de Transação do nó e confirmam suas transações após o processamento da mensagem.
Modo de Entrega Não Sim Não Persistente Essa propriedade controla o modo de persistência que um provedor JMS utiliza para uma mensagem. Os valores válidos são:
  • Automático (Automatic): o modo da mensagem de entrada é herdado
  • Persistente (Persistent): a mensagem permanecerá se o provedor JMS tiver uma falha do sistema
  • Não Persistente (Non Persistent): a mensagem será perdida se o provedor JMS tiver uma falha do sistema
Expiração da Mensagem (Message Expiration (ms)) Não Sim 0 Esta propriedade controla o período de tempo, em milissegundos, durante o qual o provedor JMS mantém a mensagem JMS de saída. O valor padrão, 0, é utilizado para indicar que a mensagem não deve expirar.
Selecione Herdar do Cabeçalho ou digite um inteiro que representa um número de milissegundos. Se você selecionar Herdar do Cabeçalho, a propriedade herdará o valor do campo JMSExpiry na mensagem JMS, que está localizada no seguinte local:
OutputRoot.JMSTransport.Transport_Folders.Header_Values.JMSExpiration
Prioridade de Mensagem Não Sim 4 Esta propriedade designa a importância relativa à mensagem e pode ser utilizada para seleção de mensagem por um aplicativo cliente JMS de recebimento ou um nó JMSOutput.

Selecione um valor entre 0 (prioridade mais baixa) e 9 (prioridade mais alta) ou selecione Herdar do Cabeçalho.

O valor padrão é 4, que indica prioridade média. As prioridades no intervalo de 0 a 4 estão relacionadas à entrega típica. As prioridades no intervalo de 5 a 9 estão relacionadas a graus de entrega expedida. Se você selecionar Herdar do Cabeçalho, a propriedade herdará o valor do campo JMSPriority na mensagem JMS, que está localizada no seguinte local:
OutputRoot.JMSTransport.Transport_Folders.Header_Values.JMSPriority
Tipo de Mensagem Não Sim Determine o tipo de mensagem de saída da Árvore de Mensagens JMS Selecione um valor na lista para configurar o tipo de mensagem JMS que é produzida pelo nó JMSOutput. Se você não configurar um valor para esta propriedade, o nó assumirá o tipo de saída do campo PayLoadType de metadados na árvore de mensagens JMS, conforme indicado pelo valor padrão, Determinar o tipo de mensagem de saída da Árvore de Mensagens JMS. Os valores válidos são:
  • Determine o tipo de mensagem de saída da Árvore de Mensagens JMS
  • TextMessage
  • BytesMessage
  • MapMessage
  • StreamMessage
  • ObjectMessage
  • Mensagem JMS Básica sem Carga Útil
As propriedades Validação do nó JMSOutput são descritas na tabela a seguir. Para obter informações adicionais sobre as propriedades de Validação, consulte Validando Mensagens e Propriedades de Validação.
Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Herdar Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo, Conteúdo e Valor e Herdar. validateMaster
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.  
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:29


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac24830_