Nó JMSInput

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

Finalidade

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:

Ícone do nó JMSInput

Utilizando o Nó JMSInput em um Fluxo de Mensagens

A amostra Amostra JMS Nodes contém um fluxo de mensagens no qual o nó JMSInput é utilizado. Consulte essa amostra para obter um exemplo de como utilizar o nó JMSInput.

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:

  • BLOB
  • XML
  • XMLNS
  • XMLNSC
  • MRM
  • JMSMap
  • JMSStream
  • MIME
  • IDOC

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.

Restrição: Atualmente, há uma restrição para utilização do nó JMSInput para receber tópicos de publicação. O nó restringe internamente a propriedade Instâncias Adicionais do fluxo de mensagens para zero para evitar o recebimento de publicações duplicadas.

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

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.

Configurando o Nó JMSInput

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:

  1. Selecione Básico no navegador do diálogo de propriedades e preencha as seguintes propriedades:
    • Digite um valor de Depósito de Informações do Provedor de Contexto Inicial. 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 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.

    • Digite um valor para as Ligações de JNDI de Local. Esse valor especifica o caminho do sistema de arquivos ou o local do LDAP para o arquivo de ligações. O arquivo de ligações contém definições para os objetos administrados de JNDI utilizados pelo nó JMSInput.

      Ao digitar um valor para Ligações de JNDI de Local, assegure que 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ó JMSInput.
      • Não inclua o nome do arquivo do arquivo de ligações neste campo.
      • Se você tiver especificado um local do LDAP que requeira autenticação, será necessário configurar separadamente o proprietário LDAP (ID do usuário) e credenciais LDAP (senha). Estes valores são configurados no nível do intermediário. Para obter informações sobre como configurar estes valores, consulte os comandos mqsicreatebroker e mqsichangebroker.
      • O valor da cadeia deve incluir a palavra-chave inicial, que é uma das seguintes: file:/, iiop:/ ou ldap:/.

      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.

    • Digite um Nome de Connection Factory. O nome da connection factory é utilizado pelo nó JMSInput para criar uma conexão com o provedor JMS. Esse nome já deve existir no arquivo de ligações.
    • Digite um nome do Destino de Backout. As mensagens de entrada são enviadas a esse destino quando erros impedem que o fluxo de mensagens processe 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.
    • Digite um valor para o Limite de Backout. Esse valor determina quando uma mensagem de entrada é colocada no Destino de Backout. Por exemplo, se o valor for 3, o provedor JMS tentará entregar a mensagem no destino de entrada três vezes. Após a terceira tentativa de entrega, a mensagem será removida do destino de entrada e enviada para o destino de backout. O valor padrão é 0.
  2. Selecione Padrão no navegador do diálogo de propriedades e configure valores para as propriedades que descrevem o domínio de mensagem, o conjunto de mensagens, o tipo de mensagem e o formato da mensagem.
    • No Domínio da Mensagem, selecione o nome do analisador que você está utilizando a partir da lista drop-down. Você pode escolher um dos seguintes nomes:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMSMap
      • JMSStream
      • MIME
      • BLOB
      • IDOC
      Se Domínio de Mensagem for deixado em branco, o nó JMSInput determinará o domínio de uma entre duas maneiras:
      • verificando a presença de dados no valor do cabeçalho JMSType da mensagem de entrada JMS.
      • com base na Classe Java da mensagem JMS.
      Para obter informações sobre a ordem de prioridade para determinação do domínio de mensagem, consulte Ordem de Precedência para Derivar o Domínio de Mensagem.
    • Se estiver utilizando o analisador MRM ou IDOC, selecione o conjunto de mensagens correto da lista drop-down em Conjunto de Mensagens. Essa lista é preenchida por conjuntos de mensagens disponíveis quando você seleciona MRM ou IDOC como domínio.

      Deixe a opçãoConjunto de Mensagens em branco para os analisadores XML, XMLNS, XMLNSC, JMS, MIME e BLOB.

    • Se estiver utilizando o analisador MRM, selecione a mensagem correta na lista suspensa em Tipo de Mensagem. Esta lista é ocupada com mensagens que estão definidas no conjunto de mensagens que você selecionou.

      Deixe a opção Tipo de Mensagem em branco para analisadores XML, XMLNS, XMLNSC, JMS, MIME, BLOB e IDOC.

    • Se estiver utilizando o analisador MRM ou IDOC, selecione o formato da mensagem da lista drop-down em Formato da Mensagem. Essa lista inclui todos os formatos físicos definidos para este conjunto de mensagens.

      Deixe Formato da Mensagem em branco para os analisadores XML, XMLNS, XMLNSC, JMSMap, JMSStream, MIME e BLOB.

  3. Se o nó JMSInput tiver que ser utilizado para efetuar assinatura em um tópico, selecione Publicação/Assinatura no navegador do diálogo de propriedades.
    • Digite o nome do Tópico de Assinatura.
      • Se essa propriedade estiver configurada, o nó operará apenas no domínio de mensagem de publicação/assinatura.
      • Essa propriedade é mutuamente excludente com Fila de Origem na seção de propriedades Ponto a Ponto.
      • O nome do Tópico de Assinatura deve estar de acordo com os padrões do provedor JMS que está sendo utilizado pelo nó.

    • Se o nó tiver que receber publicações de um tópico de assinatura durável, digite um ID de Assinatura Durável.
      • A remoção de uma assinatura durável é uma tarefa de administração separada. Para obter informações sobre como remover uma assinatura durável, consulte a documentação do provedor JMS.
      • Essa propriedade é válida somente quando uma cadeia Tópico de Assinatura tiver sido especificada.
  4. Se o nó JMSInput tiver que ser utilizado para receber mensagens ponto a ponto, selecione Ponto a Ponto no navegador do diálogo de propriedades.
    • Digite o nome da Fila de Origem, em que a Fila de Origem é a fila JMS listada no arquivo de ligações.
  5. Se a filtragem de mensagens for requerida, selecione Seletores de Mensagens no navegador do diálogo de propriedades.
    • Se o provedor JMS for requerido para filtrar mensagens com base em propriedades de mensagem configuradas pelo aplicativo cliente JMS de origem, digite um valor de Propriedade de Aplicativo, para especificar o nome da propriedade e as condições de seleção; por exemplo, OrderValue > 200.

      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.

    • Se o provedor JMS for requerido para filtrar mensagens que foram geradas em momentos específicos, digite um valor para Time Stamp, em que o valor é um tempo em milissegundos Java não qualificado; por exemplo, 105757642321. Qualifique o seletor com operadores, como BETWEEN ou AND.

      Deixe esta propriedade em branco se não desejar que o nó input selecione com base em JMSTimeStamp.

    • Se o provedor JMS for requerido para filtrar mensagens com base no valor de cabeçalho JMSDeliveryMode nas mensagens JMS, selecione uma opção para Modo de Entrega da lista drop-down. Você pode escolher entre:
      • Não Persistente para receber mensagens marcadas como não persistentes pelo aplicativo cliente JMS de origem. Essa é a opção padrão.
      • Persistente para receber mensagens marcadas como persistentes pelo aplicativo cliente JMS de origem.
    • Se o provedor JMS for requerido para filtrar mensagens com base no valor de cabeçalho JMSPriority na mensagem JMS, digite um valor para Prioridade.

      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.

    • Se o provedor JMS for requerido para filtrar mensagens com base no cabeçalho JMSMessageID, digite um valor para ID de Mensagem.

      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.

    • Se o provedor JMS for requerido para filtrar mensagens com base no cabeçalho JMSRedelivered, digite um valor para Entregue Novamente.

      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.

    • Se o provedor JMS for requerido para filtrar mensagens com base no cabeçalho JMSCorrelationID, digite um valor para ID de Correlação.

      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.

  6. Selecione Avançado no navegador do diálogo de propriedades.
    • Para definir as características transacionais de como a mensagem é manipulada, selecione na lista drop-down Modo de Transação. Você pode escolher uma das seguintes opções:
      • Selecione nenhum se a mensagem de entrada for ser tratada como não persistente. Se você selecionar esse valor, a mensagem será recebida utilizando uma Sessão JMS não transacionada que é criada através do sinalizador Session.AUTO_ACKNOWLEDGE.
      • Selecione local se o nó JMSInput for coordenar a confirmação ou o rollback das mensagens JMS recebidas pelo nó, juntamente com quaisquer outros recursos, como DB2 ou WebSphere MQ, que executam trabalho no fluxo de mensagens. Se você selecionar esse valor, o nó utilizará uma Sessão JMS transacionada.
      • Selecione global se o nó JMSInput for participar de uma transação de fluxo de mensagens global que será gerenciada pelo coordenador do ponto de sincronização externo do intermediário. O coordenador de ponto de sincronização é o gerenciador de filas do intermediário em plataformas distribuídas e no RRS (Resource Recovery Services) no z/OS. Se você selecionar esse valor, todas as mensagens recebidas pelo nó serão coordenadas globalmente utilizando uma Sessão JMS XA.
  7. Selecione Validação no navegador do diálogo de propriedades para configurar as propriedades do nó relacionadas à validação da mensagem de entrada.
    • Selecione uma opção na lista drop-down Validar. As opções disponíveis são:
      • Nenhum(a)
      • Conteúdo e Valor
      • Conteúdo
      Se você selecionar Conteúdo ou Conteúdo e Valor, selecione uma opção na lista drop-down Ação com Falha. As opções disponíveis são:
      • Rastreio do Usuário
      • Registro de Erros Local
      • Exceção (valor padrão)
      • Lista de Exceções

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

  8. Selecione Opcionais Gerais de Mensagem no navegador do diálogo de propriedades. O valor padrão para Cronometragem de Análise é configurado para On Demand. Isso causa o retardo da validação até que a mensagem seja analisada pela análise parcial.

    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.

  9. Selecione Opções do Analisador XMLNSC no navegador do diálogo de propriedades.

    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:

    • Nenhum(a)
    • Todas
  10. Selecione Descrição no navegador do diálogo de propriedades para digitar uma descrição resumida, uma descrição longa ou ambas.
  11. Clique em Aplicar para fazer as alterações no nó JMSInput 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

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.

