nó MQInput
Use o nó MQInput para receber mensagens de clientes que se conectam ao servidor de integração usando o IBM® MQ Enterprise Transport.
O IBM MQ está disponível como um pacote de instalação separado e sua licença do IBM App Connect Enterprise autoriza você a instalar e usar o IBM MQ com o IBM App Connect Enterprise Para obter mais informações, consulte Interação entre o IBM App Connect Enterprise e IBM MQ e Instalando o IBM MQ.
Este tópico contém as seguintes seções:
Propósito
O nó MQInput recebe mensagens de uma fila especificada por meio de uma conexão local ou cliente com um gerenciador de filas.
Em sistemas distribuídos, é possível configurar o nó MQInput para obter mensagens de uma fila IBM MQ em qualquer gerenciador de fila local ou remoto, configurando as propriedades de Conexão do MQ ou especificando uma política MQEndpoint na guia Política.
Se o servidor de integração tiver um gerenciador de filas associado a ele, então o nó do fluxo de mensagens do MQ por padrão conecta-se a esse gerenciador de filas com ligações de servidor. Se você configurar as propriedades na guia do MQ Connection, então essas propriedades serão usadas para se conectar ao gerenciador de filas especificado. Se você especificar uma política do MQEndpoint, os valores na política serão usados ao invés dos valores que são definidos na guia do MQ Connection. Se uma política MQEndpoint for especificada, os valores de propriedades que são configurados na política MQEndpoint são usados no tempo de execução em vez de quaisquer valores correspondentes que são configurados na guia Conexão MQ . Todos os nós MQ que não possuem propriedades de conexão configurados e não possuem uma política MQEndpoint especificada usará os detalhes de conexão do gerenciador de filas que está associado ao servidor de integração em tempo de execução. Se nenhum gerenciador de filas foi especificado para o servidor de integração, o fluxo de mensagens não pode implementar. Para obter mais informações, revise as tabelas de propriedades do MQ Connection e da Política neste tópico.
Você pode se conectar a um gerenciador de filas local ou remoto protegido usando a propriedade Identidade de segurança no nó MQInput para transmitir um nome de usuário e senha para o gerenciador de filas. A identidade é definida usando o comando mqsisetdbparms . É possível usar a propriedade Identidade de segurança para fornecer as credenciais de segurança no local e conexões do cliente, mas ela não está disponível para conexões do cliente que usam uma tabela de definição de canal de cliente (CCDT). Também é possível escolher se deve ser usado o protocolo SSL quando uma conexão do cliente é feita com um gerenciador de filas remoto. Selecione a propriedade Usar SSL no nó MQInput para fornecer confidencialidade sobre a conexão do cliente usando SSL. Também é possível configurar essas propriedades por meio de uma política MQEndpoint.. Para obter mais informações sobre como usar identidades de segurança e SSL, consulte Conectando a um gerenciador de filas do IBM MQ seguro.
Fluxos de mensagens que manipulam mensagens que são recebidas nas conexões do IBM MQ devem sempre iniciar com um nó MQInput . É possível configurar as propriedades do nó para controlar a maneira na qual as mensagens são recebidas; por exemplo, é possível solicitar que uma mensagem deve ser processada no controle de transação. Também é possível solicitar que a conversão de dados seja executada durante a recepção de cada mensagem de entrada.
Para obter informações sobre como configurar o nó MQInput para transações, consulte Configurando nós MQ para transações.
É possível definir a fila de entrada como uma fila em cluster ou fila compartilhada do IBM MQ .
- Referência
- XMLNSC
- DataObject
- JSON
- BLOB
- MIME
- MRM
- JMSMap
- JMSStream
- XMLNS
Se você incluir um nó de saída em um fluxo de mensagens que se inicia com um nó MQInput , o nó de saída pode ser qualquer um dos nós de saída suportados, incluindo nós de saída definidos pelo usuário; você não tem que incluir um nó MQOutput . É possível criar um fluxo de mensagens que receba mensagens de clientes IBM MQ e gere mensagens para clientes que usam qualquer um dos transportes suportados para se conectar ao servidor de integração, porque é possível configurar o fluxo de mensagens para solicitar que o servidor de integração forneça qualquer conversão necessária.
O nó MQInput está contido na gaveta IBM MQ da paleta e é representado no IBM App Connect Enterprise Toolkit pelo seguinte ícone:
Usando o nó MQInput em um fluxo de mensagens
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 para o servidor de integração em um nó MQInput , e o fluxo de mensagens disponibiliza as publicações para vários assinantes através de um nó MQPublication . Você configura um nó Compute para criar uma nova mensagem de saída sempre que um determinado estoque é alterado, e conecte este nó a um nó MQOutput para registrar cada alteração de preço para este estoque.
Conectando Terminais
As rotas do nó MQInput cada mensagem que ele recupera com sucesso para o terminal Out. Se a mensagem não for recuperada com sucesso, a mensagem será tentada novamente até ser bem-sucedida ou até que o limite de restauração seja atingido. Se a contagem de restaurações for excedida (conforme definido pelo atributo BackoutThreshold da fila de entrada), a mensagem será roteada para o terminal Failure; você poderá conectar nós a este terminal para manipular esta condição. Se você não tiver conectado o terminal de Falha, a mensagem será gravada na fila de restauração, se tiver sido definida, e, nenhuma fila de restauração tiver sido definida, a mensagem será gravada na fila de devoluções (DLQ). Se nem uma fila de restauração nem uma DLQ tiver sido definida, a mensagem continuará em loop no nó até o problema ter sido resolvido, portanto, é uma boa prática assegurar que pelo menos uma dessas filas tenha sido definida. A causa mais provável desse tipo de falha é que a mensagem recebida tem um formato incorreto e a validação está ativada.
Se a mensagem for capturada por esse nó após uma exceção ter sido lançada mais adiante no fluxo de mensagens, a mensagem será roteada para o terminal de Captura, se tiver sido definido. Se o terminal de Captura não tiver sido definido e o fluxo for transacional, a mensagem será retrocedida para a fila de entrada e o processamento de mensagens será tentado novamente até que seja bem-sucedido ou até que o limite de restauração seja atingido. Se a contagem de restauração for excedida, a mensagem será roteada para o terminal de Falha. Se o terminal de Falha não tiver sido conectado, a mensagem será gravada na fila de restauração, e, se nenhuma fila de restauração tiver sido definida, a mensagem será gravada na fila de devoluções (DLQ). Se nem uma fila de restauração nem uma DLQ tiver sido definida, a mensagem continuará em loop no nó até o problema ter sido resolvido. Se o terminal de Captura não tiver sido definido e o fluxo não for transacional, a mensagem será descartada.
Para obter mais informações sobre a lógica de manipulação de erros específica para o nó MQInput , consulte Manipulando erros do nó MQInput
Tamanho do buffer MQGET
O tamanho do buffer do MQGET é implementado internamente e não é possível mudá-lo. A descrição a seguir é somente informativa. Você não deve contar com ele quando desenvolver fluxos de mensagens, porque a implementação interna pode ser alterada.
Quando o nó MQInput inicializa, ele configura o tamanho do buffer padrão para o primeiro MQGET a 4 KB. O nó MQInput monitora o tamanho das mensagens e aumenta ou reduz o tamanho do buffer:
- Se um MQGET falhar porque a mensagem é muito maior do que o tamanho do buffer, o nó aumentará imediatamente o tamanho do buffer para acomodar a mensagem, emitirá o MQGET novamente e irá zerar uma contagem da mensagem.
- Quando 10 mensagens foram contadas desde o aumento no tamanho do buffer, o nó compara o tamanho da maior das 10 mensagens com o tamanho do buffer. Se o tamanho da mensagem maior for inferior a 75% do tamanho do buffer, este será reduzido ao tamanho da maior das 10 mensagens. Se um MQGET falhar durante as 10 mensagens, porque a mensagem é maior do que o tamanho do buffer, o nó realizará a ação 1.
Por exemplo, se a primeira mensagem recebida pelo nó tiver 20 MB e as próximas 10 mensagens tiverem 14 MB cada uma, o tamanho do buffer será aumentado de 4 KB para 20 MB e permanecerá em 20 MB para as 10 mensagens. Entretanto, após a décima mensagem, o tamanho do buffer é reduzido para 14 MB.
Terminais e Propriedades
Ao incluir um nó MQInput em um fluxo de mensagens, você pode usar a visualização Propriedades no editor de Message Flow para configurá-lo. Para exibir a ajuda de campo, clique em um campo e, em seguida, clique no ícone de informações exibido no início do campo. Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco. Para obter informações gerais de configuração, consulte Configurando um nó do fluxo de mensagens
É possível criar e anexar políticas operacionais para controlar propriedades de conexão específicas para esse tipo de nó no tempo de execução (consulte Política MQEndpoint).
As tabelas a seguir descrevem os terminais do nó e as propriedades do nó que podem ser configuradas em uma guia especificada na visualização Propriedades no editor de Fluxo de Mensagens. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco se você tiver que inserir um valor quando nenhum padrão estiver definido).
Tabela de terminais do nó
| Terminal | Descrição |
|---|---|
| Falha | O terminal de saída para o qual a mensagem será roteada se ocorrer um erro. Mesmo que a propriedade Validação esteja definida, as mensagens propagadas para esse terminal não serão validadas. Mensagens recebidas também são roteadas para esse terminal se elas tiverem voltado anteriormente diversas vezes, excedendo o limite de restauração definido. |
| Saída | O terminal de saída para o qual a mensagem será roteada se ela for recuperada com sucesso da fila do IBM MQ . |
| Capturar | O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção de recebimento de dados e capturada por este nó. |
Tabelas de propriedades do nó
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Nome de Nó | Não | O tipo de nó, MQInput | O nome do nó. |
| Descrição curta | Não | Uma breve descrição do nó. | |
| Descrição Longa | Não | Texto que descreve a finalidade do nó no fluxo de mensagens. |
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Nome da fila | True | O nome da fila de entrada do IBM MQ da qual este nó recupera mensagens (usando MQGET) para processamento por este fluxo de mensagens. Você deve predefinir essa fila do IBM MQ para o gerenciador de fila que hospeda o servidor de integração no qual o fluxo de mensagens é implementado. |
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Connection | Não | Gerenciador de filas locais | Esta propriedade especifica como uma conexão é feita com o IBM MQ:
Os valores válidos para mqsiapplybaroverride são SERVER, CLIENTe CCDT. |
| Nome do gerenciador de filas de destino | Não | Esta propriedade especifica o nome do gerenciador de filas no qual as filas de mensagens estão definidas. | |
| Nome do host do gerenciador de filas | Não | Essa propriedade especifica o nome do host do gerenciador de filas. Para obter alta disponibilidade, é possível especificar mais de um nome do host ao separar cada nome do host com uma vírgula. O primeiro nome do host na lista é usado como o nome do host primário. Se a conexão com o nome do host estiver indisponível, o próximo nome do host será usado, e assim por diante. Para obter mais informações sobre a alta disponibilidade no IBM MQ, consulte a IBM MQ documentação do produto online |
|
| Número da porta do listener | Não | Esta propriedade especifica a porta na qual o gerenciador de filas está atendendo. | |
| Nome do canal | Não | Esta propriedade especifica o nome do canal usado pelo gerenciador de filas para enviar mensagens. | |
| Identidade de Segurança | Não | Esta propriedade especifica uma identidade que é utilizada para fornecer credenciais do nome de usuário e senha para conexões com um gerenciador de filas locais ou remotas assegurado. Ela pode ser utilizada para fornecer credenciais em conexões locais e do cliente, mas não está disponível para conexões de cliente que são configuradas utilizando uma tabela de definição de canal do cliente (CCDT). A identidade é definida usando o comando mqsisetdbparms . Ao configurar a identidade de segurança usando este comando, assegure-se de que ele seja prefixado por Para obter mais informações, consulte Conectando a um gerenciador de filas do IBM MQ seguro. |
|
| Usar SSL | Não | Não | Esta propriedade controla se o protocolo SSL é utilizado quando uma conexão do cliente é estabelecida com um gerenciador de filas remotas. Selecione esta propriedade para fornecer confidencialidade na conexão do cliente utilizando SSL. Também é possível configurar esta propriedade por meio de uma política MQEndpoint É possível usar SSL para conexões do cliente que são configuradas usando as propriedades da conexão do cliente MQ ou uma tabela de definição de canal de cliente (CCDT). Se você selecionar Utilizar SSL e especificar os detalhes da conexão por meio das Propriedades de conexão do cliente do MQ, também é possível configurar as seguintes propriedades:
Se você selecionar a propriedade Utilizar SSL, também deve-se especificar o local do repositório de chaves SSL. O repositório de chaves SSL é criado usando o GSkit IBM MQ e mantém os certificados privados e públicos necessários apropriados para a política de certificado escolhida para o gerenciador de filas.. Você especifica o local do repositório de chaves usando o comando mqsichangeproperties ; ele é especificado como o caminho de arquivo completo do repositório de chaves SSL menos a extensão de arquivo .kdb . Por exemplo, se o repositório de chaves SSL estiver localizado em C:\SSL\key.kdb, configure-o usando o seguinte comando:
O arquivo stash da senha do repositório de chaves SSL key repository file name.sth deve estar localizado no mesmo local da pasta que o repositório de chaves. O arquivo stash é criado usando o GSKit IBM MQ . Use o comando MQSC REFRESH SECURITY para captar as alterações no repositório de chaves SSL. Para obter mais informações, consulte Conectando a um gerenciador de filas do IBM MQ seguro. |
| Nome do peer SSL | Não | Esta propriedade especifica o nome que é passado para o gerenciador de filas remotas ao fazer a conexão do cliente. O valor especificado por esta propriedade deve corresponder ao valor especificado na propriedade SSLCIPH na definição de canal remoto. É possível especificar esta propriedade se a propriedade Utilizar SSL for selecionada e os detalhes da conexão do cliente forem especificados por meio das Propriedades de conexão do cliente do MQ. Ela não é utilizada para conexões do cliente que utilizam uma tabela de definição de canal do cliente (CCDT); é possível especificar essas informações na CCDT. |
|
| Especificação de código SSL | Não | Esta propriedade especifica o nome do algoritmo de criptografia de chave simétrica por meio do qual o gerenciador de filas remotas é assegurado. É possível especificar esta propriedade se a propriedade Utilizar SSL for selecionada e os detalhes da conexão do cliente forem especificados por meio das Propriedades de conexão do cliente do MQ. Ela não é utilizada para conexões do cliente que utilizam uma tabela de definição de canal do cliente (CCDT); é possível especificar essas informações na CCDT. |
Configure os detalhes da conexão para permitir que uma mensagem seja recuperada de uma fila em um gerenciador de filas local ou remoto. Valores que são configurados na guia Conexão MQ são usados no tempo de execução, a menos que seja substituído por um valor em uma política MQEndpoint que é especificada na guia Política.
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Domínio de mensagem | Não | BLOB | O domínio usado para analisar a mensagem. Se o campo estiver em branco, o padrão será BLOB. |
| Modelo de mensagem | Não | Não selecionada | O nome do local do arquivo de esquema do modelo de mensagem no qual a mensagem é definida. Ao clicar em Navegar, verá uma lista de arquivos de esquema do modelo de mensagem disponíveis para o Message domain selecionado. |
| Mensagem | Não | Não selecionada | O nome ou local da raiz de mensagem dentro do arquivo do esquema de modelo de mensagem. Essa lista é preenchida com todas as mensagens disponíveis definidas no modelo de mensagem que você selecionou. |
| Formato físico | Não | Não selecionada | O nome do formato físico da mensagem. Se estiver utilizando o analisador MRM ou IDOC, selecione da lista o formato físico da mensagem que chega. Esta lista inclui todos os formatos físicos que você definiu para o modelo de mensagem selecionado. Se você configurar a propriedade Domínio de Mensagem como DataObject, poderá configurar essa propriedade como XML ou SAP ALE IDoc. Configure essa propriedade como SAP ALE IDoc quando precisar analisar um fluxo de bits a partir de uma origem externa e gerar uma árvore de mensagens. |
<mcd> no cabeçalho
MQRFH2; por exemplo:<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type><Fmt>XML</Fmt></mcd><Msd>
for um domínio válido, os valores no cabeçalho MQRFH2 terão precedência.| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Cronometragem de análise | Não | Sob Demanda | Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores
válidos são On
Demand,
Imediato e
Completo. Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasada. Para fazer a mensagem ser analisada imediatamente, consulte Analisando sob demanda. |
| Utilizar analisador compacto MQRFH2C para cabeçalho MQRFH2 | Não | Não selecionada | Esta propriedade controla se o analisador compacto MQRFH2C, em vez do analisador MQRFH2, será utilizado para cabeçalhos MQRFH2. |
| Construir árvore utilizando tipos de dados de esquema XML | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos da sintaxe na árvore de mensagens com tipos de dados obtidos do esquema XML. Você pode selecionar esta propriedades apenas se configurar a propriedade Validar na guia Validação ou Conteúdo ou Conteúdo e Valor. |
| Utilizar analisador compacto XMLNSC para domínio XMLNS | Não | Não selecionada | Essa propriedade controla se o analisador compacto XMLNSC é utilizado para mensagens no domínio XMLNS. Se você definir essa propriedade, os dados da mensagem serão exibidos em XMLNSC nos nós que estão conectados ao terminal de saída quando o Domínio de Mensagens das propriedades de cabeçalho MQRFH2 de entrada ou Análise da Mensagem de Entrada for XMLNS. Para obter mais informações, consulte Manipulando mensagens no domínio XMLNSC |
| Reter conteúdo misto | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado. |
| Reter comentários | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado. |
| Reter instruções de processamento | Não | Não selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado. |
| Elementos opacos | Não | Em branco | Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano pelo analisador XMLNSC. A análise de ignorados será desempenhada apenas se a validação não estiver ativada (ou seja, se Validar for Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada. |
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Modo de Transação | True | 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.
Para obter mais informações, consulte Configurando nós MQ para transações. |
| Modo de ordem | True | Padrão | A ordem em que as mensagens são recuperadas da
fila de entrada e processadas. As mensagens que chegam podem ser processadas na ordem, ou qualquer encadeamento poderá processar qualquer mensagem quando ela estiver pronta. Quando a ordem é imposta, um encadeamento processa uma mensagem somente quando ela é a primeira mensagem não processada disponível com um valor de ordenação exclusivo. Os valores válidos são Padrão, Por ID do Usuário, Por Ordem de Fila e Definido pelo Usuário. Essa propriedade terá efeito somente se a propriedade de fluxo de mensagens Instâncias Adicionais na guia Instâncias estiver definida como maior que zero; isto é, se diversos encadeamentos lerem a fila de entrada. Os valores válidos são:
Para obter mais detalhes sobre como usar essa opção, consulte Otimizando o rendimento do fluxo de mensagens e Recebendo mensagens em um grupo de mensagens do IBM MQ |
| Local do Campo de Ordem | N | "" | Uma propriedade de expressão XPath ou ESQL para controlar qual parte da mensagem é usada para impor a ordenação das mensagens recebidas quando o Modo de Ordem é Definido pelo Usuário. |
| Ordem Lógica | True | Selecionado | Se você marcar essa caixa de seleção, as mensagens serão recebidas em ordem lógica, conforme definido pelo IBM MQ Essa opção é mapeada para a opção MQGMO_LOGICAL_ORDER
do MQGMO do MQI. Se você desmarcar a caixa de opções, as mensagens enviadas como parte de um grupo não serão recebidas em uma ordem predeterminada. Se um servidor de integração espera receber mensagens em grupos, e você não tiver selecionado esta caixa de seleção, ou a ordem das mensagens de entrada não é significativa, ou você deve projetar o fluxo de mensagens para processá-las apropriadamente. Você também deve selecionar Organizar por Grupo de Mensagem se você quiser que o processamento de mensagens seja organizado somente depois que a mensagem final de um grupo tenha sido recebida e processada. Mais informações sobre as opções para as quais essa propriedade é mapeada estão disponíveis na seção Referência de Programação de Aplicativos da documentação on-line do produto IBM MQ Essa opção é ignorada ao usar uma política MQEndpoint (seja explicitamente no nó, ou como uma política de gerenciador de filas padrão remota) que especifica a reconexão automática para se conectar a um gerenciador de filas remoto. A ordenação lógica não é compatível com a reconexão automática; nestes casos é emitido um aviso BIP6125 , e a ordenação lógica é desativada. Para obter mais detalhes sobre como usar essa opção, consulte Recebendo mensagens em um IBM MQ grupo de mensagens. |
| Todas as mensagens disponíveis | True | Não selecionada | Selecione Todas as Mensagens Disponíveis se
você quiser que a recuperação e o processamento de mensagens sejam concluídos somente quando todas as mensagens em um único grupo estiverem disponíveis. Essa propriedade é mapeada para a opção MQGMO_ALL_MSGS_AVAILABLE do MQGMO do
MQI. Desmarque esta caixa se a recuperação de mensagem não depender disponibilidade de todas as mensagens de um grupo antes que o processamento seja iniciado. Mais informações sobre as opções para as quais essa propriedade é mapeada estão disponíveis na seção Referência de Programação de Aplicativos da documentação on-line do produto IBM MQ |
| Corresponder ID de mensagem | Não | Um ID da mensagem que deve corresponder ao ID
da mensagem no MQMD da mensagem de entrada. Digite uma mensagem de Identificador se desejar que o nó de entrada
receba somente mensagens que contenham um valor do Identificador de mensagem correspondente no campo MsgId do
MQMD. Insira um número par de dígitos hexadecimais (caracteres Deixe essa propriedade em branco se não desejar que o nó de entrada verifique se o ID da mensagem é correspondente. Mais informações sobre as opções para as quais essa propriedade é mapeada estão disponíveis na seção Referência de Programação de Aplicativos da documentação on-line do produto IBM MQ |
|
| Corresponder ID de correlação | Não | Um ID de correlação que deve corresponder ao ID
de correlação no MQMD da mensagem de entrada. Digite um identificador de mensagem se desejar que o nó de entrada
receba somente mensagens que contenham um valor do identificador de correlação correspondente no campo
CorrelId do MQMD. Insira um número par de dígitos hexadecimais (caracteres Deixe esta propriedade em branco se não desejar que o nó de entrada verifique se o CorrelID é correspondente. Mais informações sobre as opções para as quais essa propriedade é mapeada estão disponíveis na seção Referência de Programação de Aplicativos da documentação on-line do produto IBM MQ |
|
| Converter | True | Não selecionada | Se você marcar esta caixa de seleção, IBM MQ converte os dados da mensagem a ser recebida, de acordo com as CodedCharSetId e Valores de codificação configurados no MQMD. Selecione Converter se você quiser IBM MQ para realizar a conversão de dados na mensagem quando ela for recuperada da fila. Essa opção será útil se você estiver
manipulando mensagens no domínio BLOB, ou estiver utilizando um analisador definido pelo
usuário. Não selecione esta opção se estiver analisando mensagens com os domínios XML
ou MRM, porque o analisador faz a conversão. O IBM MQ converte a mensagem recebida para o conjunto de caracteres codificados e de codificação especificado no MQMD que o nó de entrada fornece na chamada MQGET para recuperar a mensagem a partir da fila de entrada. O servidor de integração usa a opção MQGMO_CONVERT na chamada MQGET ; regras típicas para a conversão IBM MQ aplicadas. Os valores especificados nas opções Converter codificação e Converter ID de conjunto de caracteres codificados são utilizados nos campos Codificação MsgDesc e CCSID na chamada MQGET. O IBM MQ poderá converter a mensagem recebida somente se o campo MQMD Format for um valor IBM MQ integrado que identifica dados de caractere ou se existir uma saída de conversão de dados no IBM MQ. Essa propriedade é mapeada para a opção MQGMO_CONVERT do MQGMO do MQI. Desmarque a caixa de seleção se não desejar que o IBM MQ converta a mensagem. Se você selecionar esta caixa de opção, também poderá especificar valores para as propriedades Converter Codificação e Converter ID do Conjunto de Caracteres Codificado. Para obter mais informações sobre a conversão de dados do IBM MQ e por que você pode optar por usar essa opção, consulte a seção Guia de Programação de Aplicativos da documentação do produto IBM MQ on-line. |
| Converter codificação | Não | A representação utilizada para valores numéricos nos dados da mensagem, expressa como um valor inteiro. Esta propriedade será válida apenas se você tiver selecionado Converter. Digite o
número que representa a codificação na qual você deseja converter dados numéricos no
corpo da mensagem. Os valores
válidos incluem:
Para obter informações adicionais sobre os valores que podem ser especificados para Converter codificação, consulte Conversão de dados e a seção Referência de programação de aplicativos da documentação on-line do produto IBM MQ. |
|
| Converter ID do conjunto de caracteres codificados | Não | O identificador do conjunto de caracteres codificados de dados de caracteres nos dados da mensagem, expresso como um valor inteiro. Esta propriedade será válida apenas se você tiver selecionado Converter. Digite o valor que representa o identificador do conjunto de caracteres para o qual deseja converter os dados de caracteres no corpo da mensagem. Se você especificar um valor incorreto, nenhuma conversão será feita. Para obter informações adicionais sobre os valores que podem ser especificados para o ID do conjunto de caracteres codificados de conversão, consulte a seção Referência de Programação de Aplicativos da documentação on-line do produto IBM MQ. |
|
| Atribuir por grupo de mensagens | True | Não selecionada | Essa propriedade controla quando uma transação será confirmada ao
processar 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. Se você deixar essa caixa de opções limpa, será executada uma consolidação
após cada mensagem ter sido propagada totalmente através do fluxo de mensagens. Essa propriedade é relevante somente se você tiver selecionado Ordem Lógica. Defina a propriedade Modo de Ordem como Por Ordem de Fila se as mensagens em um grupo tiverem que ser recuperadas e processadas na ordem em que elas são exibidas na fila. |
| Tópico | Não | O tópico padrão para a mensagem de entrada. Você pode associar uma mensagem com um tópico publish/subscribe usando esta propriedade. É possível inserir quaisquer
caracteres como o nome do tópico. Quando as mensagens passam pelo nó MQInput , elas assumem qualquer que seja o nome de tópico digitado. (Se você estiver usando publish/subscribe, você pode se inscrever em um tópico e ver quaisquer mensagens que passavam pelo nó MQInput e foram publicadas sob esse nome de tópico.) Se a mensagem recebida tiver um cabeçalho MQRFH2,
não será necessário configurar um valor para a propriedade Tópico,
porque o valor poderá ser obtido a partir da pasta <psc>
no cabeçalho MQRFH2; por exemplo: |
|
| Somente Procura | Não | Não selecionada | Esta propriedade controla se uma mensagem será removida da fila quando for lida. Se você selecionar esta caixa de opção, a mensagem não será removida da fila quando for lida. Se você selecionar esta opção, OutputLocalEnvironment.MQ.GET.Browsed será configurado como true quando uma mensagem é propagada para o terminal de saída do nó MQInput . |
| Reconfigurar tempo limite da procura (ms) | True | -1 | O tempo, em milissegundos, entre a última mensagem elegível que está sendo procurada na fila de entrada e a procura que está sendo reconfigurada para o início da fila. O valor padrão de -1 indica que a procura não foi reconfigurada. |
Configure as propriedades do nó Avançado para determinar como a mensagem é processada, como suas características transacionais. Muitas destas propriedades mapeiam para opções na chamada MQGET.
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Validar | Não | Nenhum | Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum,Conteúdo e Conteúdo e Valor. |
| Ação de falha | Não | Exceção | Essa propriedade controla o que acontecerá 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. |
Configure estas propriedades se desejar que o analisador valide o corpo de mensagens no Conjunto de mensagens. (Se uma mensagem for propagada para o terminal de falha (Failure) do nó, ela não será validada). Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Perfil de segurança | Não | Nenhum | Essa propriedade especifica o nome do perfil de segurança que define as operações de segurança que são concluídas pelo nó no fluxo de mensagens. Para obter mais informações, consulte Perfis de segurança e Criando um perfil de segurança |
| Tipo de token de identidade | Não | Nenhum | Essa propriedade especifica o tipo de token de identidade presente na mensagem de entrada. Os valores válidos são:
|
| Local do token de identidade | Não | Nenhum | Essa propriedade especifica onde, na mensagem, a identidade pode ser localizada. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou um literal de cadeia Se você usar uma sequência literal, ela deve ser colocada entre aspas simples e não deve conter um ponto (.). Se essa propriedade não for especificada, a identidade será recuperada do cabeçalho de transporte MQMD.UserIdentifier. |
| Local da senha de identidade | Não | Nenhum | Essa propriedade especifica onde, na mensagem, a senha pode ser localizada. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou um literal de cadeia Se você usar uma sequência literal, ela deve estar entre aspas simples e não deve conter um ponto (.). Se ela não for especificada, a senha não será configurada. Esta propriedade poderá ser configurada apenas se Tipo de token de identidade estiver configurado como Nome de Usuário + Senha. |
| Local de IssuedBy da identidade | Não | Nenhum | Esta propriedade especifica uma sequência ou expressão de caminho
que descreve o emissor da identidade. O local é especificado como uma referência de campo ESQL, uma expressão XPath ou um literal de cadeia Se você usar uma sequência literal, ela deve ser colocada entre aspas simples e não deverá conter um ponto (.). O valor especifica o Emissor que é passado para um provedor WS-Trust v1.3 STS. Se essa propriedade não for especificada, o valor MQMD.PutApplName
será utilizado. Se você deixar o campo Local
issuedBy da Identidade em branco e MQMD.PutApplName também estiver em branco,
a sequência MQ será utilizada. |
| Tratar exceções de segurança como exceções normais | Não | falso | Esta propriedade especifica se as exceções de segurança (como "Acesso Negado") devem ser tratadas como exceções normais e propagadas para o terminal Failure (se conectado). Esta propriedade é desativada por padrão, assegurando que as exceções de segurança restaurarão a mensagem, mesmo que o terminal Failure esteja conectado. |
Configure valores para as propriedades de Segurança para controlar a extração de uma identidade de uma mensagem (quando um perfil de segurança estiver associado ao nó). Para obter mais informações sobre essas propriedades, consulte Identidade, Configurando a extração de um token de identidade ou de segurança, Visão geral de segurança do fluxo de mensagense Configurando a segurança do fluxo de mensagens
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Conjunto de instâncias adicionais | Não | Utilizar Conjunto Associado ao Fluxo de Mensagens | O conjunto do qual as instâncias adicionais são obtidas.
|
| Instâncias Adicionais | Não | 0 | O número de instâncias adicionais que o nó pode iniciar se a propriedade do Conjunto de Instâncias Adicionais estiver configurada como Utilizar Conjunto Associado ao Nó. Por padrão, não são concedidas instâncias adicionais ao nó. |
Configure valores para as propriedades de Instâncias para controlar as instâncias adicionais que estão disponíveis para um nó. Para obter uma descrição completa dessas propriedades, consulte Propriedades Configuráveis em um Arquivo BAR
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Política | Não | Configure o valor deste campo para o local de uma política MQEndpoint para usar os detalhes de conexão definidos nessa política para este nó MQ . Especifique o nome do projeto de política e a política no formato {policyProjectName}:PolicyName.Se uma política MQEndpoint for especificada, os valores de propriedade que são configurados na política são usados no tempo de execução. As propriedades que são configuradas na política substituem as propriedades correspondentes que são configuradas na guia do MQ Connection. Se uma política MQEndpoint não for especificada, então valores de propriedade que são configurados na guia Conexão MQ são usados. Se nenhuma política MQEndpoint for especificada, e a propriedade Connection na guia Conexão MQ for definida como gerenciador de filas locais sem gerenciador de filas especificado (o estado padrão), então o nó MQ usa os detalhes de conexão para o gerenciador de filas que foi especificado para o servidor de integração. Se nenhum gerenciador de filas foi especificado para o servidor de integração, então o fluxo de mensagens não será implementado. |
Se uma política MQEndpoint for especificada, quaisquer propriedades equivalentes configuradas na guia Conexão do MQ serão ignoradas no tempo de execução (consulte Política MQEndpoint).
| Propriedade | M | Padrão | Descrição |
|---|---|---|---|
| Eventos | Não | Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Use Add, Edite Delete para criar, alterar ou excluir eventos de monitoramento para o nó. É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado. |
Propriedades Configuráveis
A tabela a seguir descreve as propriedades do nó que são configuráveis (é possível alterar o valor da propriedade ao incluir o fluxo de mensagens no arquivo BAR para implementação usando o comando mqsiapplybaroverride). A tabela mapeia propriedades do nó do fluxo de mensagens para as propriedades correspondentes do comando mqsiapplybaroverride.
Para obter mais informações sobre as propriedades configuráveis, consulte Propriedades configuráveis em um arquivo BAR
Tabela de propriedades configuráveis
| Propriedade | mqsiapplybaroverride propriedade de comando |
|---|---|
| Nome da fila | queueName |
| Connection | Conexão |
| Nome do gerenciador de filas de destino | destinationQueueManagerName |
| Nome do host do gerenciador de filas | queueManagerHostname |
| Número da porta do listener | listenerPortNumber |
| Nome do canal | channelName |
| Identidade de Segurança | securityIdentity |
| Usar SSL | useSSL |
| Nome do peer SSL | SSLPeerName |
| Especificação de código SSL | SSLCipherSpec |
| Token de serialização | serializationToken |
| propriedade Topic | topicProperty |
| Validar | validateMaster |
| Nível do componente | componentLevel |
| Instâncias Adicionais | additionalInstances |
| Política | policyUrl |