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:
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.
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:
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.
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ó.
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.
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:
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.
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.
<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.
|
|
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:
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:
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:
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:
|
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. |
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.
|
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 |
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. |