Utilize o nó JMSInput para receber mensagens de destinos JMS. Os destinos JMS são acessados por meio de uma conexão com um provedor JMS.
O nó JMSInput age como um consumidor de mensagens JMS e pode receber todos os seis tipos de mensagens definidos na Especificação Java Message Service, Versão 1.1. As mensagens são recebidas utilizando chamadas de método, que são descritas na especificação JMS.
O nó JMSInput 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 um nó de saída em um fluxo de mensagens que comece com um nó JMSInput, ele poderá ser qualquer um dos nós de saída suportados (incluindo nós de saída definidos pelo usuário); não é necessário incluir um nó JMSOutput. No entanto, se você não incluir um nó JMSOutput, deverá incluir o nó JMSMQTransform para transformar a mensagem no formato esperado pelo nó de saída.
Se estiver propagando mensagens JMS e criando um fluxo de mensagens para ser utilizado como um subfluxo, não será possível utilizar um nó de entrada padrão; é necessário utilizar uma instância do nó JMSInput como o primeiro nó para criar um terminal In para o subfluxo.
export MQSI_LIBPATH32=$MQSI_LIBPATH32:/usr/mqm/lib:/usr/mqm/java/lib
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.
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.
Para cada mensagem recebida com êxito, o nó JMSInput roteia a mensagem para o terminal Out. Se essa ação falhar, a mensagem será repetida. Se o limite de repetição for alcançado, em que o limite é definido pela propriedade Limite de Restauração do nó, a mensagem será roteada para o terminal Failure. Você pode conectar nós ao terminal Failure para manipular essa condição.
Se ocorrer uma exceção no caminho de falha, o caminho é tentado novamente até o número de tentativas ser duas vezes o Limite de Restauração. Se esse limite for excedido, a mensagem é colocada no Destino de Restauração.
Se você não conectou os nós ao terminal Failure, a mensagem é gravada no Destino de Restauração. Se não tiver especificado um Destino de Restauração, o nó emite a mensagem de erro BIP4669 e pára de processar entradas adicionais.
Se a mensagem for capturada pelo nó JMSInput após a geração de uma exceção em outro lugar no fluxo de mensagens, a mensagem será roteada para o terminal Catch. Se você não tiver conectado nós ao terminal Catch, o nó restaurará mensagens para nova entrega, até que o problema seja resolvido, ou o Limite de Restauração seja atingido. Se você não definir um Destino de Restauração, o nó emitirá uma mensagem de erro BIP4669 e interromperá o processamento da entrada futura.
Quando você incluir um nó JMSInput em um fluxo de mensagens, o valor configurado para o Modo de Transação define se as mensagens são recebidas no 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 são determinados por posição. 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 o 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 fila para o intermediário e o provedor JMS, certifique-se de que a instalação do WebSphere MQ esteja no nível mínimo necessário: Versão 5.3 CSD12 ou Versão 6.0 Fix Pack 1.
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: WebSphere MQ Versão 6.0 Fix Pack 1 ou acima é requerido para XA para utilizar o mesmo gerenciador de filas para o intermediário e o provedor.
controle do ponto de sincronização para o provedor JMS é gerenciado com a coordenação de ponto de sincronização RRS do gerenciador de filas do intermediário. Não é necessário modificar o arquivo .ini .
Quando tiver colocado uma instância do nó JMSInput 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 |
---|---|
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. |
Catch | O terminal de saída para o qual a mensagem será roteada se uma exceção for gerada no recebimento de dados 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 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 ao arquivo BAR para implementá-lo).
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | O tipo de nó, JMSInput | 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 |
---|---|---|---|---|
Fábrica de contexto inicial | Sim | Sim | com.sun.jndi.fscontext. RefFSContextFactory | O ponto inicial para um espaço de nomes JNDI.
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 Gerador de Contexto Inicial baseado em arquivo para o provedor de JMS WebSphere MQ. Para identificar o nome do Gerador de Contexto Inicial para o provedor de JMS, consulte a documentação do provedor de JMS. |
Ligações JNDI do local | Sim | 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 de JNDI
que são utilizados pelo nó JMSInput. Quando você digita
um valor para Ligações de JNDI de Local,
verifique se ele está de acordo com as seguintes instruções:
Para obter informações sobre a construção de arquivo de ligações de objetos JNDI administrados, consulte a documentação do provedor de JMS. |
|
Nome de fábrica da conexão | Sim | Sim | O nome da connection utilizada pelo nó JMSInput para criar uma conexão com o provedor JMS. Esse nome já deve existir no arquivo de ligações. | |
Destino de restauração | Não | Sim | O nó JMSInput envia mensagens de entrada para este destino quando erros impedem o fluxo de mensagens de processar a mensagem e a mensagem deve ser removida do destino de entrada. O nome de destino de backout deve existir no arquivo de ligações. | |
Limite de Backout | Não | Sim | 0 | O valor que controla quando uma mensagem entregue novamente é colocada no destino de restauração. Por exemplo, se o valor for 3, o provedor JMS tentará entregar a mensagem no destino de entrada três vezes. Depois da terceira tentativa de entrega, a mensagem é removida do destino de entrada e é enviada para o Destino de Recuperação. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Modo de Transação | Sim | Não | nenhum | Esta propriedade controla se a mensagem que chega
é recebida no ponto de sincronização externo, ponto de sincronização local ou saída do ponto de sincronização.
|