Este tópico contém as seguintes seções:
Utilize o nó MQeInput para receber as mensagens dos clientes que se conectam ao intermediário utilizando o protocolo do WebSphere MQ Mobile Transport.
O nó MQeInput recebe mensagens colocadas em um fluxo de mensagens a partir de uma fila ponte especificada no gerenciador de filas do 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 contendo este nó.
Os fluxos de mensagens que tratam mensagens recebidas por conexões do WebSphere MQ Everyplace devem sempre iniciar com um nó MQeInput. É possível definir as propriedades do nó MQeInput para controlar a maneira como as mensagens são recebidas. Por exemplo, você pode indicar que uma mensagem deve ser processada sob controle de transação.
Quando implementar fluxos de mensagens contendo 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. Os nós do WebSphere MQ Everyplace nos fluxos devem especificar o mesmo nome do gerenciador de filas do WebSphere MQ Everyplace. Você obtém um erro ao implementar, se a restrição não for correspondida.
O nó MQeInput identifica mensagens nos seguintes domínios de mensagens:
Se você incluir um nó output em um fluxo de mensagens iniciado por um nó MQeInput, pode 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ó 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 Message Broker. Compatível com versões mais recentes do WebSphere MQ Everyplace. Os clientes que utilizam as últimas versões do WebSphere MQ Everyplace, por exemplo, Versão 2.0, trabalham corretamente quando conectados nesse 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 o gerenciador de filas criado utilizando a Versão 1.2.6. Da mesma forma, o cliente deve utilizar seu nível do código ao criar um gerenciador de filas.
Você não pode utilizar nós MQeInput em fluxos de mensagens implementados em sistemas z/OS.
Se você criar um fluxo de mensagens para utilizar um subfluxo, não poderá utilizar um nó input padrão: será necessário utilizar uma instância do nó Input como o primeiro nó a ser criado em um terminal para o subfluxo.
Se seu fluxo de mensagens não receber mensagens através das conexões do WebSphere MQ, é possível escolher um desses outros nós de entrada.
O nó MQeInput é representado no workbench 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 observa uma área que precisa de irrigação e usa o PDA e um link da Global Satellite Navigation para enviar uma mensagem ao nó MQeInput. Os dados são manipulados por um nó Compute e uma mensagem é publicada pelo nó Publication para que um dispositivo SCADA remoto possa receber a mensagem e acionar os carros de irrigação. O fazendeiro pode ver a área seca sendo irrigada alguns minutos após o envio da mensagem.
Você pode localizar informações adicionais sobre o WebSphere MQ Everyplace, as propriedade do nó, na documentação do WebSphere MQ Everyplace no Página da Web do WebSphere MQ.
Quando tiver colocado uma instância do nó MQeInput 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 padrão do nó serão exibidas no diálogo de propriedades.
Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.
Configure o nó MQeInput da seguinte forma:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type> <Fmt>XML</Fmt></mcd>
Se você definir os valores e esses valores forem diferentes dos existentes no cabeçalho MQRFH2, os valores do cabeçalho MQRFH2 terão precedência.
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, JMS, MIME e BLOB.
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ções, a definição de todas as propriedades será extraída do arquivo identificado por Nome do Arquivo Config (descrito abaixo) com a exceção do seguinte:
Apenas um gerenciador de filas do WebSphere MQ Everyplace pode ser suportado.Apenas um grupo de execução pode conter os nós MQeInput ou MQeOutput. Portanto, essa propriedade deve ser definida como o mesmo valor em cada nó MQeInput incluído em cada fluxo de mensagens implementado no mesmo intermediário.
Como os 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, poderá ser necessário exceder o tempo limite de canais que estavam inativos por um período de tempo.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
O MQeInput roteia cada mensagem recuperada com êxito para o terminal de saída. Se isso falhar, a mensagem será repetida. Se o tempo limite de repetição expirar (conforme definido pelo atributo BackoutThreshold da fila de entrada), a mensagem será roteada para o terminal failure; você poderá conectar nós nesse terminal para identificar essa condição. Se você não estiver conectado ao terminal failure, a mensagem será gravada na fila de restauração.
Se a mensagem for capturada por este nó após o lançamento de uma exceção no fluxo de mensagens, a mensagem será roteada para o terminal da captura. Se você não conectou o terminal catch, a mensagem entrará em um loop contínuo pelo 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 incluir um nó MQeInput em um fluxo de mensagens, o valor definido para a propriedade Modo de Transação define se as mensagens são recebidas sob o ponto de sincronização:
(O nó MQOutput é o único nó de saída que pode ser configurado para substituir essa opção).
Os terminais do nó MQeInput são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Defeito | O terminal de saída para o qual a mensagem será roteada se ocorrer um erro. |
Saída | O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila do WebSphere MQ Everyplace. |
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 Padrão do nó MQeInput 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. | |
Tópico | Não | Sim | O tópico padrão para a mensagem de entrada. |
As propriedades Gerais do nó MQeInput são descritas na tabela a seguir.
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. | |
Trace | Sim | Não | Nenhum | 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 | Determina se a mensagem de entrada é recebida sob o ponto de sincronização. Os valores válidos são Automático, Sim e Não. |
Utilizar Arquivo de Configuração | Sim | Não | Não selecionada | Utilize um arquivo de configuração para esse nó. Se você selecionar a caixa de opções, esta ação é executada. |
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ções Utilizar Arquivo de Configuração estiver selecionada. |
Nome do Gerenciador de Fila | Sim | Sim | ServerQM1 | O nome do gerenciador de filas do WebSphere MQ Everyplace. |
As propriedades do Canal do nó MQeInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Número Máximo de Canais | Sim | Não | 0 | O número máximo de canais suportados pelo gerenciador de filas do WebSphere MQ Everyplace. |
As propriedades de Registro do nó MQeInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Type | Sim | Sim | Registro de Arquivos | O tipo de informações de registro a serem utilizadas. Os valores válidos são Registro de Arquivo e Registro Privado. |
Diretório | Sim | Sim | \ServerQM1\registry | O diretório no qual o arquivo de registros existe (válido apenas se Registro de Arquivos estiver selecionado). |
PIN | Sim | Sim | O PIN associado ao gerenciador de filas do WebSphere MQ Everyplace (válido apenas se Registro Privado estiver selecionado). | |
PIN de Pedido de Certificados | Sim | Sim | O PIN utilizado para solicitar autenticação (válido apenas se Registro Privado estiver selecionado). | |
Senha do Conjunto de Chaves | Sim | Sim | A senha utilizada para ver chaves criptográficas (válido apenas se Registro Privado estiver selecionado). | |
Host do Certificado | Sim | Sim | O nome do servidor do certificado (válido apenas se Registro Privado estiver selecionado). | |
Porta do Certificado | Sim | Sim | A porta do servidor de certificados (válido apenas se Registro Privado estiver selecionado). |
As propriedades do Listener do nó MQeInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Tipo de 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 | Sim | Sim | 300 | O intervalo de polling do WebSphere MQ Everyplace, especificado em segundos. |
As propriedades de Descrição do nó MQeInput sã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. |