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 Java™ Message Service Specification, 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 WebSphere Message Broker Toolkit pelo seguinte ícone:
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.
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.
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.
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.
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 de falha. Você pode conectar nós ao terminal de falha para manipular essa condição.
Se uma exceção ocorrer no caminho de falha e a mensagem for transacional, o caminho será tentado novamente até que o número de tentativas seja duas vezes o Limite de Restauração. Se esse limite for excedido, a mensagem será roteada para o Destino de Restauração. Se uma exceção ocorrer no caminho de falha e a mensagem não for transacional, a mensagem será roteada diretamente para o Destino de Restauração. Se você não tiver conectado nós ao terminal de Falha, a mensagem será roteada diretamente para o Destino de Restauração. Se você não definir um Destino de Restauração, a mensagem será retrocedida.
Se o processamento não continuar após a reinicialização do broker ou do grupo de execução, verifique o Log de Implementação para descobrir uma causa, como um analisador incorreto especificado nas propriedades do nó. Corrija o problema e reimplemente o fluxo de mensagens. Se a mensagem em si não for válida, remova a mensagem da fila de entrada para retomar o processamento.
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 de Captura, o nó restaurará mensagens transacionais para nova entrega, até que o problema seja resolvido, ou o Limite de Restauração seja atingido. Se o limite for atingido, a mensagem será roteada para o Destino de Restauração. Se você não tiver conectado nós ao terminal de Captura e a mensagem não for transacional, ela será roteada diretamente para o Destino de Restauração. Se você não definir um Destino de Restauração, a mensagem será retrocedida.
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. Consulte o Configurando para Transações JMS Coordenadas.
É possível configurar o nó JMSInput para enviar um reconhecimento em lote para recebimento de mensagens JMS não transacionais. Consulte Configurando o Nó JMSInput para Processamento de Mensagens em Lote.
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. Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco.
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 (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 | A | O padrão | Descrição |
---|---|---|---|---|
Nome de nó | Não | Não | O tipo de nó, JMSInput | O nome do nó. |
Descrição curta | 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 | A | O padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Fila de origem | Não | Sim | Selecionado | O nome da fila a partir da qual o nó recupera mensagens que chegam. Se o nó tiver que ser lido a partir de uma fila (ponto a ponto), selecione Fila de Origem e digite o nome da fila de origem, que é a fila JMS listada no arquivo de ligações. Essa propriedade é mutuamente exclusiva com tópico Assinatura. | sourceQueueName |
Tópico de assinatura | Não | Sim | Não selecionada | O nome do tópico no qual o nó efetuou assinatura.
Se o nó tiver que ler um Tópico de Assinatura (Publicação/Assinatura), selecione Tópico de Assinatura e digite o nome do tópico de assinatura.
|
tópico |
ID de assinatura durável | Não | Sim | O identificador de um tópico de assinatura durável.
Se o nó tiver que receber publicações de um tópico de assinatura durável, digite um ID de Assinatura Durável.
|
durableSubscriptionID |
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 selecionar um nome na lista, a propriedade Factory de Contexto Inicial será atualizada automaticamente com a classe Java relevante. Se você digitar seu próprio nome de provedor JMS, também deverá digitar um valor para a Fábrica de Contexto Inicial. O nome deve corresponder ao nome de um serviço configurável que é definido para o broker para o qual você implementa o fluxo de mensagens. Alternativamente, é possível especificar o serviço configurável JMSProviders. | |
Fábrica de contexto inicial | Não | Sim | com.sun.jndi.fscontext. RefFSContextFactory | O ponto inicial para 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, deverá digitar também um valor para Gerador de Contexto Inicial. 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. Se o nó for configurado para utilizar seu próprio Provedor JMS e a Propriedade de serviços configuráveis correspondentes da definição mqsichangeproperties tiver o conjunto de atributos InitialContextFactory, isso substituirá a configuração no nó. |
initialContextFactory |
Ligações JNDI do 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 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. 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, esse atributo substituirá a configuração no nó. |
locationJndiBindings | |
Nome de fábrica da conexão | Não | Sim | O nome da connection utilizada pelo nó JMSInput para criar uma conexão com o provedor JMS. Este nome deve existir no arquivo de ligações. O Nome do Gerador de Conexão pode ser um JMS QueueConnectionFactory ou um JMS TopicConnectionFactory, mas ele deve corresponder ao modelo de mensagens que é utilizado pelo nó. Também é possível especificar o ConnectionFactory JMS genérico, que pode ser usado para destinos de fila JMS ou de tópico JMS. | connectionFactoryName | |
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. | backoutDestination | |
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. Consulte o Configurando a Propriedade de Limite de Restauração. |
As propriedades Análise de Mensagem de Entrada do nó JMSInput são descritas na tabela a seguir.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Domínio de mensagem | Não | Não | BLOB | O domínio usado para analisar a mensagem. Se o campo estiver em branco, o padrão será BLOB. |
Modelo de mensagem | Não | Não | Desmarcada | O nome do local do arquivo de esquema do modelo de mensagem no qual a mensagem é definida. Essa lista é preenchida com todos os arquivos de esquema de modelo de mensagem disponível para o domínio de mensagem selecionado. |
Message | Não | Não | Desmarcada | O nome ou local da raiz de mensagem em seu arquivo de esquema de modelo de mensagem. Essa lista é preenchida com todas as mensagens disponíveis definidas no modelo de mensagem que você selecionou. |
Formato físico | Não | Não | Desmarcada | O nome do formato físico da mensagem. Se estiver utilizando o analisador MRM ou IDOC, selecione da lista o formato físico da mensagem que chega. Essa lista inclui todos os formatos físicos que você definiu para o modelo de mensagem selecionado. Se você configurar a propriedade Domínio de Mensagem como DataObject, poderá configurar esta propriedade como XML ou SAP ALE IDoc. Configure esta propriedade como SAP ALE IDoc quando precisar analisar um fluxo de bits a partir de uma origem externa e gere uma árvore de mensagens. |
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Cronometragem de análise (Parse timing) | Não | Não | On Demand | Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores válidos são:
Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas. Para que a mensagem seja analisa imediatamente, consulte Analisando On Demand. |
Construir árvore utilizando tipos de dados de esquema XML | Não | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC
cria elementos da sintaxe na árvore de mensagens com tipos de dados obtidos
do esquema XML. Para obter informações adicionais sobre como o analisador XMLNSC opera, consulte Manipulando Mensagens no Domínio XMLNSC. |
Utilizar analisador compacto XMLNSC para domínio XMLNS | Não | Não | Não selecionada | Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você definir essa propriedade, os dados da mensagem serão exibidos em XMLNSC nos nós que estão conectados ao terminal de saída quando o Domínio de Mensagens das propriedades do cabeçalho MQRFH2 ou da Análise da Mensagem for XMLNS. |
Reter conteúdo misto | Não | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado. |
Reter comentários | Não | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado. |
Reter instruções de processamento | Não | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado. |
Elementos opacos | Não | Não | Em branco | Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano pelo analisador XMLNSC. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada. |
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Propriedade do aplicativo | Não | Não | O seletor de mensagem que filtra mensagens de acordo com o valor da
propriedade do aplicativo. Se o provedor JMS tiver que filtrar mensagens com base nas propriedades da mensagem configuradas pelo aplicativo cliente JMS original, insira uma sequência de seletores para Propriedade do Aplicativo, especificando o nome da propriedade e as condições de seleção, por exemplo, OrderValue > 200. Deixe a Propriedade do Aplicativo em branco se você não desejar que o nó de entrada faça uma seleção com base na propriedade do aplicativo. |
|
Registro de Data e Hora | Não | Não | O seletor de mensagem que filtra mensagens de acordo com o
JMSTimestamp. Se o provedor JMS tiver que filtrar mensagens que foram geradas em horários específicos, insira uma sequência de seletores para Registro de data e hora, em que o valor é um horário Java em milissegundos não qualificado; por exemplo, 105757642321. Qualifique o seletor com operadores, como =, BETWEEN ou AND. Deixe o Registro de Data e Hora em branco de você não desejar que o nó de entrada faça uma seleção com base no JMSTimeStamp. |
|
Modo de entrega | Não | Não | Todos | O seletor de mensagem que filtra as mensagens de acordo com o modo
de entrega da mensagem. Se o provedor de JMS tiver que filtrar mensagens com base no valor de cabeçalho do JMSDeliveryMode nas mensagens JMS, selecione uma opção para Modo Entrega a partir da lista:
|
Prioridade | Não | Não | O seletor de mensagem que filtra as mensagens de acordo com a
prioridade da mensagem. Se o provedor JMS tiver que filtrar mensagens com base no valor do cabeçalho JMSPriority na mensagem JMS, insira uma sequência de seletores para Prioridade. Os valores válidos para Prioridade vão de 0 (o mais baixo) a 9 (o mais alto). Por exemplo, insira = 5 para receber mensagens de prioridade 5, > 4 para receber mensagens com uma prioridade maior que 4, ou BETWEEN 4 AND 8 para receber mensagens com uma prioridade no intervalo 4 - 8. Deixe Prioridade em branco se você não desejar que o nó de entrada faça uma seleção baseada em JMSPriority. |
|
ID da Mensagem | Não | Não | O seletor de mensagem que filtra as mensagens de acordo com o ID de
mensagem. Se o provedor JMS tiver que filtrar mensagens com base no cabeçalho JMSMessageID, insira uma sequência de seletores para ID de Mensagem. Por exemplo, insira > WMBRK123456 para retornar mensagens em que o ID de Mensagem seja maior que WMBRK123456. Deixe ID de Mensagem em branco se você não quiser que o nó de entrada faça uma seleção com base em JMSMessageID. |
|
Entregue Novamente | Não | Não | Se o provedor JMS tiver que filtrar mensagens
com base no cabeçalho JMSRedelivered, insira uma sequência de seletores para Reentregue:
|
|
ID de Correlação | Não | Não | O seletor de mensagem que filtra as mensagens de acordo com o ID de
correlação. Se o provedor JMS tiver que filtrar mensagens com base no cabeçalho JMSCorrelationID, insira uma sequência de seletores para ID de Correlação. Por exemplo, = WMBRKABCDEFG retorna mensagens com um ID de Correlação que corresponde a este valor. Deixe ID de Correlação em branco se você não quiser que o nó de entrada faça uma seleção com base em JMSCorrelationID. |
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
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.
|
Propriedade | M | A | O padrão | Descrição | Propriedade do Comando mqsiapplybaroverride |
---|---|---|---|---|---|
Validate | Não | Sim | Nenhuma | Essa propriedade controla se a validação ocorre. Os valores válidos são:
Se você selecionarConteúdo ou Conteúdo e Valor, selecione uma opção na lista Ação de Falha. |
validateMaster |
Ação de falha | 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:
|
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. |