Configurando para Transações Coordenadas

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.

  • Se defini-la para global, a mensagem será recebida sob a coordenação do ponto de sincronização externo, ou seja, em uma unidade de trabalho do WebSphere MQ. As mensagens enviadas subseqüentemente por um nó output na mesma instância do fluxo de mensagens são colocadas sob o ponto de sincronização, a menos que o nó output tenha feito a substituição explicitamente.
  • Se defini-la para local, a mensagem será recebida sob o controle do ponto de sincronização local do nó JMSInput. As mensagens enviadas subseqüentemente por um nó de saída no fluxo não serão colocadas sob o ponto de sincronização local, a menos que o nó de saída tenha especificado que a mensagem deve ser colocada sob o ponto de sincronização local.
  • Se você defini-la para nenhum, a mensagem não será recebida sob o ponto de sincronização. As mensagens enviadas subseqüentemente por um nó de saída no fluxo não são colocadas sob o ponto de sincronização, a menos que o nó de saída tenha especificado que a mensagem deve ser colocada 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.

Quando as mensagens forem recebidas sob o ponto de sincronização externo, etapas de configuração adicionais serão requeridas. Estas etapas precisam ser aplicadas apenas na primeira vez que um JMSOutput ou JMSInput for implementado no Intermediário para um provedor JMS específico:
  • Em plataformas distribuídas, o coordenador do ponto de sincronização externo para o intermediário é o WebSphere MQ. Antes de implementar um fluxo de mensagens no qual a Coordenação de Transação está configurada como Global, modifique o arquivo .ini do gerenciador de filas para incluir definições extras para cada Gerenciador de Recursos do provedor JMS que participa de transações coordenadas globalmente.
    • No Windows, se você tiver o WebSphere MQ Versão 5 instalado, inicie o WebSphere MQ Services e clique com o botão direito do mouse no nome do gerenciador de filas. Selecione Propriedades e clique na guia de propriedades do Recurso. Caso tenha o WebSphere MQ Versão 6 instalado, inicie o WebSphere MQ Explorer e clique com o botão direito do mouse no nome do gerenciador de filas na área de janela esquerda. Selecione Propriedades e selecione Gerenciadores de Recurso XA na área de janela esquerda. Consulte o Guia de Administração do Sistema do WebSphere MQ para obter informações adicionais.
      Configure a propriedade SwitchFile para o seguinte valor:
      install_dir/bin/ JMSSwitch.dll
      XAOpenString=Initial Context,location JNDI,Optional_parms
      ThreadOfControl=THREAD
    • Em plataformas Linux e UNIX, inclua uma sub-rotina no arquivo ini do gerenciador de filas para cada provedor JMS. Consulte o WebSphere MQ Guia de Administração do Sistema para obter informações adicionais.
      Por exemplo:
      XAResourceManager:
      Name=Jms_Provider_Name
      SwitchFile=/install_dir/bin/ JMSSwitch.so
      XAOpenString=Initial Context,location JNDI,Optional_parms
      ThreadOfControl=THREAD
      Em 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 valores para XAOpenString são os seguintes:
      • Initial Context é o valor configurado na propriedade básica Depósito de Informações do Provedor de Contexto Inicial do nó JMSInput.
      • location JNDI é o valor configurado na propriedade básica Local de JNDI do nó JMSInput. Esse valor deve incluir a palavra-chave inicial file:/, iiop:/ ou ldap:/
      Os parâmetros a seguir são opcionais:
      • Proprietário LDAP que corresponde o valor configurado para o intermediário, utilizando os comandos mqsicreatebroker ou mqsichangebroker.
      • Credenciais LDAP que corresponde o valor configurado para o intermediário, utilizando os comandos mqsicreatebroker ou mqsichangebroker.
      • Nome da Connection Factory de Recuperação que é a connection factory administrada por JNDI definida 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 qualquer um dos casos, a Connection Factory de Recuperação deverá ser definida como uma Connection Factory de Fila XA para o provedor JMS associado ao Depósito de Informações do Provedor de Contexto Inicial.

      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.

      1. Atualize a variável de ambiente Java CLASSPATH para que o gerenciador de filas do intermediário inclua uma referência ao xarecovery.jar. Por exemplo:
        install_dir/classes/xarecovery.jar
      2. Atualize a variável de ambiente Java PATH para que o gerenciador de filas do intermediário aponte para o diretório bin, onde o Arquivo Switch está localizado. Exemplo:
        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.

    • No z/OS, o gerenciador do ponto de sincronização externo é RRS (Resource Recovery Services). O único provedor JMS suportado no z/OS é o WebSphere MQ JMS. A única opção Transporte suportada no 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 intermediário. Não é necessário modificar o arquivo .ini .

Terminais e Propriedades

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 Início da mudançaEssa propriedade fornece a você o controle de se o Analisador Compacto XMLNSC é utilizado para mensagens no Domínio XMLNS. Observe que se você configurar essa propriedade, os dados de mensagens aparecerão sob XMLNSC em nós conectados ao terminal de saída quando o cabeçalho RFH2 de entrada ou o Domínio das propriedades padrão for XMLNS.Fim da mudança
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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac24820_