Este tópico contém as seguintes seções:
Utilize o nó MQInput para receber mensagens de clientes que se conectam ao intermediário utilizando o e que utilizem 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 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 .
Os fluxos de mensagens que tratam mensagens recebidas por conexões do devem sempre iniciar com um nó MQInput.Você pode definir as propriedades do nó MQInput para controlar a forma como as mensagens são recebidas, causando a definição de 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 que comece com um nó MQInput, 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ó MQOutput.Você pode criar um fluxo de mensagens que recebe mensagens de clientes do e gera mensagens para clientes que utilizam todos os 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.
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 de conexões do , será possível escolher um destes outros nós de entrada:
O nó MQInput é representado no pelo seguinte ícone:
Veja as amostras a seguir para consultar sobre como utilizar este nó:
Para obter um exemplo de como utilizar este nó, suponha que você tenha gravado um aplicativo de publicação que publica atualizações de estoque regularmente. O aplicativo envia as mensagens ao intermediário em um nó MQInput e o fluxo de mensagens disponibiliza as publicações para vários assinantes por meio de um nó Publication.
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 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 do cabeçalho MQRFH2, os valores do cabeçalho MQRFH2 terão precedência.
Deixe Conjunto de Mensagens em branco para os analisadores XML, XMLNS, JMS, e BLOB.
Deixe Tipo de Mensagem em branco para os analisadores XML, XMLNS, JMS, e BLOB.
Deixe Formato da Mensagem em branco para os analisadores XML, XMLNS, JMS 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 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 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 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 Application Programming Reference.
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 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 e por que você pode escolher utilizar esta opção, consulte o 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 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.
Os destinos de defeitos se comportam como os da saída do nó Trace. Portanto se, por exemplo, você selecionar Rastreio de Usuário, as entradas de rastreio serão gravadas independentemente da definição do sinalizador de rastreio do usuário para o fluxo de mensagens.
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).
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. Ou seja, se o processamento de uma mensagem em um grupo falhar, todas as mensagens dentro do grupo serão recuperadas. 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.
Se você tiver vários fluxos de mensagem, ou instâncias do mesmo fluxo de mensagens, que acessem a mesma fila, talvez apareça um ou mais dos seguintes sintomas:
Os terminais do nó MQInput são descritos na tabela a seguir.
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 . |
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 é mandató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 propriedades é 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 tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome da Fila | Sim | Sim | O nome da fila de entrada 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 da mensagem de entrada. | |
Conjunto de Mensagens | Não | Não | O conjunto de mensagens da mensagem de entrada. | |
Tipo de Mensagem | Não | Não | O tipo de mensagem de entrada. | |
Formato de Mensagem | Não | Não | O formato da mensagem de entrada. | |
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 tabela a seguir.
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 .Se você selecionar a caixa de opções, esta ação é executada. |
Todas as Mensagens Disponíveis | Sim | Não | Limpo | 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 | Limpo | Determina se 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 | Limpo | 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. |
As propriedades de Validação do nó MQInput são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Validar | Sim | Não | Nenhum | Determina se a validação ocorrerá. Os valores válidos são Nenhum e Conteúdo e Valor. |
Ação de Defeito | Sim | Não | Exceção | O que acontece se a validação falha. Você pode definir esta propriedade somente se você definir Validar para Conteúdo e Valor. Os valores válidos são Rastreio de Usuário, Log de Erros Local, e Exceção. |
Sincronização | Sim | Não | Adiado | Quando uma validação ocorre. Você pode definir esta propriedade somente se você definir Validar para Conteúdo e Valor. Os valores válidos são Adiado, Imediato e Concluído. |
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 caixa de opções que está sendo selecionada, é que todas as restrições de valores estão incluídas na validação. |
Corrigir | Sim | Não | Nenhum | Essa propriedade não pode ser editada. É fornecida uma correção mínima. |
As propriedades de Descrição do nó MQInput 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. |
Conceitos relacionados
Fluxos de Mensagem
Extensões Definidas pelo Usuário
Tipos
Implementação de Aplicativo de Fluxo de Mensagens
Tarefas relacionadas
Decidindo Quais Nós Utilizar
Utilizando Mais de Um Nó Input
Configurando Fluxos de Mensagens Coordenados
Tratando Erros em Fluxos de Mensagens
Utilizando as Filas de Clusters para Entrada e Saída
Utilizando as Filas Compartilhadas do para Entrada e Saída (z/OS)
Validando Mensagens
Definindo Restrições de Valores
Editando Propriedades Configuráveis
Referências relacionadas
Nó HTTPInput
Nó HTTPReply
Nó Input
Nó MQeInput
Nó MQeOutput
Nó MQOutput
Nó MQReply
Nó Real-timeInput
Nó Real-timeOptimizedFlow
Nó SCADAInput
Nó SCADAOutput
Avisos |
Marcas |
Downloads |
Biblioteca |
Suporte |
Feedback
![]() ![]() |
ac04560_ |