Este tópico contém as seguintes seções:
Utilize o nó MQInput para receber mensagens de clientes que conectam-se ao intermediário utilizando o WebSphere MQ Enterprise Transport e que utilizam as interfaces de programação de aplicativos MQI e AMI.
O nó MQInput recebe entrada de mensagem para um fluxo de mensagens a partir de uma fila de mensagens do WebSphere MQ definida no gerenciador de filas do intermediário. O nó usa MQGET para ler uma mensagem de uma fila especificada e estabelece o ambiente em processo para a mensagem. Se apropriado, você pode definir a fila de entrada como uma fila em cluster ou fila compartilhada do WebSphere MQ.
Os fluxos de mensagens que manipulam mensagens recebidas entre conexões do WebSphere MQ devem sempre ser iniciados com um nó MQInput. Você pode configurar as propriedades do nó MQInput para controlar a maneira que as mensagens são recebidas, causando a configuração das opções MQGET apropriadas. Por exemplo, você pode indicar que uma mensagem deve ser processada sob controle de transação. Você também pode solicitar que a conversão de dados seja executada durante a recepção de cada mensagem de entrada.
O nó MQInput manipula mensagens nos seguintes domínios de mensagens:
Se você incluir um nó de saída em um fluxo de mensagens iniciado por um nó MQInput, ele 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ó MQOutput. É possível gerar um fluxo de mensagens que receba mensagens de clientes do WebSphere MQ e gere mensagens para clientes que utilizam qualquer um dos transportes suportados para conectar-se ao intermediário, porque é possível configurar o fluxo de mensagens para solicitar que o intermediário forneça qualquer conversão necessária.
Se você criar um fluxo de mensagens para usar como um subfluxo, não será possível utilizar um nó de entrada padrão; será necessário utilizar uma instância do nó Input como o primeiro nó para criar um terminal de entrada para o subfluxo.
Se seu fluxo de mensagens não receber mensagens através das conexões do WebSphere MQ, é possível escolher um dos nós de entrada suportados.
O nó MQInput é representado no workbench pelo seguinte ícone:
Veja as amostras a seguir para saber como você pode utilizar o nó MQInput:
Quando tiver colocado uma instância do nó MQInput em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito do mouse na visualização do editor e clique em Propriedades. As propriedades básicas do nó serã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ó MQInput da seguinte forma:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type> <Fmt>XML</Fmt></mcd>
Se você definir valores, e estes valores forem diferentes dos valores no cabeçalho MQRFH2, os valores no 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.
Consulte Configurando o Nó para Manipular Grupos de Mensagem para obter detalhes adicionais sobre esta opção.
Se você desmarcar a caixa de opções, as mensagens enviadas como parte de um grupo não serão recebidas em uma ordem pré-determinada. Se um intermediário espera receber mensagens em grupos e esta caixa de opções não estiver selecionada, ou a ordem das mensagens de entrada não é importante ou o fluxo de mensagens deve ser projetado para processá-las apropriadamente.
Você também deve selecionar a caixa de opções Consolidar por Grupo de Mensagem se quiser que o processamento de mensagem seja consolidado somente depois que a mensagem final de um grupo tenha sido recebida e processada.
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
Consulte Configurando o Nó para Manipular Grupos de Mensagem para obter detalhes adicionais sobre esta opção.
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
Digite um número par de dígitos hexadecimais (os caracteres 0 a 9, A a F, e a a f são válidos) até um máximo de 48 dígitos. Se o ID que você digitar for menor que o campo MsgId, ele será preenchido à direita com caracteres X'00'. Isso é mapeado para a opção MQMO_MATCH_MSG_ID do MQGMO do MQI.
Deixe essa propriedade em branco se não desejar que o nó de entrada verifique se o ID da mensagem é correspondente.
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
Digite um número par de dígitos hexadecimais (os caracteres 0 a 9, A a F, e a a f são válidos) até um máximo de 48 dígitos. Se o ID que você digitar for menor que o campo CorrelId, ele será preenchido à direita com caracteres X'00'. Isso é mapeado para a opção MQMO_MATCH_CORREL_ID do MQGMO do MQI.
Deixe essa propriedade em branco se não desejar que o nó de entrada verifique se o ID da mensagem é correspondente.
Informações adicionais sobre as opções para as quais esta propriedade é mapeada estão disponíveis no WebSphere MQ Application Programming Reference.
WebSphere MQ converte a mensagem de entrada para o conjunto de caracteres de codificação e codificados especificado no MQMD fornecido pelo nó de entrada na chamada MQGET para recuperar a mensagem da fila de entrada. O fluxo de mensagens gera todas as mensagens de saída usando estes valores, e as coloca nas filas de destino com estes valores Encoding e CodedCharSetID definidos no MQMD.
Essa propriedade é mapeada para a opção MQGMO_CONVERT do MQGMO do MQI.
Limpe a caixa de opções se não desejar que o WebSphere MQ converta a mensagem.
Se você selecionar essa caixa, também poderá especificar:
Se não for especificado um valor, a mensagem de entrada MQMD será utilizada.
Se for especificado um valor inválido, não será feita nenhuma conversão.
Se não for especificado um valor, a mensagem de entrada MQMD será utilizada.
Se for especificado um valor inválido, não será feita nenhuma conversão.
Para obter informações adicionais sobre conversão de dados do WebSphere MQ e por que você pode escolher utilizar esta opção, consulte o WebSphere MQ Application Programming Guide.Para obter informações adicionais sobre os valores que podem ser especificados para Converter Codificação e Converter ID do Conjunto de Caracteres Codificados, consulte o WebSphere MQ Application Programming Reference.
Essa propriedade será relevante somente se você selecionou Ordem Lógica.
Defina a propriedade Modo de Ordem para Por Ordem da Fila se as mensagens em um grupo tiverem de ser recuperadas e processadas na ordem em que aparecem na fila.
O valor fornecido para o símbolo de serialização deve estar em conformidade com as regras descritas na WebSphere MQReferência de Programação do Aplicativo.
Para obter informações adicionais sobre a serialização e o compartilhamento de filas no z/OS, consulte o WebSphere MQ Guia de Conceitos e Planejamento.
Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
O MQInput roteia cada mensagem recebida 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 você inclui um nó MQInput em um fluxo de mensagens, o valor definido para Modo de Transação define se as mensagens serã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).
WebSphere MQ suporta grupos de mensagem; você pode especificar que uma mensagem deve pertencer a um grupo e que seu processamento e o processamento de todas as outras mensagens no grupo devem ser manipulados como uma transação. Isto é, se o processo em uma mensagem no grupo falhar, todas as mensagens no grupo são retornadas. O processamento da mensagem é consolidado quando a última mensagem no grupo tiver sido processada com êxito e apenas se o processamento de todas as mensagens tiver sido bem sucedido.
Se você incluir mensagens em um grupo, e for importante que todas as mensagens dentro do grupo sejam lidas a partir da fila e processadas na ordem em que estiverem definidas dentro do grupo, você deve concluir todas as ações indicadas abaixo:
Você também deve se assegurar de que não há nenhum outro fluxo de mensagens que esteja recuperando mensagens da mesma fila de entrada. Se houver, não há garantia a respeito da ordem em que as mensagens são processadas dentro de um grupo.
Os terminais do nó MQInput são descritos na seguinte tabela.
Terminal | Descrição |
---|---|
Defeito | O terminal de saída para o qual a mensagem é encaminhada se ocorrer um erro. Mesmo que a propriedade Validação esteja definida, as mensagens propagadas para esse terminal não serão validadas. |
Saída | 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ó MQInput são descritas na seguinte tabela.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome da Fila | Sim | Sim | O nome da fila de entrada WebSphere MQ a partir da qual este nó recupera mensagens (usando o MQGET) para processamento pelo fluxo de mensagens. |
As propriedades Padrão do nó MQInput 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 Avançadas do nó MQInput são descritas na seguinte tabela.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Modo de Transação | Sim | Não | Sim | Se a mensagem de entrada é recebida sob o ponto de sincronização. Os valores válidos são Automático, Sim, e Não. |
Ordenar Modo | Sim | Não | Padrão | A ordem em que as mensagens são recuperadas da fila de entrada e processadas. Os valores válidos são Padrão, Por ID de Usuário, e Por Ordem de Fila. |
Ordem Lógica | Sim | Não | Selecionada | Se as mensagens são recebidas em ordem lógica, conforme definido pelo WebSphere MQ.Se você selecionar a caixa de opções, esta ação é executada. |
Todas as Mensagens Disponíveis | Sim | Não | Não selecionada | Se você selecionar a caixa de opções, todas as mensagens em um grupo devem estar disponíveis antes que a recuperação de uma mensagem seja possível. |
ID de Mensagem Correspondente | Não | Não | Um ID da mensagem que deve corresponder ao ID da mensagem no MQMD da mensagem de entrada. | |
ID de Correlação Correspondente | Não | Não | Um ID de correlação que deve corresponder ao ID de correlação no MQMD da mensagem de entrada. | |
Converter | Sim | Não | Não selecionada | Determina se WebSphere MQ executa a conversão de dados na mensagem a ser recebida, em conformidade com os valores CodedCharSetId e Encoding definidos no MQMD. Se você selecionar a caixa de opções, esta ação é executada. |
Converter Codificação | Não | Não | A representação utilizada para valores numéricos nos dados da mensagem, expressa como um valor inteiro. Essa propriedade será válida apenas se você tiver selecionado a caixa de opções Converter. | |
Converter ID do Conjunto de Caracteres Codificados | Não | Não | O identificador do conjunto de caracteres codificados de dados de caracteres nos dados da mensagem, expresso como um valor inteiro. Essa propriedade será válida apenas se você tiver selecionado a caixa de opções Converter. | |
Consolidar por Grupo de Mensagens | Sim | Não | Não selecionada | Quando uma transação é consolidada durante o processamento de mensagens que fazem parte de um grupo de mensagens. Se você selecionar a caixa de opções, a transação será consolidada quando o grupo de mensagem tiver sido processado. |
Símbolo de Serialização do z/OS | Não | Não | Um símbolo definido pelo usuário para suporte ao aplicativo serializado. O valor especificado deve concordar com as regras para um ConnTag válido na estrutura WebSphere MQ MQCNO. Essas regras são descritas na WebSphere MQ Referência de Programação do Aplicativo. |
As propriedades Validação do nó MQInput 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 |
---|---|---|---|---|
Validar | Sim | Sim | Nenhum | 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 | O que acontece se a validação falha. 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 | Selecionada | 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. |
Corrigir | Sim | Não | Nenhum | Essa propriedade não pode ser editada. |
As propriedades das Opções de Mensagens Gerais do nó MQInput são descritas na seguinte tabela.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Sincronização de Análise | Sim | Não | On Demand | Essa propriedade fornece controle sobre 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. |
Utilizar o Analisador Compacto MQRFH2C para o Domínio MQRFH2 | Sim | Não | No | Essa propriedade fornece controle sobre se o Analisador MQRFH2C Compacto, em vez do analisador MQRFH2, é utilizado para cabeçalhos MQRFH2. |
As propriedades das Opções do Analisador XMLNSC para o nó MQInput 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 | No | ![]() ![]() |
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 Descrição do nó MQInput são descritas na seguinte tabela.
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. |