MQeInput

Utilize o nó MQeInput para receber mensagens dos clientes que se conectam ao intermediário utilizando o protocolo WebSphere MQ Mobile Transport.

Atenção: A utilização de fluxos de mensagens que contêm os nós MQeInput e MQeOutput na Versão 6.0 é obsoleta. O comportamento descrito aqui é direcionado somente para quando você estiver implementando da Versão 6.0 para uma versão anterior e para fornecer uma rota para migração. Projete novamente seus fluxos para remover os nós do MQe e substituí-los por nós do MQ que estão configurados para suas próprias especificações e coordenados com a configuração de gateway do MQe. Para obter mais detalhes, consulte Migrando um Fluxo de Mensagens que Contém Nós do WebSphere MQ Everyplace.

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

Propósito

O nó MQeInput recebe mensagens que são colocadas em um fluxo de mensagem a partir de uma fila de pontes especificada no gerenciador de filas WebSphere MQ Everyplace do intermediário. O nó também estabelece o ambiente de processamento para as mensagens. Você deve criar e configurar o gerenciador de filas do WebSphere MQ Everyplace antes de implementar um fluxo de mensagens que contém esse nó.

Os fluxos de mensagens que manipulam as mensagens recebidas entre conexões do WebSphere MQ devem sempre ser iniciados com um nó MQeInput. Você pode definir as propriedades do nó MQeInput para controlar a forma na qual as mensagens são recebidas; por exemplo, é possível indicar que uma mensagem deva ser processada sob o controle da transação.

Quando implementar fluxos de mensagens que contêm nós do WebSphere MQ Everyplace em um intermediário, será necessário implementá-los em um único grupo de execução, independentemente do número de fluxos de mensagens. Todos os nós do WebSphere MQ Everyplace nos fluxos de mensagens devem especificar o mesmo nome do gerenciador de filas do WebSphere MQ Everyplace. Se você não atender a essa restrição, um erro ocorrerá durante a implementação.

  • MRM
  • XML
  • XMLNS
  • JMSMap
  • JMSStream
  • BLOB

Se você incluir um nó de saída em um fluxo de mensagens que comece com um nó MQeInput, ele poderá ser qualquer um dos nós de saída suportados, incluindo os nós de saída definidos pelo usuário; não é necessário incluir um nó MQeOutput. Você pode criar um fluxo de mensagens que recebe mensagens de clientes do WebSphere MQ Everyplace e gera mensagens para clientes que utilizam qualquer um dos transportes suportados para conexão com o intermediário, porque você pode configurar o fluxo de mensagens para solicitar que o intermediário forneça qualquer conversão necessária.

O WebSphere MQ Everyplace Versão 1.2.6 é utilizado pelo WebSphere Event Broker. Esta versão é compatível com versões posteriores do WebSphere MQ Everyplace. Os clientes que utilizam versões mais recentes do WebSphere MQ Everyplace (por exemplo, a Versão 2.0) funcionam corretamente quando conectados a esse nó, embora a funcionalidade adicional não suportada na Versão 1.2.6 (por exemplo, o suporte JMS) não funcione.

Os gerenciadores de filas não são intercambiáveis entre versões diferentes do WebSphere MQ Everyplace. Os nós devem utilizar um gerenciador de filas criado utilizando a Versão 1.2.6. De modo semelhante, o cliente deve utilizar seu próprio nível do código ao criar um gerenciador de filas.

z/OS platform Você não pode utilizar os nós MQeInput nos fluxos de mensagens que você implementa nos sistemas z/OS.

Se você criar um fluxo de mensagens para utilizar como um subfluxo, não poderá utilizar um nó de entrada padrão; é necessário utilizar uma instância do nó Entrada como o primeiro nó para criar um terminal In para o subfluxo.

Se seu fluxo de mensagens não receber mensagens em conexões do WebSphere MQ, você poderá escolher outro nó de entrada suportado.

O nó MQeInput está contido no repositório da paleta do WebSphere MQ e é representado no ambiente de trabalho pelo seguinte ícone:

Ícone do nó MQeInput

Utilizando o Nó MQeInput em um Fluxo de Mensagens

Para obter um exemplo de como este nó pode ser utilizado, considere um fazendeiro que verifica seus campos para saber se estão sendo bem irrigados. Ele leva um dispositivo PDA com o WebSphere MQ Everyplace instalado. Ele vê uma área do campo que exige irrigação e utiliza seu PDA e um link da Global Satellite Navigation para enviar uma mensagem para o nó MQeInput. A é publicada por um nó Publicação para que um dispositivo SCADA remoto possa escolher a mensagem e acionar os irrigadores. O fazendeiro pode ver a área seca sendo irrigada alguns minutos após o envio da mensagem.

