Este tópico contém as seguintes seções:
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 no 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 é representado no workbench pelo seguinte ícone:
O nó JMSInput recebe e propaga mensagens com uma árvore de mensagens JMS. É possível configurar as propriedades do nó JMSInput para controlar a maneira como as mensagens JMS são recebidas.
O nó JMSInput manipula mensagens nos seguintes domínios de mensagens:
Os fluxos de mensagens, que manipulam mensagens recebidas de conexões com provedores JMS, sempre devem ser iniciados com um nó JMSInput. Se você incluir um nó output 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ó output.
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 de Entrada para o subfluxo.
Para plataformas distribuídas, copie os arquivos .jar java e quaisquer bibliotecas nativas para o cliente do provedor JMS para o diretório de classes compartilhadas do intermediário. Por exemplo, no Windows C:\Documents and Settings\All Users\Application Data\IBM\MQSI\shared-classes. Isso assegura que o caminho de classe Java para os nós JMS sejam configurados corretamente.
Para o z/OS, não há nenhum diretório de classes compartilhadas. Em vez disso, você deve especificar cada arquivo .jar Java do provedor JMS no caminho de classe no membro BIPPROF do PDS (Partitioned Data Set) do intermediário. Em seguida, atualize o LIBPATH com quaisquer bibliotecas nativas e envie a tarefa BIPGEN JCL para atualizar o intermediário ENVFILE.
Quando tiver colocado uma instância do nó JMSInput em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito do mouse na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas no diálogo de propriedades.
Todas as propriedades obrigatórias, que não possuem um valor padrão definido, são marcadas com um asterisco no diálogo das propriedades.
Configure o nó JMSInput da seguinte forma:
com.sun.jndi.fscontext.RefFSContextFactory, que define o depósito de informações do provedor de contexto inicial baseado em arquivo para o provedor JMS do WebSphere MQ.
Para identificar o nome do Depósito de Informações do Provedor de Contexto Inicial para o provedor JMS, consulte a documentação do provedor JMS.
Ao digitar um valor para Ligações de JNDI de Local, assegure que esteja de acordo com as seguintes instruções:
Para obter informações sobre como construir o arquivo de ligações de objetos administrados de JNDI, consulte a documentação fornecida com o provedor JMS.
Deixe a opçãoConjunto de Mensagens em branco para os analisadores XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Deixe a opção Tipo de Mensagem em branco para analisadores XML, XMLNS, XMLNSC, JMS, MIME, BLOB e IDOC.
Deixe Formato da Mensagem em branco para os analisadores XML, XMLNS, XMLNSC, JMSMap, JMSStream, MIME e BLOB.
Deixe esta propriedade em branco se não desejar que o nó input selecione com base na propriedade do aplicativo. Consulte Seletores de Mensagens JMS para obter uma descrição de como construir o seletor de mensagens.
Deixe esta propriedade em branco se não desejar que o nó input selecione com base em JMSTimeStamp.
Os valores válidos para prioridade de mensagem vão de 0 (o mais baixo) a 9 (o mais alto). Por exemplo, é possível digitar 5 para receber mensagens de prioridade 5. Você também pode qualificar o seletor; por exemplo, > 4 para receber mensagens com prioridade maior que 4 ou BETWEEN 4 AND 8 para receber mensagens com prioridade no intervalo de 4 a 8.
Deixe esta propriedade em branco se não desejar que o nó input selecione com base em JMSPriority.
Digite um ID de mensagem específico ou um seletor condicional; por exemplo, digite> WMBRK123456 para retornar mensagens em que o ID de mensagem é maior que o WMBRK123456.
Deixe essa propriedade em branco se não quiser que o nó input faça uma seleção baseada no JMSMessageID.
Digite FALSE se o nó input aceitar somente mensagens que não foram entregues novamente pelo Provedor JMS.
Digite TRUE se o nó input aceitar somente mensagens que foram entregues novamente pelo Provedor JMS.
Deixe essa propriedade em branco se não quiser que o nó input faça a seleção com base em JMSRedelivered.
Digite um ID de Correlação específico ou digite uma cadeia condicional; por exemplo, WMBRKABCDEFG retorna mensagens cujo ID de Correlação corresponde a esse valor.
Deixe essa propriedade em branco se não desejar que o nó input faça a seleção com base em JMSCorrelationID.
Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
Se você alterar esse valor para Imediata, a análise parcial será substituída e tudo o que estiver na mensagem será analisado e validado, exceto os tipos complexos com uma Composição de Opção ou Mensagem que não possam ser resolvidos no momento.
Se você alterar a opção paraCompleta, a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado; os tipos complexos com uma Composição de Opção ou Mensagem que não podem ser resolvidos no momento causam a falha da validação.
Se quiser Utilizar o Analisador Compacto XMLNSC para Domínio XMLNS, selecione a caixa de opções.
Para Modo de Retenção de Conteúdo Misto, Modo de Retenção de Comentários e Modo de Retenção de Instruções de Processamento, as caixas drop-down oferecem as seguintes opções:
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
Para cada mensagem recebida com sucesso, o nó JMSInput roteia a mensagem para o terminal de saída. Se isso falhar, a mensagem será repetida. Se o limite de nova tentativa for atingido, sendo que o limite é definido pelo atributo BackoutThreshold do nó, a mensagem é roteada para o terminal de falha.
Você pode conectar nós ao terminal de falha para manipular essa condição. Se você não tiver conectado nós ao terminal de falha, a mensagem será gravada no destino de backout. Se não tiver sido fornecido um destino de backout, será emitida uma mensagem de erro e o nó parará o processamento de entrada adicional. A mensagem de erro é bip4669.
Se a mensagem for capturada pelo nó JMSInput após a emissão de uma exceção em outro lugar no fluxo de mensagens, a mensagem será roteada para o terminal de captura. Se você não tiver conectado os nós ao terminal de captura, o nó efetuará backout da mensagem para uma nova entrega até que o problema seja resolvido ou o limite de backout seja alcançado.
É necessário definir um destino de backout. Se não for definido um destino de backout, o nó emitirá uma mensagem de erro bip4669 e parará o processamento de entrada adicional.
Quando incluir um nó JMSInput em um fluxo de mensagens, o valor configurado para o Modo de Transação define se as mensagens serão recebidas sob o ponto de sincronização.
O provedor JMS pode fornecer arquivos jar adicionais requeridos para suporte transacional. Consulte a documentação do provedor JMS. Por exemplo, em plataformas Distribuídas (não-z/OS), o provedor JMS do WebSphere MQ fornece um arquivo jar extra com.ibm,mqetclient.jar . Esse jar também deve ser incluído no diretório shared_classes do intermediário. Consulte Disponibilizando o Cliente do Provedor JMS para os Nós JMS neste tópico.
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:
Name é 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.
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
XA não pode utilizar o mesmo gerenciador de filas para o intermediário e o provedor até o WebSphere MQ Versão 5.3, CSD12 e WebSphere MQ Versão 6 FixPack 1.
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 .
Os terminais do nó JMSInput são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Defeito | O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. Mesmo que a propriedade Validação 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. |
Capturar | 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 (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ó JMSInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Depósito de Informações do Provedor de Contexto Inicial | Sim | com.sun.jndi.fscontext.RefFSContextFactory | Esse é o ponto de partida de um espaço de nomes de 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. O valor padrão é o utilizado quando o WebSphere MQ Java é utilizado como o provedor JMS. |
|
Ligações JNDI de Local | Sim | O caminho do sistema ou local LDAP para o arquivo de ligações | ||
Nome da Connection Factory | Sim | O nome da connection factory utilizada pelo nó JMSInput para criar uma conexão com o provedor JMS. | ||
Destino de Backout | Não | O destino utilizado pelo nó JMSInput quando uma mensagem não pode ser processada pelo fluxo de mensagens devido a erros na mensagem. | ||
Limiar de Restauração | Não | 0 | O valor que controla quando uma mensagem entregue novamente é colocada no destino de backout. |
As propriedades Padrão do nó JMSInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Domínio de Mensagens | Não | Não | O domínio que será utilizado para analisar a mensagem que chega. | |
Conjunto de Mensagens | Não | Não | O nome ou identificador do conjunto de mensagens no qual a mensagem que chega está definida. | |
Tipo de Mensagem | Não | Não | O nome da mensagem que chega. | |
Formato de Mensagem | Não | Não | O nome do formato físico da mensagem que chega. |
As propriedades de Publicação/Assinatura do nó JMSInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Tópico de Assinatura | Não | Não | O nome do tópico no qual o nó efetuou assinatura. | |
ID de Assinatura Durável | Não | Não | O identificador de um tópico de assinatura durável. |
As propriedades Ponto a Ponto do nó JMSInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Fila de Origem | O nome da fila a partir da qual o nó recupera mensagens que chegam. |
As propriedades de Seletores de Mensagens do nó JMSInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Propriedade do Aplicativo | Não | Seletor de mensagens que irá filtrar mensagens de acordo com o valor da propriedade do aplicativo. | ||
Data e Hora | Não | Seletor de mensagens que irá filtrar de acordo com o JMSTimestamp. | ||
Modo de Entrega | Não | Seletor de mensagens que irá filtrar mensagens de acordo com o modo de entrega de mensagens. | ||
Prioridade | Não | Seletor de mensagens que irá filtrar mensagens de acordo com a prioridade de mensagem. | ||
ID da Mensagem | Não | Seletor de mensagens que irá filtrar mensagens de acordo com o ID de mensagem. | ||
ID de Correlação | Não | Seletor de mensagens que irá filtrar mensagens de acordo com o ID de correlação. |
As propriedades Avançadas do nó JMSInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Modo de Transação | Sim | Não | nenhum | Essa propriedade é utilizada para determinar se a mensagem que chega é recebida sob o ponto de sincronização externo, o ponto de sincronização local ou fora do ponto de sincronização. Os valores válidos são nenhum, local e global. |
As propriedades de Validação do nó JMSInput são descritas na tabela a seguir.
Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa dessas propriedades.Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validate | Sim | Sim | Nenhum | Essa propriedade determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Conteúdo e Valor. |
Ação de Defeito | Sim | Não | Exceção | Essa propriedade determina 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 das Opções de Mensagens Gerais do nó JMSInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Sincronização de Análise | Sim | Não | On Demand | Esta propriedade controla quando uma mensagem de entrada é analisada.
Os valores
válidos são On
Demand,
Imediato e
Completo. Consulte Analisando On Demand para obter uma descrição completa dessa propriedade. |
As propriedades das Opções do Analisador XMLNSC do nó JMSInput estão descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS | Sim | Não selecionada | Não | ![]() ![]() |
Modo de Retenção de Conteúdo Misto | Sim | Não | Nenhum | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Os valores válidos são Nenhum e Todos. A seleção de Todos significa que os elementos são criados para o texto misto. A seleção de Nenhum significa que o texto misto é ignorado e nenhum elemento é criado. |
Modo de Retenção de Comentários | Sim | Não | Nenhum | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Os valores válidos são Nenhum e Todos. Selecionar Tudo significa que são criados elementos para comentários. A seleção de Nenhum significa que os comentários são ignorados e nenhum elemento é criado. |
Modo de Retenção de Instruções de Processamento | Sim | Não | Nenhum | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Os valores válidos são Nenhum e Todos. Selecionar Tudo significa que são criados elementos para instruções de processamento. A seleção de Nenhum significa que as instruções de processamento são ignoradas e nenhum elemento é criado. |
As propriedades de Descrição do nó JMSInput estã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. |