WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

MQInput

Utilize o nó MQInput para receber mensagens de clientes que se conectam ao broker utilizando o WebSphere MQ Enterprise Transport, e que utilizam as interfaces de programação de aplicativos MQI e AMI.

Este tópico contém as seguintes seções:

Finalidade

O nó MQInput recebe uma mensagem de uma fila de mensagens WebSphere MQ que é definida no gerenciador de filas do broker. O nó utiliza MQGET para ler uma mensagem de uma fila específica, 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.

Os fluxos de mensagens que manipulam as mensagens recebidas entre conexões do WebSphere MQ devem sempre ser iniciados com um nó MQInput. Você pode definir as propriedades do nó MQInput para controlar a forma pela qual as mensagens são recebidas, fazendo com que opções MQGET apropriadas sejam definidas. 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 mensagem:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Se você incluir um nó de saída em um fluxo de mensagens que inicia com um nó do MQInput, o nó de saída 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ó do 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 broker, porque é possível configurar o fluxo de mensagens para solicitar que o broker forneça qualquer conversão necessária.

Se você criar um fluxo de mensagens para utilizar como um subfluxo, não poderá utilizar um nó de entrada padrão; é necessário utilizar um nó Entrada como o primeiro nó para criar um terminal In 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 está contido no repositório da paleta do WebSphere MQ e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

 Ícone do nó MQInput

Utilizando o Nó MQInput em um Fluxo de Mensagens

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Conectando Terminais

O nó MQInput roteia cada mensagem recuperada com êxito para o terminal Out. Se esta ação falhar, a mensagem será tentada novamente. 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 ao terminal de falha, a mensagem será gravada na fila de restauração.

Se a mensagem for capturada por esse nó após a emissão de uma exceção no fluxo de mensagens, a mensagem será roteada para o terminal de captura (Catch). Se você não tiver conectado o terminal de captura, a mensagem entrará em loop contínuo através do nó, até que o problema seja resolvido.

Defina uma fila de restauração ou uma fila de devoluções (DLQ) para impedir o loop contínuo da mensagem através do nó.

Configurando para Transações Coordenadas

Ao incluir um nó MQInput em um fluxo de mensagens, o valor configurado para Modo de transação define se as mensagens são recebidas sob um ponto de sincronização:
  • Se você configurar a propriedade como Automático, a mensagem será recebida sob o ponto de sincronização, se a mensagem que chega estiver marcada como persistente; caso contrário, ela não será recebida sob o ponto de sincronização. Qualquer mensagem enviada subsequentemente por um nó de saída é colocada no ponto de sincronização, conforme determinado pela propriedade de persistência de entrada, a menos que o nó de saída tenha substituído essa propriedade explicitamente.
  • Se você configurar a propriedade como Sim (o padrão), a mensagem será recebida sob o ponto de sincronização; ou seja, em uma unidade de trabalho do WebSphere MQ. Qualquer mensagem enviada subsequentemente por um nó de saída na mesma instância do fluxo de mensagens será colocada no ponto de sincronização, a menos que o nó de saída tenha substituído isto explicitamente.
  • Se você configurar a propriedade para Não, a mensagem não será recebida no ponto de sincronização. Qualquer mensagem envida subsequentemente por um nó de saída no fluxo de mensagens não será colocada no ponto de sincronização, a menos que um nó de saída individual tenha especificado que a mensagem deve ser colocada no ponto de sincronização.
O nó MQOutput é o único nó de saída que pode ser configurado para substituir esta opção.

Se você configurar a propriedade Apenas Procura, o valor configurado para a propriedade Modo de transação será ignorado, porque uma mensagem não pode ser procurada sob o ponto de sincronização. Entretanto, quaisquer mensagens derivadas que são propagadas posteriormente por um nó de saída na mesma instância do fluxo de mensagens seguem o comportamento que é descrito anteriormente, de acordo com o valor de Modo de Transação especificado.

Tamanho do buffer MQGET