Documentação do WebSphere MQ Everyplace

Encontre informações adicionais sobre o WebSphere MQ Everyplace, e as propriedades do nó, na documentação do WebSphere MQ Everyplace na WebSphere MQ.

Configurando o Nó MQeInput

Quando tiver colocado uma instância do nó MQeInput 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 para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

Configure o nó MQeInput da seguinte forma:

  1. Opcional: Na guia Descrição , digite uma Descrição breve, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Geral, configure as seguinte propriedades:
    1. Insira o Nome da Fila da fila de pontes do WebSphere MQ Everyplace a partir da qual esse nó de entrada recupera mensagens. Se a fila não existir, ela será criada quando o fluxo de mensagens for implementado no intermediário.
    2. Defina o nível de Rastreio desejado para este nó. Se o rastreio estiver ativo, as informações de rastreio serão registradas no arquivo identificado pelo Nome do Arquivo de Rastreio (descrito posteriormente nesta seção). Escolha um nível de rastreio:
      • Nenhum (o padrão). Nenhuma saída de rastreio é produzida, a menos que ocorra um erro irrecuperável.
      • Padrão. A saída de rastreio mínima será gerada para refletir as operações gerais do nó.
      • Depuração. As informações de rastreio são gravadas em um nível que ajude na depuração dos programas WebSphere MQ Everyplace.
      • Completo. Todas as informações de depuração disponíveis são registradas para fornecer um registro completo das atividades do nó.

      Se você definir o nível de rastreio como Depurar ou Completo, haverá impacto no desempenho de WebSphere MQ Everyplace e podem ser gerados significativos arquivos de rastreio. Utilize essas opções apenas para curtos períodos.

    3. Em Nome do Arquivo de Rastreio, especifique o nome do arquivo no qual as informações de rastreio são gravadas. A estrutura de diretório na qual o arquivo é especificado já deve existir; ela não pode ser criada durante a operação.
    4. Selecione o Modo de Transação para definir as características transacionais de como essa mensagem é manipulada:
      • Se você selecionar Automático, a mensagem que chega será recebida no ponto de sincronização se estiver marcada como persistente; caso contrário não. A transacionalidade de todas as mensagens derivadas, enviadas subseqüentemente por um nó de saída, é determinada pela propriedade de persistência de entrada, a menos que o nó de saída tenha substituído explicitamente a transacionalidade.
      • Se você selecionar Sim, a mensagem que chega será recebida no ponto de sincronização. Todas as mensagens derivadas, enviadas subseqüentemente por um nó de saída na mesma instância do fluxo de mensagens, são enviadas de forma transacional, a menos que o nó de saída tenha substituído explicitamente a transacionalidade.
      • Se você selecionar Não, a mensagem que chega não será recebida no ponto de sincronização. Qualquer mensagem derivada que é enviada subseqüentemente por um nó de saída no fluxo de mensagens é enviada de maneira não-transacional, a menos que o nó de saída tenha especificado que a mensagem deve ser colocada no ponto de sincronização.
    5. A caixa de opção Utilizar Arquivo de Configuração não é selecionada por padrão; os valores para todas as propriedades do nó MQeInput são obtidas na visualização Propriedades.

      Se você selecionar a caixa de opção, a definição de todas as propriedades é extraída do arquivo que é identificado pelo Nome do Arquivo de Configuração (descrito posteriormente nesta seção) com a exceção das seguintes propriedades:

      • As propriedades gerais Nome da Fila e Nome do Arquivo de Configuração
      • Todas as propriedades Padrão (Default)
      Utilize um arquivo de configuração apenas para especificar as propriedades adicionais para o nó. Se as propriedades na visualização Propriedades forem suficientes para suas necessidades, não selecione a caixa de opção Utilizar Arquivo de Configuração.
    6. Se tiver selecionado a caixa de opção Utilizar Arquivo de Configuração, digite o caminho completo e o nome do arquivo de configuração para o WebSphere MQ Everyplace em Nome do Arquivo de Configuração. Esse arquivo deve ser instalado no sistema que suporta cada intermediário no qual este fluxo de mensagens é implementado. Se o arquivo não existir, será detectado um erro durante a implementação do fluxo de mensagens. O nome do arquivo padrão é MQeConfig.ini.
    7. Em Nome do gerenciador de Filas, especifique o nome do gerenciador de filas do WebSphere MQ Everyplace. Esse gerenciador de filas não está relacionado ao gerenciador de filas do intermediário no qual você implementa o fluxo de mensagens que contém esse nó.

      Apenas um gerenciador de filas do WebSphere MQ Everyplace pode ser suportado. Somente um grupo de execução pode conter os nós MQeInput ou MQeOutput. Essa propriedade deve, portanto, ser definida com o mesmo valor em cada nó MQeInput que é incluído em cada fluxo de mensagens que você implementa no mesmo intermediário.

  3. Na guia Canal, configure o número máximo de canais suportados pelo WebSphere MQ Everyplace em Número Máx. de Canais. O valor padrão é zero, o que significa que não há limite.
  4. Na guia Registro, configure as seguintes propriedades:
    1. Selecione o tipo de registro na lista Tipo de Registro:
      • FileRegistry. Informações de registro e de segurança são fornecidas no Diretório especificado posteriormente nesta seção.
      • PrivateRegistry. Crie o gerenciador de filas manualmente no WebSphere MQ Everyplace, especificando os parâmetros de segurança necessários.
    2. Em Diretório, especifique o diretório no qual o arquivo de registro está localizado. Essa propriedade é válida somente se você tiver selecionado Tipo de Registro igual a FileRegistry.
    3. Se você tiver selecionado um Tipo de Registro igual a PrivateRegistry, conclua as seguintes propriedades (para obter detalhes adicionais destas propriedades, consulte a documentação de WebSphere MQ Everyplace):
      • Especifique um PIN para o gerenciador de filas associado.
      • Especifique um PIN de Pedido de Certificado para pedidos de autenticação.
      • Forneça uma Senha de Conjunto de Chaves a ser utilizada como um valor inicial para a geração de chaves criptográficas.
      • Em Host do Certificado, especifique o nome do servidor de certificado que o WebSphere MQ Everyplace utiliza para autenticação.
      • Em Porta do Certificado, especifique o número da porta para o servidor de certificados que o WebSphere MQ Everyplace utiliza para autenticação.
  5. Na guia Listener, configure as seguintes propriedades que definem o tipo de conexão para o WebSphere MQ Everyplace:
    1. Em Tipo de Listener, selecione o tipo de adaptador a ser utilizado na lista. O valor padrão é Http; você também pode selecionar Comprimento (Length) ou Histórico (History). Para obter detalhes adicionais, consulte a documentação de WebSphere MQ Everyplace.
    2. Em Nome do Host, especifique o nome do host do servidor. Configure esta propriedade como o valor especial localhost ou como o endereço TCP/IP 127.0.0.1 (o valor padrão), ambos dos quais são resolvidos diretamente para o nome do host do servidor no qual o fluxo de mensagens é implementado. Você também pode utilizar qualquer nome de host ou endereço TCP/IP válido em sua rede, mas terá que utilizar um fluxo de mensagens diferente para cada intermediário no qual implementa o fluxo ou configura essa propriedade no momento da implementação.
    3. Em Porta, especifique o número da porta no qual o WebSphere MQ Everyplace está atendendo. Se mais de um nó MQeInput for incluído em um fluxo de mensagens que é implementado em um único intermediário, cada nó MQeInput deverá especificar um número diferente para essa propriedade. Também é necessário assegurar que o número especificado não entre em conflito com outros listeners no sistema do intermediário; por exemplo, com o WebSphere MQ. O valor padrão é 8081.
    4. Em Intervalo de Tempo, especifique o valor de tempo limite, em segundos, antes de esgotar o tempo limite dos canais inativos. O valor padrão é de 300 segundos.

      Canais são entidades lógicas persistentes que duram mais que um único pedido do gerenciador de filas e podem resistir a interrupções da rede, de forma que poderá ser necessário exceder o tempo limite dos canais que ficaram inativos por um período de tempo.

