Utilize o nó MQeInput para receber mensagens dos clientes que se conectam ao intermediário utilizando o protocolo WebSphere MQ Mobile Transport.
Este tópico contém as seguintes seções:
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.
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.
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:
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.
Encontre informações adicionais sobre o WebSphere MQ Everyplace, e as propriedades do nó, na documentação do WebSphere MQ Everyplace na WebSphere MQ.
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:
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.
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:
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.
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.
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ó.
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:
O nó MQeOutput é o único nó de saída que pode ser configurado para substituir esta opção.
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. |