Utilize o nó JMSOutput para enviar mensagens para destinos JMS.
Este tópico contém as seguintes seções:
O nó JMSOutput age como um produtor de mensagens JMS e pode publicar todos os seis tipos de mensagens que são definidos na Especificação Java Message Service, 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 ambiente de trabalho pelo seguinte ícone:
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.
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.
Serviços configuráveis são definidos para diversos JMSProviders. 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.
mqsireportproperties brokerName -c AllTypes -o AllReportableEntityNames -r
Utilize o comando mqsireportproperties para visualizar as propriedades do provedor e o comando mqsichangeproperties para configurar ou modificar as propriedades.
O emissor de uma mensagem poderá querer que o destinatário responda à mensagem. Neste 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 pedido. 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á definido no campo JMSReplyTo da Árvore MbMessage.
queue://QM_mn2/myJMSQueue4Nesse caso, o valor é a representação específica do provedor JMS de um Destino JMS para o provedor JMS do WebSphere MQ.
jndi:\\jmsQ4em que jmsQ4 é o nome do objeto administrado por JNDI.
O desempenho poderá ser ligeiramente impactado quando você utilizar esse método, por causa da necessidade de consultar o objeto administrado no JNDI.
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ó resolve o nome do objeto administrado por JNDI que é fornecido no Tópico de Publicação (Publication Topic) ou na Fila de Destino (Destination Queue) e envia a mensagem a esse Destino JMS (JMS Destination).
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.
install_dir/bin/ JMSSwitch.dll XAOpenString=Initial Context,location JNDI,Optional_parms ThreadOfControl=THREAD
install_dir/bin/ JMSSwitch.dll XAOpenString=Initial Context,location JNDI,Optional_parms ThreadOfControl=THREAD
XAResourceManager: Name=Jms_Provider_Name SwitchFile=/install_dir/bin/JMSSwitch.so XAOpenString=Initial Context,location JNDI,Optional_parms ThreadOfControl=THREADEm que:
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.
install_dir/classes/xarecovery.jar
install_dir/bin
Para obter informações adicionais consulte a seção Guia de Administração do Sistema do WebSphere MQ Versão 6: centro de informações on-line ou o manual da Versão 5.3 no WebSphere MQ.
Para utilizar o mesmo gerenciador de filas para o intermediário e o provedor JMS, assegure que sua instalação do WebSphere MQ esteja no nível mínimo requerido: Versão 5.3 CSD12.
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 intermediário. Não é necessário modificar o arquivo .ini .
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.
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. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em Propriedades. Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco.
Terminal | Descrição |
---|---|
In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Failure | 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. |
Out | O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila do WebSphere MQ. |
Catch | O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó. |
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).
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do 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. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Depósito de Informações do Provedor de Contexto Inicial | Sim | 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. Digite um valor de Depósito de informações de contexto inicial (Initial context factory). Um aplicativo JMS utiliza o contexto inicial para obter e consultar os objetos administrados de JNDI para o provedor JMS. 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. Para identificar o nome do Gerador de Contexto Inicial para o provedor JMS, consulte a documentação do provedor de JMS. |
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:
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. |
|
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. |
Propriedade | M | C | 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 | Nenhuma | Essa propriedade controla se a mensagem que chega é recebida no
ponto de sincronização.
|
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:
|
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. |
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. Os valores válidos para a prioridade de mensagem são de 0 (prioridade mais baixa) a 9 (prioridade mais alta). 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. |