Este tópico contém as seguintes seções:
Utilize o nó MQGet para receber mensagens de clientes que se conectam ao intermediário utilizando o WebSphere MQ Enterprise Transport e que utilizam as interfaces de programação de aplicativos MQI e AMI. O nó MQGet também pode ser utilizado para recuperar as mensagens que foram colocadas anteriormente em uma fila de mensagens do WebSphere MQ que está definida para o gerenciador de filas do intermediário.
O nó MQGet lê uma mensagem a partir de uma fila especificada e estabelece o ambiente de processamento para a mensagem. Se apropriado, você pode definir a fila de entrada como uma fila em cluster ou fila compartilhada do WebSphere MQ.
Um nó MQGet pode ser utilizado em qualquer lugar em um fluxo de mensagens, de forma diferente de um nó MQInput que pode ser utilizado apenas como o primeiro nó em um fluxo de mensagens. A árvore de mensagens de saída de um nó MQGet é construída pela combinação da árvore de entradas com a árvore de resultados da chamada MQGET. É possível configurar as propriedades do nó MQGet para controlar a maneira como as mensagens são recebidas. Por exemplo, é possível indicar que uma mensagem deve ser processada sob o controle da transação ou você pode solicitar que, quando a árvore de resultados estiver sendo criada, a conversão de dados seja executada no recebimento de cada mensagem de entrada.
O nó MQGet manipula mensagens nos seguintes domínios de mensagens:
O nó MQGet é representado no workbench pelo seguinte ícone:
Consulte as seguintes descrições e amostras para ver como você pode utilizar o nó MQGet em um fluxo de mensagens:
Quando tiver colocado uma instância do nó MQGet em um fluxo de mensagens, será possível configurá-lo.
Clique com o botão direito na visualização do editor clique em Propriedades. As propriedades Básicas do nó são exibidas no diálogo de propriedades.
Todas as propriedades obrigatórias estão marcadas com um asterisco no diálogo de propriedades.
Configure o nó MQGet fazendo o seguinte:
<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 o Tipo de Mensagem em branco para analisadores XML, XMLNS, XMLNSC, JMS, IDOC, MIME e BLOB.
Deixe Formato da Mensagem em branco para os analisadores XML, XMLNS, XMLNSC, JMS, MIME e BLOB.
Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
Você pode digitar qualquer referência de campo ESQL válida - essa referência pode incluir expressões - incluindo novas referências de campo para criar um novo nó na árvore de mensagens para inserir a resposta na mensagem propagada a partir da árvore de entrada.
Por exemplo, OutputRoot.XMLNS.ABC.DEF e Environment.GotReply são referências de campo válidas. Consulte Utilizando um Nó MQGet em um Fluxo de Pedido/resposta para obter informações mais detalhadas.
Quando a cadeia de bits de mensagem recuperada é analisada para criar o conteúdo da árvore de mensagens, são utilizadas as propriedades da mensagem especificadas como as propriedades Padrão do nó.
Você pode digitar qualquer referência de campo ESQL válida (consulte a descrição da propriedade Local de Dados de Saída). Os dados colocados neste local são sempre a árvore de resultados completa, com o corpo como um elemento BLOB. Local de Dados de Resultados não é utilizado para dados de aviso.
Se você alterar a opção paraImediata, a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado, exceto os tipos complexos com uma Composição de Opção ou Mensagem que não possam ser resolvidos no momento. Se você alterar a opção paraCompleta, a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado; os tipos complexos com uma Composição de Opção ou Mensagem que não podem ser resolvidos no momento causam a falha da validação.
Para obter detalhes adicionais, consulte Propriedades de Validação para Mensagens no Domínio MRM.
Selecione a caixa de opções Utilizar Analisador Compacto MQRFH2C se desejar que o analisador MQRFH2C seja utilizado. Por padrão, essa caixa de opções é limpa, o que significa que o analisador compacto não é utilizado.
Para obter informações adicionais, consulte Manipulando Mensagens Utilizando o Analisador XMLNSC.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
Conecte os terminais de saída Saída, Aviso, Falha e Nenhuma Mensagem desse nó a outro nó no fluxo de mensagens se você quiser processar a mensagem ainda mais, processar erros ou enviar a mensagem a um destino adicional.
O que é propagado a cada um dos terminais de saída depende do CC (Código de Condição) gerado pela chamada MQGET.
Se a chamada MQGET for bem-sucedida, o nó MQGet roteará cada mensagem de saída analisada para o terminal de Saída.
Se a chamada MQGET falhar, mas com um CC indicando um aviso, uma mensagem de saída não analisada será propagada no terminal de Aviso.
Se a chamada MQGET falhar com um CC mais grave do que um aviso, a mensagem de entrada será propagada para o terminal de Falha.
Se a chamada MQGET falhar com um código de razão MQRC_NO_MSG_AVAILABLE,
a mensagem de saída será propagada (sem um corpo de resultado) para o terminal de Nenhuma Mensagem.A mensagem de saída que é propagada para o terminal Sem Mensagem é construída a partir da mensagem de entrada somente, de acordo com os valores das propriedades Gerar Modo e Copiar Mensagem ou Copiar Ambiente Local.
Se você não conectar os terminais de Saída, Aviso ou Nenhuma Mensagem a outro nó do fluxo de mensagens, tudo o que for propagado a esses terminais será descartado.
Se você não conectar o terminal de Falha a outro nó no fluxo de mensagens, uma exceção será emitida pelo intermediário quando qualquer coisa for propagada para esse terminal.
Consulte Conectando Terminais com Falha para obter informações adicionais.
Quando incluir um nó MQGet em um fluxo de mensagens, o valor configurado para o Modo de Transação define se as mensagens serão recebidas sob o ponto de sincronização:
Os terminais do nó MQGet são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
Entrada | O terminal de entrada que aceita a mensagem que está sendo processada pelo fluxo de mensagens. |
Aviso | O terminal de saída ao qual a árvore de saída é propagada se ocorrer um erro (com um CC que indica um aviso) no nó ao tentar obter uma mensagem da fila. A parte MQMD da mensagem é analisada, mas o restante da mensagem será um elemento BLOB não analisado. O aviso é descartado se o terminal não for conectado e não houver nenhuma propagação da saída a partir do nó. |
Defeito | O terminal de saída ao qual a mensagem de entrada é roteada se ocorrer um erro (com um CC que indica um erro mais grave do que um aviso) no nó ao tentar obter uma mensagem da fila. |
Saída | O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito da fila do WebSphere MQ. |
Nenhuma Mensagem | ![]() ![]() |
As tabelas a seguir descrevem as propriedades do nó; a coluna intitulada M indica se a propriedade é obrigatória (marcada com um asterisco no diálogo de propriedades se você precisar digitar um valor), a coluna intitulada C indica se a propriedade é configurável (você pode alterar o valor ao incluir o fluxo de mensagens no arquivo bar para implementá-lo).
As propriedades Básicas do nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Nome da Fila | Sim | Sim | Nenhum(a) | O nome da fila de mensagens do WebSphere MQ a partir da qual este nó recupera mensagens. |
As propriedades Padrão do nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Domínio de Mensagens | Não | Não | Nenhum(a) | O domínio que será utilizado para analisar a mensagem obtida da fila de mensagens. |
Conjunto de Mensagens | Não | Não | Nenhum | O nome ou identificador do conjunto de mensagens no qual a mensagem obtida da fila de mensagens é definida. |
Tipo de Mensagem | Não | Não | Nenhum | O nome da mensagem que é obtida da fila de mensagens. |
Formato de Mensagem | Não | Não | Nenhum | O nome do formato físico da mensagem que é obtida da fila de mensagens. |
As propriedades Avançadas do nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Modo de Transação | Não | 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. |
Modo de Geração | Não | Não | Message | Quais partes da mensagem da árvore de entrada são copiadas. Os valores válidos são Mensagem, Ambiente Local, Mensagem e Ambiente Local e Nenhum. |
Copiar Mensagem | Não | Não | Nenhum | Quais partes da mensagem da árvore de entrada são copiadas. Os valores válidos são Nenhum, Copiar Cabeçalhos e Copiar Toda a Mensagem. |
Copiar Ambiente Local | Não | Não | Quais partes da mensagem da árvore de entrada são copiadas. Os valores válidos são Nenhum e Copiar Todo o Ambiente Local.O valor padrão é Copiar Todo o Ambiente Local. | |
Intervalo de Espera | Sim | Não | 1000 | O tempo máximo, em milissegundos, para aguardar a obtenção da mensagem da fila de mensagens. |
Tamanho Mínimo do Buffer de Mensagem | Sim | Não | 4 | O tamanho mínimo, em kilobytes, do buffer de obtenção. O valor mínimo desta propriedade é de 1 kilobyte. |
As propriedades de Validação do nó MQGet 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 |
---|---|---|---|---|
Validate | Não | Sim | Nenhum | Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo, Conteúdo e Valor e Herdar. |
Ação de Defeito | Não | Não | Exceção | O que acontece se a validação falhar. 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ções. |
Incluir Todas as Limitações do Valor | Não | Não | Verdadeiro | Essa propriedade não pode ser editada. A ação padrão, indicada pela caixa de opções selecionada, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor. |
Corrigir | Não | Não | Nenhum | Essa propriedade não pode ser editada. |
As propriedades de Pedido do nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Local do MQMD de Entrada | Não | Não | Especifica onde na montagem da mensagem de entrada o MQMD que será utilizado para o MQGET pode ser localizado.O local padrão é InputRoot.MQMD. | |
Local de Parâmetros do MQ de Entrada | Não | Não | Especifica onde na montagem da mensagem de entrada os parâmetros do MQ (por exemplo, o tamanho do buffer inicial e as substituições MQGMO) podem ser localizados. O local padrão é InputLocalEnvironment.MQ.GET. | |
Obter por ID de Correlação | Não | Não | Falso | Quando selecionada, esta caixa de opções faz com que sejam obtidas apenas as mensagens que especificaram o ID de correlação. |
Obter por ID de Mensagem | Não | Não | Falso | Quando selecionada, esta caixa de opções faz com que sejam obtidas apenas as mensagens que especificaram o ID de mensagem. |
Utilizar MQMD de Entrada Completo | Não | Não | Falso | Quando selecionada, esta caixa de opções faz com que o MQMD completo seja utilizado. Caso contrário, apenas o ID de mensagem e o ID de correção serão utilizados. |
As propriedades de Resultado do nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Local de Dados de Saída | Não | Não | OutputRoot | Especifica onde os dados de saída serão colocados. Se estiver em branco, OutputRoot será utilizado como um padrão. |
Local de Dados de Resultado | Não | Não | ResultRoot | Especifica qual subárvore (da mensagem recuperada) utilizar. Se ficar em branco, ResultRoot será utilizado como um padrão e toda a mensagem recuperada será utilizada. Se, por exemplo, ResultRoot.MQMD.ReplyToQ for especificado, apenas essa subárvore será utilizada. |
Local de Parâmetros do MQ de Saída | Não | Não | Especifica onde os parâmetros do MQ de saída estão localizados. Se estiver em branco, OutputLocalEnvironment.MQ.GET será utilizado como um padrão. O Modo de Geração deve ser configurado para incluir o Ambiente Local para assegurar que os valores atualizados fiquem visíveis em nós de recebimento de dados. O local padrão é OutputLocalEnvironment.MQ.GET. | |
Local de Dados de Aviso | Não | Não | OutputRoot | Especifica onde os dados de saída serão colocados se MQGET retornar um código de aviso. Se estiver em branco, OutputRoot será utilizado como um padrão. |
As propriedades das Opções de Mensagens Gerais do nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Sincronização de Análise | Não | Não | On Demand | Esta propriedade controla 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 | Não | Não | Falso | Esta propriedade controla se o MQRFH2C Compact Parser, no lugar do analisador MQRFH2, é utilizado para cabeçalhos MQRFH2. |
As propriedades das Opções do Analisador XMLNSC para o nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS | Não | Não | Falso | ![]() ![]() |
Modo de Retenção de Conteúdo Misto | Não | 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 | Não | 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 | Não | 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 de Descrição do nó MQGet são descritas na tabela a seguir.
Propriedade | M | C | Padrão | Descrição |
---|---|---|---|---|
Descrição Breve | Não | Não | Em Branco | Uma breve descrição do nó. |
Descrição Longa | Não | Não | Em Branco | Texto que descreve a finalidade do nó no fluxo de mensagens. |