Conectando Terminais

O nó MQeInput roteia cada mensagem que é recuperada com sucesso para o terminal Out; se isso falhar, é feita uma nova tentativa com a mensagem. Se o tempo limite de repetição expirar (conforme definido pelo atributo BackoutThreshold da fila de entrada), a mensagem será roteada para o terminal de Failure; você poderá conectar nós a esse terminal para identificar essa condição. Se você não tiver conectado ao terminal Failure, a mensagem será gravada na fila de restauração.

Se a mensagem for capturada por esse nó após a emissão de uma exceção no fluxo de mensagens, a mensagem será roteada para o terminal de Catch. Se você não tiver conectado o terminal Catch, a mensagem entrará em loop contínuo através do nó, até que o problema seja resolvido. Você deve definir uma fila de restauração ou uma fila DLQ (dead-letter queue) para impedir o loop contínuo da mensagem através do nó.

Configurando para Transações Coordenadas

Quando você incluir um nó MQeInput em um fluxo de mensagens, o valor configurado para a propriedade Modo de Transação definirá se as mensagens são recebidas no ponto de sincronização:

  • Se você configurar a propriedade para Sim (o padrão), a mensagem será recebida no ponto de sincronização (ou seja, em uma unidade de trabalho do WebSphere MQ). Qualquer mensagem enviada subseqüentemente por um nó de saída na mesma instância do fluxo de mensagens será colocada no ponto de sincronização, a menos que o nó de saída tenha substituído isto explicitamente.
  • Se você configurar a propriedade para Automático, a mensagem será recebida no ponto de sincronização se a mensagem que chega for marcada como persistente. De outra maneira, ela não será. Qualquer mensagem enviada subseqüentemente por um nó de saída é colocada no ponto de sincronização, conforme determinado pela propriedade de persistência de entrada, a menos que o nó de saída tenha substituído isto explicitamente.
  • Se você configurar a propriedade para Não, a mensagem não será recebida no ponto de sincronização. Qualquer mensagem enviada subseqüentemente por um nó de saída no fluxo não será colocada no ponto de sincronização, a menos que um nó de saída individual tenha especificado que a mensagem deve ser colocada no ponto de sincronização.