O tamanho do buffer MQGET é implementado internamente pelo intermediário e não é possível alterá-lo. A descrição a seguir é apenas 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 for inicializado, ele configurará o tamanho do buffer padrão do primeiro MQGET para 4 KB. O nó MQInput monitora o tamanho das mensagens e aumenta ou reduz o tamanho do buffer:

  1. 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.
  2. 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 colocar um nó MQInput em um fluxo de mensagens, você poderá usar a visualização das propriedades para configurar o nó; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias que não tiverem um valor padrão definido serão marcadas com um asterisco.

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 um ocorrer 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 (marcada com um asterisco 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 ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó MQInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não O tipo de nó, MQInput O nome do nó.
Short description 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.

As propriedades Básicas do nó MQInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
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. É necessário predefinir esta fila do WebSphere MQ para o gerenciador de filas que hospeda o intermediário no qual o fluxo de mensagens é implementado. queueName

As propriedades Análise de Mensagem de Entrada do nó MQInput são descritas na tabela a seguir.

Se a mensagem recebida tiver um cabeçalho MQRFH2, você não precisa configurar valores para as propriedades de Análise da Mensagem de Entrada porque os valores são derivados da pasta <mcd> no cabeçalho MQRFH2; por exemplo:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>
Se você configurar valores, e esses valores diferirem daqueles no cabeçalho MQRFH2, e o elemento <Msd> for um domínio válido, os valores no cabeçalho MQRFH2 terão precedência.
Propriedade M A O padrão Descrição
Domínio de mensagem Não 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 Desmarcada O nome do local do arquivo de esquema do modelo de mensagem no qual a mensagem é definida. Essa lista é preenchida com todos os arquivos de esquema de modelo de mensagem disponível para o domínio de mensagem selecionado.
Message Não Não Desmarcada O nome ou local da raiz de mensagem em seu arquivo de 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 Desmarcada 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. Essa 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 esta propriedade como XML ou SAP ALE IDoc. Configure esta propriedade como SAP ALE IDoc quando precisar analisar um fluxo de bits a partir de uma origem externa e gere uma árvore de mensagens.

As propriedades das Opções do Analisador para o nó MQInput são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Cronometragem de análise (Parse timing) 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.

Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas. Para que a mensagem seja analisa imediatamente, consulte Analisando On Demand.

Utilizar analisador compacto MQRFH2C para cabeçalho MQRFH2 Não Não Limpo 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 Limpo 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 Limpo 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 informações adicionais, consulte Manipulando Mensagens no Domínio XMLNSC.
Reter conteúdo misto Não Não Limpo 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 Limpo 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 Limpo 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 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.

As propriedades Avançadas do nó MQInput são descritas na tabela a seguir. Configure estas propriedades para determinar como a mensagem é processada, como suas características transacionais. Muitas destas propriedades mapeiam para opções na chamada MQGET.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Modo de Transação Sim Não 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.
  • Se você selecionar Automático, a mensagem que chega será recebida sob o ponto de sincronização, se estiver marcada como persistente; caso contrário, ela não será recebida sob o ponto de sincronização. A transacionalidade de todas as mensagens derivadas, enviadas subsequentemente por um nó de saída, é determinada pela propriedade de persistência de entrada, a menos que o nó de saída tenha substituído explicitamente a transacionalidade.
  • Se você selecionar Sim, a mensagem que chega será recebida no ponto de sincronização. Todas as mensagens derivadas, enviadas subsequentemente por um nó de saída na mesma instância do fluxo de mensagens, são enviadas de forma transacional, a menos que o nó de saída tenha substituído explicitamente a transacionalidade.
  • Se você selecionar Não, a mensagem que chega não será recebida no ponto de sincronização. Todas as mensagens derivadas que são enviadas subsequentemente por um nó de saída no fluxo de mensagens são enviadas de forma não transacional, a menos que o nó de saída tenha especificado que as mensagens devam ser colocadas sob o ponto de sincronização.
 
Modo de ordem Sim Não 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 vários encadeamentos lerem a fila de entrada. Os valores válidos são:
  • Padrão. As mensagens são recuperadas na ordem definida pelos atributos da fila, mas esta ordem não é garantida, porque as mensagens são processadas pelo fluxo de mensagens.
  • Por ID do Usuário. As mensagens que têm o mesmo valor UserIdentifier no MQMD são recuperadas e processadas na ordem definida pelos atributos de fila; é garantido que essa ordem será preservada quando as mensagens forem processadas. Uma mensagem associada a um determinado identificador de usuários que está sendo processado por um encadeamento é totalmente processada antes que o mesmo encadeamento, ou outro, possa começar a processar outra mensagem com o mesmo identificador de usuários. Assegure-se de que cada mensagem tenha um ID de mensagem exclusivo no MQMD da mensagem recebida. Nenhuma outra ordem tem garantia de ser preservada.
  • Por Ordem de Fila. As mensagens são recuperadas e processadas por esse nó na ordem definida pelos atributos de fila; essa ordem terá garantia de ser preservada quando as mensagens forem processadas. Esse comportamento é idêntico ao comportamento que é exibido se a propriedade de fluxo de mensagens Instâncias Adicionais for definida como zero. No entanto, se você configurar Modo de ordem como Por Ordem de Fila, reimplemente o fluxo de mensagens; as instâncias adicionais que já estão em execução não são liberadas. Portanto, ao configurar Modo de ordem como Por Ordem de Fila, pare e reinicie o fluxo de mensagens, ou execute o comando mqsireload para o grupo de execução depois de reimplementar o fluxo.
  • Definido pelo Usuário. Você pode especificar um elemento de mensagem usando a propriedade Local do Campo de Ordem.

Para obter mais detalhes sobre como usar essa opção, consulte Otimizando o Rendimento do Processamento do Fluxo de Mensagens e Recebendo Mensagens em um Grupo de Mensagens do WebSphere MQ.

 
Local do Campo de Ordem N 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.

Se o campo estiver ausente, uma exceção será lançada e a mensagem será retrocedida. Os valores NULL e vazios são processados separadamente, em paralelo.

 
Ordem Lógica Sim Não Selecionada Se você selecionar essa caixa de opções, as mensagens serão recebidas em ordem lógica, conforme definição do WebSphere 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 intermediário espera receber mensagens em grupos, e você não tiver selecionado esta caixa de opção, a ordem das mensagens de entrada não é importante, ou será necessário projetar o fluxo de mensagens para processá-las de maneira apropriada.

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 esta propriedade é mapeada estão disponíveis na seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

Para obter detalhes adicionais sobre como utilizar esta opção, consulte Recebendo Mensagens em um Grupo de Mensagens do WebSphere MQ.

 
Todas as mensagens disponíveis Sim Não Limpo 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 esta propriedade é mapeada estão disponíveis na seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

 
Corresponder ID de mensagem Não Não   Um ID da mensagem que deve corresponder ao ID da mensagem no MQMD da mensagem de entrada. Digite um mensagem de Identificador se desejar que o nó de entrada receba apenas mensagens que contenham um valor do Identificador de mensagem correspondente no campo MsgId do MQMD.

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 identificador de mensagens compatível que você inserir for menor que o tamanho do campo MsgId, Tornar-se compatível a ID de mensagem é acomodado à direita com caracteres X'00'. Essa propriedade é mapeada 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.

Mais informações sobre as opções para as quais esta propriedade é mapeada estão disponíveis na seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

 
Corresponder ID de correlação Nã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 apenas mensagens que contenham um valor do identificador de correlação correspondente no campo CorrelId do MQMD.

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'. Essa propriedade é mapeada para a opção MQMO_MATCH_CORREL_ID do MQGMO do MQI.

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 esta propriedade é mapeada estão disponíveis na seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

 
Converter Sim Não Limpo Se você selecionar essa caixa de opções, o WebSphere MQ converterá os dados na mensagem a ser recebida, em conformidade com os valores CodedCharSetId e Encoding definidos no MQMD. Selecione Converter (Convert) se desejar que o WebSphere MQ execute 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 WebSphere MQ converte a mensagem de entrada à codificação e conjunto de caracteres codificados especificados no MQMD que o nó de entrada fornece na chamada MQGET para recuperar a mensagem da fila de entrada. O intermediário utiliza a opção MQGMO_CONVERT na chamada MQGET; as regras comuns de conversão de WebSphere MQ se aplicam. Os valores especificados nas opções Converter codificação e Converter ID de conjunto de caracteres codificadossão utilizadas nos campos Codificação MsgDesc e CCSID na chamada MQGET. OWebSphere MQ pode converter a mensagem de entrada apenas se o campo Formatar for um valor interno do WebSphere MQ que identifica dados de caracteres ou se uma saída de conversão de dados existir no WebSphere MQ.

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 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 WebSphere MQ e o motivo de você escolher usar esta opção, consulte a seção Guia de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

 
Converter codificação Nã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:
  • Linux platformWindows platform546 para DOS, todos os sistemas Windows e Linux em x86
  • Linux platformUNIX platform273 para Linux no Linux em POWER, Linux em System z e todos os sistemas UNIX
  • z/OS platform785 para mensagens do z/OS que usam Decimais Compactados Binários e 273 para mensagens que usam números de pontos flutuantes IEEE
A codificação é utilizada somente nas seguintes circunstâncias:
  • Se existir uma conversão de dados do WebSphere MQ definida pelo usuário, utilize a codificação.
  • Se a saída de conversão interna do WebSphere MQ utilizar a codificação para converter mensagens em qualquer formato predefinido do WebSphere MQ.
Se você especificar um valor incorreto, nenhuma conversão será feita.

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 do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

 
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. 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 Converter ID do Conjunto de Caracteres Codificado, consulte a seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

 
Atribuir por grupo de mensagens Sim Não Limpo 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.

 
Token de serialização do z/OSn Não Não   Apenas no z/OS: Um token definido pelo usuário para suporte ao aplicativo serializado. O valor especificado deve estar de acordo com as regras para um ConnTag válido na estrutura MQCNO do WebSphere MQ. Digite um token de serialização se desejar utilizar o acesso serializado para recursos compartilhados fornecidos pelo WebSphere MQ.

O valor que você fornece para o token de serialização deve estar em conformidade com as regras descritas na seção Referência de Programação do Aplicativo do Centro de Informações Online do WebSphere MQ Versão 7.

Para obter informações adicionais sobre a serialização e o compartilhamento de filas no z/OS, consulte a seção Guia de Conceitos e Planejamento do Centro de Informações Online do WebSphere MQ Versão 7.

serializationToken
Tópico Não Sim   O tópico padrão para a mensagem de entrada. É possível associar uma mensagem a um tópico de Publicação/Assinatura utilizando esta propriedade. Você pode inserir quaisquer caracteres como o nome do tópico. Quando as mensagens são passarem pelo nó MQInput, elas são colocadas em qualquer nome de tópico digitado. (Se estiver utilizando Publicação/Assinatura, poderá efetuar assinatura em um tópico e ver as mensagens que passam pelo nó MQInput e onde foram publicadas com esse nome de tópico.) Se a mensagem recebida tiver um cabeçalho MQRFH2, você não precisará configurar um valor para a propriedade Tópico porque o valor pode ser obtido a partir da pasta <psc> no cabeçalho MQRFH2; por exemplo:
<psc><Topic>stockquote</Topic></psc>
Se você definir um valor de propriedade Tópico (Topic) e esse valor diferir do valor <Topic> no cabeçalho MQRFH2, o valor no cabeçalho MQRFH2 terá precedência.
topicProperty
Somente Procura Não Não Limpo 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 selecionar essa opção, OutputLocalEnvironment.MQ.GET.Browsed é configurado para true quando uma mensagem é propagada para o terminal de saída do nó MQInput.  
Reconfigurar tempo limite da procura (ms) Sim Sim -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.  

As propriedades Validação do nó MQInput são descritas na tabela a seguir. 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 detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Nenhuma Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum,Conteúdo e Conteúdo e Valor. validateMaster
Ação de falha Não 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.  

As propriedades Segurança do nó MQInput são descritas na tabela a seguir. Configure valores para estas propriedades para controlar a extração de uma identidade de uma mensagem (quando um perfil de segurança estiver associado ao nó). Para obter informações adicionais sobre estas propriedades, consulte Identidade, Configurando a Extração de uma Identidade ou Token de Segurança, Visão Geral de Segurança do Fluxo de Mensagens e Configurando a Segurança do Fluxo de Mensagens.

Propriedade M C Padrão Descrição
Tipo de token de identidade Não Não Nenhuma Essa propriedade especifica o tipo de token de identidade presente na mensagem de entrada. Os valores válidos são:
  • Padrão de Transporte
  • Nome de Usuário
  • Nome de Usuário + Senha
  • Asserção da SAML
  • Certificado X.509
Se essa propriedade não for especificada, a identidade será recuperada dos cabeçalhos de transporte e o tipo será configurado como Nome do Usuário.
Local do token de identidade Não Não Nenhuma 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 uma cadeia literal. Se você usar uma cadeia literal, ela deverá ser colocada entre aspas simples e não deverá 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 Não Nenhuma 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 uma cadeia literal. Se você usar uma cadeia literal, ela deverá ser colocada entre aspas simples e não deverá conter um ponto (.). Se 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 Não Nenhuma Esta propriedade especifica uma cadeia 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 uma cadeia literal. Se você usar uma cadeia literal, ela deverá 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 cadeia MQ será utilizada.
Tratar exceções de segurança como exceções normais Não Não False 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.
As propriedades Instâncias do nó MQInput são descritas na tabela a seguir. Configure valores para estas propriedades para controlar as instâncias adicionais que estão disponíveis para um nó. Para obter uma descrição completa destas propriedades, consulte Propriedades Configuráveis do Fluxo de Mensagens.
Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Conjunto de instâncias adicionais Não Sim Utilizar Conjunto Associado ao Fluxo de Mensagens O conjunto do qual as instâncias adicionais são obtidas.
  • Se você selecionar Utilizar Conjunto Associado ao Fluxo de Mensagens, as instâncias adicionais serão obtidas do valor do fluxo de mensagens.
  • Se você selecionar Utilizar Conjunto Associado ao Nó, as instâncias adicionais são alocadas das instâncias adicionais do nó, com base no número especificado na propriedade Instâncias Adicionais.
componentLevel
Instâncias Adicionais Não Sim 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ó. additionalInstances
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum 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. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:15


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04560_