O nó MQeOutput é o único nó de saída que pode ser configurado para substituir esta opção.

Terminais e Propriedades

Os terminais do nó MQeInput são descritos na tabela a seguir.

Terminal Descrição
Failure O terminal de saída para o qual a mensagem será roteada se ocorrer um erro.
Out O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila do WebSphere MQ Everyplace.
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 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).

As propriedades Descrição do nó MQeInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não MQeInput 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.

As propriedades Geral do nó MQeInput são descritas na seguinte tabela.

Propriedade M C Padrão Descrição
Nome da fila Sim Sim   O nome da fila ponte do WebSphere MQ Everyplace a partir do qual este nó recupera mensagens para processamento por este fluxo de mensagens.
Rastreio Sim Não Nenhuma O nível de rastreio requerido para este nó. Os valores válidos são Nenhum, Padrão, Depurar, e Completo.
Nome do arquivo de rastreio Sim Sim \MQeTraceFile.trc O nome do arquivo no qual os registros de rastreio são gravados.
Modo de Transação Sim Não Sim Esta propriedade controla se a mensagem que chega é recebida no ponto de sincronização. Os valores válidos são Automático, Sim e Não.
Utilize arquivo de configuração Sim Não Não Selecionada Se você selecionar a caixa de opções, um arquivo de configuração será utilizado para esse nó.
Nome do arquivo de configuração Sim Sim \MQeconfig.ini O nome do arquivo de configuração a ser utilizado se a caixa de opção Utilizar Arquivo de Configuração estiver selecionada.
Nome do gerenciador de filas Sim Sim ServerQM1 O nome do gerenciador de filas do WebSphere MQ Everyplace.

As propriedades Canal do nó MQeInput são descritas a tabela a seguir.

Propriedade M C Padrão Descrição
Máx. de canais Sim Não 0 O número máximo de canais suportados pelo gerenciador de filas do WebSphere MQ Everyplace.

As propriedades Registro do nó MQeInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Tipo de Registro Sim Sim FileRegistry O tipo de informações de registro a serem utilizadas. Os valores válidos são FileRegistry e PrivateRegistry.
Diretório Sim Sim \ServerQM1\registry O diretório no qual o arquivo de registros existe (válido somente se FileRegistry estiver selecionado).
PIN Sim Sim   O PIN associado ao gerenciador de filas do WebSphere MQ Everyplace (válido somente se PrivateRegistry estiver selecionado).
PIN do pedido de certificado Sim Sim   O PIN que é utilizado para solicitar autenticação (válido somente se PrivateRegistry estiver selecionado).
Senha Keyring Sim Sim   A senha que é utilizada para ver chaves criptográficas (válida somente se PrivateRegistry estiver selecionado).
Host do certificado Sim Sim   O nome do servidor de certificados (válido somente se PrivateRegistry estiver selecionado).
Porta do certificado Sim Sim   A porta do servidor de certificados (válido somente se PrivateRegistry estiver selecionado).

As propriedades Listener do nó MQeInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Tipo do Listener Sim Sim Http O tipo de adaptador para o listener. Os valores válidos são Http, Comprimento e Histórico.
Nome do Host Sim Sim 127.0.0.1 O nome do host do servidor.
Porta Sim Sim 8081 A porta na qual o WebSphere MQ Everyplace atende.
Intervalo de tempo (seg) Sim Sim 300 O intervalo de polling do WebSphere MQ Everyplace, especificado em segundos.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:04

ac04600_