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

TCPIPServerInput

Utilize o nó TCPIPServerInput para criar uma conexão do cliente com um soquete TCPIP não processado e para receber dados através dessa conexão.

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

Propósito

O nó TCPIPServerInput atende em uma porta e, quando um soquete do cliente se conecta à porta, o soquete do servidor cria uma conexão para o cliente. Diferentemente do nó TCPIPClientInput, o nó TCPIPServerInput não tenta fazer um número mínimo de conexões, porque o final do servidor do soquete não pode iniciar novas conexões, ele pode apenas aceitá-las. O nó TCPIPServerInput aceita conexões até um valor máximo, que é especificado na propriedade MaximumConnections do serviço configurável de TCPIPServer. Por padrão, o broker pode aceitar até 100 conexões do servidor. Para obter informações adicionais, consulte o Comando mqsicreateconfigurableservice e o Comando mqsireportproperties.

É possível configurar o broker para utilizar SSL para nós TCP/IP; consulte SSL e os Nós TCP/IP.

Quando uma conexão é aberta, uma mensagem contendo detalhes da conexão é enviada ao terminal Aberto; nenhum dado é roteado para este terminal. Use o terminal Aberto se o processamento for necessário quando uma conexão for aberta em vez de quando os dados chegarem pela primeira vez. O fluxo de saída para a conexão é reservado até que a propagação da mensagem aberta tenha sido concluída (o que ocorre imediatamente se o terminal não estiver conectado a qualquer outro nó). As opções na guia Avançado do nó não se aplicam aos eventos abertos; elas são aplicáveis apenas quando os primeiros dados chegam na conexão e são propagados pelo terminal de Saída.

O primeiro registro de dados é detectado de acordo com as propriedades no nó e, em seguida, enviado ao terminal de Saída. Se um erro ocorrer, incluindo um tempo limite aguardando dados ou o fechamento de uma conexão enquanto aguarda o registro completo, os dados serão enviados para o terminal de Falha. Se a conexão for fechada e não houver dados, será enviada uma mensagem para o terminal Close. Embora a mensagem não possua dados, o ambiente local possui detalhes da conexão que foi fechada.

Para eventos de dados e de fechamento, é criado o seguinte ambiente local.

Table 1. Local no Ambiente Local
Local no Ambiente Local Descrição
$LocalEnvironment/TCPIP/Input/ConnectionDetails/Type O Servidor.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/Hostname O nome do host utilizado para fazer uma conexão.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/Port O número da porta utilizado para fazer uma conexão.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/OpenTimestamp O registro de data e hora em que a conexão foi aberta pela primeira vez
$LocalEnvironment/TCPIP/Input/ConnectionDetails/CloseTimestamp O registro da data e hora em que a conexão foi fechada (nulo se anda não estiver fehada).
$LocalEnvironment/TCPIP/Input/ConnectionDetails/SequenceNumber/InputRecord O número de seqüência da mensagem recebida nesta conexão. O primeiro registro possui um número de seqüência 1; O segundo registro possui um número de seqüência 2; e assim por diante.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/SequenceNumber/OutputRecord O número de seqüência da mensagem enviada nesta conexão. O primeiro registro possui um número de seqüência 1; O segundo registro possui um número de seqüência 2; e assim por diante.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/Id O ID do soquete que está sendo utilizado. Este ID é um identificador interno utilizado por WebSphere® Message Broker exclusivamente para identificar uma conexão.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/ReplyId O ID de Resposta que está armazenado nesta conexão. Pode ser qualquer cadeia de texto.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/ClientDetails/Hostname O nome completo do domínio do computador a partir do qual o cliente conectou-se.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/ClientDetails/Address O endereço IP do computador a partir do qual o cliente conectou-se.

O nó TCPIPServerInput está contido no repositório TCPIP da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó TCPIPServerInput

Estrutura da mensagem

O nó TCPIPServerInput manipula mensagens nos seguintes domínios de mensagem:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Utilizando o Nó TCPIPServerInput em um Fluxo de Mensagens

Examine as amostras a seguir para saber como utilizar o nó TCPIPServerInput:

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.

Configurando o Nó TCPIPServerInput

Quando tiver colocado uma instância do nó TCPIPServerInput em um fluxo de mensagens, você poderá configurá-lo; 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.

Configure o nó TCPIPServerInput:

  1. Opcional: Na guia Descrição , digite uma Descrição curta, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Básico, configure as propriedades que determinam como a conexão TCPIP é controlada.
    • Utilize a propriedade Detalhes da Conexão para especificar o número da porta que deve ser utilizado ou o nome do serviço configurável. Essa propriedade é obrigatória. Os seguintes formatos são suportados:
      • Nome do serviço configurável. Este valor é utilizado para consultar o número da porta do host em serviços configuráveis. Por exemplo, TCPIPProfile1.
      • <Porta>. Este valor é o número da porta. Por exemplo, 1111
    • Utilize a propriedade Tempo limite para aguardar um registro de dados (segundos) para especificar por quanto tempo o nó atenderá em uma conexão para mais dados após a chegada do primeiro byte de dados. É possível especificar qualquer período de tempo em segundos. O padrão é de 60 segundos. Quando o tempo especificado tiver sido excedido, todos os dados disponíveis serão enviados para o terminal de Falha.
  3. Na guia Avançado, configure as propriedades que determinam como o fluxo de dados é controlado.
    • Utilize a propriedade Fechar Conexão para especificar quando e como fechar a conexão.
      • Selecione Não para deixar a conexão aberta. Este valor é o padrão.
      • Selecione Após Tempo Limite para fechar a conexão quando ocorrer um tempo limite.
      • Selecione Após o recebimento de dados para fechar a conexão quando for atingido o final do registro.
      • Selecione No final do fluxo para fechar a conexão após a chamada do fluxo ter sido executada.
    • Selecione Fechar fluxo de entrada após o recebimento de um registro para fechar o fluxo de entrada logo após a recuperação dos dados. Quando o fluxo de entrada da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem especificar o ID. Esta propriedade não é selecionada por padrão.
    • Utilize a propriedade Modificação do Fluxo de Entrada para especificar se o fluxo de entrada será reservado para ser utilizado apenas por nós de entrada e de recebimento que especificam o ID da conexão e, neste caso, se será liberado no final do fluxo. Estas opções estarão disponíveis apenas se você não tiver selecionado a propriedade Fechar fluxo de entrada após o recebimento de um registro.
      • Selecione Deixar Inalterado para deixar o fluxo de entrada como ele estava quando entrou no nó. Esse valor é selecionado por padrão.
      • Selecione Reservar fluxo de entrada (para utilização por futuros nós de entrada e recebimento TCPIP) para especificar que este fluxo de entrada pode ser utilizado apenas por este nó e por outros nós de recebimento que o solicitam especificando o ID de conexão. Quando o fluxo de entrada da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem especificar o ID de conexão correto.
      • Selecione Reservar fluxo de entrada (para utilização por futuros nós de entrada e de recebimento TCPIP), em seguida, liberar no final do fluxo para especificar que este fluxo de entrada pode ser utilizado apenas por este nó e por nós de recebimento que o solicitam, especificando o ID de conexão. Após o fluxo ter sido executado, este fluxo de entrada é retornado ao conjunto e se torna disponível para utilização por qualquer nó de entrada ou recebimento.
    • Utilize a propriedade Modificação do Fluxo de Saída para especificar se o fluxo de saída será liberado.
      • Selecione Deixar Inalterado para deixar o fluxo de saída como ele estava quando entrou no nó. Esse valor é selecionado por padrão.
      • Selecione Liberar fluxo de saída e reconfigurar ReplyID para especificar que este fluxo de saída será retornado ao conjunto e ficará disponível para utilização por qualquer nó de saída. O ReplyID é transmitido no ambiente local ao sair deste nó, mas é reconfigurado para o próximo registro nesta conexão.
  4. Na guia Análise de Mensagem de Entrada, defina os valores para as propriedades que o nó utiliza para determinar como analisar a mensagem de entrada.
    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ê definir valores, e estes valores forem diferentes dos valores no cabeçalho MQRFH2, os valores no cabeçalho MQRFH2 terão precedência.

    • Em Domínio de Mensagem, selecione da lista o nome do analisador que está sendo utilizado. O padrão é BLOB. Você pode escolher a partir das seguintes opções:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      Também é possível especificar um analisador definido pelo usuário, se apropriado.
    • Se você estiver usando o analisador DFDL, MRM ou XMLNSC no modo de validação, selecione o modelo de mensagem relevante na lista. Essa lista é preenchida com conjuntos de mensagens disponíveis quando você seleciona MRM ou XMLNSC como o domínio de mensagem ou com arquivos de esquema DFDL disponíveis ao selecionar DFDL como o domínio de mensagem.
    • Se você estiver utilizando o analisador DFDL ou MRM, selecione a mensagem correta na lista em Mensagem. Essa lista é preenchida com mensagens definidas no modelo de mensagem que você selecionou.
    • Se você estiver utilizando o analisador MRM, selecione o formato da mensagem a partir da lista em Formato Físico. Essa lista inclui todos os formatos físicos definidos para este modelo de mensagem.
    • Especifique o ID do conjunto de caracteres codificado pela mensagem no ID do Conjunto de Caracteres Codificados pela Mensagem.
    • Selecione a codificação da mensagem na lista em Codificação da Mensagem ou especifique um valor de codificação numérico. Para obter informações adicionais sobre codificação, consulte Conversão de Dados.
  5. Na subguia Opções do Analisador:
    1. 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.
    2. Se você está utilizando o analisador XMLNSC, configure os valores para as propriedades que determinam como o analisador XMLNSC opera. Para obter informações adicionais, consulte Manipulando Mensagens no Domínio XMLNSC.
  6. Utilize a guia Repetição para definir como o processamento de repetições é desempenhado quando um fluxo falha. É possível configurar as seguintes propriedades:
    • Mecanismo de Repetição determina a ação que ocorre se o fluxo falhar. Escolha dentre os seguintes valores:
      • Selecione Falha para o nó reportar uma falha sem nenhuma tentativa de repetição.
      • Selecione Nova Tentativa Curta para o nó para tentar novamente antes de relatar uma falha se a condição persistir. O número de vezes da repetição é especificado em Limite de Repetição.
      • Selecione Nova Tentativa Curta e Nova Tentativa Longa para o nó para tentar novamente, primeiro utilizando o valor no Limite de Nova Tentativa como o número de tentativas que devem ser feitas. Se a condição persistir depois que o Limite de Repetição foi alcançado, o nó utiliza o Intervalo Longo de Repetição entre as tentativas.
    • Especifique o Limite de Novas Tentativas:O número de vezes que o nó tenta novamente a transação do fluxo se a propriedade Mecanismo de Repetição estiver configurada como Repetição Curta ouRepetição Curta e Repetição Longa.
    • Especifique o Intervalo de Repetição Curta:O período de tempo, em segundos, a aguardar entre as tentativas de repetição curtas.
    • Especifique o Intervalo de Longa Repetição:O período de tempo para aguardar entre as tentativas de repetição longa até que uma mensagem seja bem-sucedida, o fluxo de mensagens seja interrompido ou implementado novamente. A propriedade MinLongRetryInterval do broker define o valor mínimo para Intervalo de Repetição Longo. Se o valor for menor do que o mínimo, será utilizado o valor do broker.
  7. Utilize a guia Registros e Elementos para especificar como os dados são interpretados como registros.
    • Utilize a propriedade Detecção de Registro para determinar como os dados são divididos em registros, cada um deles gera uma única mensagem. Escolha a partir das seguintes opções:
      • Final de Fluxo especifica que todos os dados enviados no fluxo de dados são um único registro.
      • Comprimento Fixo especifica que cada registro é um número fixo de bytes em comprimento. Cada registro deve conter o número de bytes especificado na propriedade Comprimento .
      • Selecione Delimitado se os registros que estão sendo processados forem separados, ou finalizados por um final de linha do DOS ou do UNIX ou por uma seqüência de bytes do delimitador definidos pelo usuário. Especifique o delimitador e tipo de delimitador nas propriedades Delimitador e Tipo de Delimitador.
      • Selecione Seqüência de Registro Analisada se os dados contiverem uma seqüência de um ou mais registros que são serialmente reconhecidos pelo analisador especificado no Domínio de mensagem. O nó propaga cada registro reconhecido como uma mensagem separada. Se você selecionar a opção Detecção de Registro o analisador especificado no Domínio de Mensagem deverá ser XMLNSC ou MRM (formato físico CWF ou TDS).
    • Se você configurou Detecção de Registro para Comprimento Fixo, utilize Comprimento para especificar o comprimento necessário para o registro de saída. Esse valor deve estar no intervalo de 1 byte até 100 MB. O padrão é 80 bytes.

      Se você configurar Detecção de Registro para Fim do Fluxo, Comprimento Fixo, ou Delimitado, um limite de 100 MB é aplicado ao comprimento dos registros. Se você configurar Detecção de Registro paraSequência de Registror Analisados, o nó TCPIPServerInput não determina ou limita o comprimento dos registros. Os nós que são recebidos no fluxo de mensagens podem tentar determinar o comprimento do registro ou processar um registro longo. Se você tiver a intenção de processar registros grandes dessa forma, assegure que seu intermediário tenha memória suficiente. Talvez seja necessário aplicar as técnicas de fluxo descritas na amostra Sistema de Mensagens Grande para utilizar melhor a memória disponível.

    • Se você configurou Detecção de Registro para Delimitado, utilize Delimitador para especificar o delimitador que deverá ser utilizado. Escolha dentre os seguintes valores:
      • Final da Linha do DOS ou UNIX que, nos sistemas UNIX, especifica o caractere de avanço de linha (<LF>, X'0A') e, nos sistemas Windows, especifica um caractere de retorno de carro seguido por um caractere de avanço de linha (<CR><LF>, X'0D0A'). O nó trata ambas cadeias como delimitadores, independentemente do sistema no qual o broker está em execução. Se ambas cadeias aparecerem no mesmo arquivo, o nó reconhece ambas como delimitadores. O nó não reconhece X'15' que, em sistemas z/OS® é o byte 'newline'; especifique um valor de Delimitador Customizado nesta propriedade e um valor de 15 na propriedade Delimitador Customizado , se seus dados de entrada forem codificados utilizando novas linhas EBCDIC.
      • Delimitador Customizado, que permite que uma seqüência de bytes seja especificada em Delimitador Customizado
    • Em Delimitador Customizado, especifique o byte ou bytes delimitadores a serem utilizados quando Delimiador for configurado para Delimitador Customizado. Especifique esse valor como uma cadeia de dígitos hexadecimal com números pares. O padrão é X'0A' e o comprimento máximo da cadeia é 16 bytes (representados por 32 dígitos hexadecimais).
    • Se você configurou Detecção de Registro para Delimitado, utilize tipo de Delimitador para especificar o tipo do delimitador. Os valores permitidos são:
      • Infix. Se você selecionou esse valor, cada delimitador separa os registros. Se os dados terminarem com um delimitador (comprimento zero), os dados após o delimitador final ainda serão propagados embora não contenham dados.
      • Sufixo. Se você especificar esse valor, cada delimitador terminará os registros. Se os dados terminarem com um delimitador, nenhum registro vazio será propagado após o delimitador. Se os dados não terminarem com um delimitador, eles serão processados como se um delimitador seguisse os bytes finais dos dados. Sufixo é o valor padrão.
    • O nó TCPIPServerInput considera cada ocorrência do delimitador na entrada como separando (prefixo) ou terminando (sufixo) cada registro. Se os dados começarem com um delimitador, o nó tratará o conteúdo (comprimento zero) precedendo esse delimitador como um registro e propagará um registro vazio para o fluxo. O delimitador nunca é incluído na mensagem propagada.
  8. Utilize a guia Validação para fornecer validação com base no conjunto de mensagens para mensagens predefinidas. Para obter informações adicionais sobre validação, consulte Validando Mensagens. Para obter informações sobre como fornecer validação para essa guia, consulte Propriedades da Guia Validação.
  9. Na guia Transações, configure o modo de transação. Embora operações TCPIP sejam não transacionais, o modo de transação nesse nó de entrada determina se o restante dos nós no fluxo deve ser executado no ponto de consistência ou não. Selecione Sim se desejar que as atualizações de fluxo sejam tratadas de forma transacional (se possível) ou Não se não desejar. O padrão para esta propriedade é Não.
  10. Opcional: Na guia Instâncias configure valores para as propriedades que definem as instâncias adicionais (encadeamentos) que estão disponíveis para um nó. Para obter detalhes adicionais, consulte Propriedades Configuráveis do Fluxo de Mensagens.

Terminais e Propriedades

Os terminais do nó TCPIPServerInput são descritos na tabela a seguir.

Terminal Descrição
Failure O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. Estes erros incluem falhas causadas por processamento de repetições. Mesmo que a propriedade Validação esteja definida, as mensagens propagadas para esse terminal não serão validadas.
Abrir O terminal de saída para o qual a mensagem é roteada quando é aberta primeiro. Use o terminal Aberto se o processamento for necessário quando uma conexão for aberta em vez de quando os dados chegarem pela primeira vez.
Saída O terminal de saída para o qual a mensagem será roteada se for recuperada com êxito de um recurso externo. Se não ocorrerem erros no nó de entrada, uma mensagem recebida de um recurso externo será sempre enviada para o terminal Out primeiro.
Fechar O terminal de saída para o qual a mensagem será roteada se a conexão for fechada.
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 exceções serão capturadas somente se o terminal estiver anexado.

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ó TCPIPServerInput são descritas na tabela a seguir.

Propriedade M P Padrão Descrição
Nome do Nó Não Não TCPIPServerInput 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ó TCPIPServerInput são descritas na tabela a seguir.

Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Detalhes da Conexão SIM SIM   Uma cadeia contendo o número da porta a ser utilizado ou o nome de um serviço configurável. connectionDetails
Tempo limite de espera por um registro de dados (segundos) SIM SIM 60 Especifica por quanto tempo o nó atenderá em uma conexão por dados adicionais, após a chegada do primeiro byte de dados. É possível especificar qualquer período de tempo em segundos. timeoutWaitingForData

As propriedades Avançadas do nó TCPIPServerInput são descritas na tabela a seguir.

Propriedade M P Padrão Descrição
Fechar Conexão SIM Não Não Controla quando a conexão é fechada ou se ela permanecerá aberta. As opções válidas são:
  • Não
  • Após o Tempo Limite
  • Após o Recebimento dos Dados
  • No Final do Fluxo
Fechar fluxo de entrada após o recebimento de um registro SIM Não Não selecionada Especifica se o fluxo de entrada será fechado logo após a recuperação dos dados. Quando o fluxo de entrada da da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem saber o ID. Por padrão, esta propriedade não será selecionada.
Modificação do fluxo de entrada Não Não Deixar Inalterado Especifica se o fluxo de entrada será reservado para ser utilizado apenas por nós de entrada e de recebimento que especificam o ID da conexão e, neste caso, se será liberado no final do fluxo. As opções válidas são:
  • Deixar Inalterado
  • Reservar fluxo de entrada (para utilização por futuros nós TCPIP)
  • Reservar fluxo de entrada (para utilização por futuros nós TCPIP), em seguida, liberar após a propagação
Quando o fluxo de entrada da conexão estiver reservado, nenhum outro nó poderá utilizá-lo sem especificar o ID de conexão correto. Se o fluxo de entrada for liberado no final do fluxo, ele será retornado ao conjunto e se tornará disponível para utilização por qualquer nó de entrada ou recebimento.
Modificação do fluxo de saída Não Não Deixar Inalterado Especifica se este fluxo de saída será liberado e retornado ao conjunto para utilização por qualquer nó de saída. As opções válidas são:
  • Deixar Inalterado
  • Liberar fluxo de saída e reconfigurar ReplyID.
Se você selecionar Liberar fluxo de saída e reconfigurar ReplyID, o ReplyID será transmitido no ambiente local ao sair deste nó, mas será reconfigurado para o próximo registro nesta conexão.

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

Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Domínio de mensagem Não Não BLOB O domínio utilizado para analisar a mensagem que chega.  
Modelo de mensagem Não Não   O nome ou local do modelo de mensagem no qual a mensagem recebida é definida.  
Message Não Não   O nome ou o local de um elemento global que modela um documento de dados inteiro e está contido no arquivo de esquema do modelo de mensagem. Essa lista é preenchida com todas as mensagens disponíveis definidas no modelo de mensagem selecionado.  
Formato Físico Não Não   O nome do formato físico da mensagem que chega.  
ID do conjunto de caracteres codificados de mensagens SIM Não Sistema Broker Padrão O ID do conjunto de caracteres codificados utilizado para interpretar os dados que estão sendo lidos. messageCodedCharSetIdProperty
Codificação de mensagens SIM Não Determinado pelo Sistema Broker O esquema de codificação para números e caracteres grandes utilizado para interpretar os dados que estão sendo lidos. Os valores válidos são Determinado pelo Sistema do Broker ou um valor de codificação numérico. Para obter informações adicionais sobre codificação, consulte Conversão de Dados. messageEncodingProperty

As propriedades Opções de Analisador do nó TCPIPServerInput são descritas na tabela a seguir.

Propriedade M P 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
  • Completo

Para obter uma descrição completa desta propriedade, consulte Analisando On Demand.

Construir árvore utilizando tipos de dados de esquema XML Não Não Não selecionada Esta propriedade controla se os elementos da sintaxe na árvore de mensagens possuem tipos de dados obtidos do Esquema XML.
Utilizar analisador compacto XMLNSC para domínio XMLNS Não Não Não selecionada Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você configurar 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 cabeçalho MQRFH2 de entrada ou a propriedade Análise da Mensagem de Entrada, Domínio de Mensagem, for XMLNS.
Reter conteúdo misto Não 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 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 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 Não Branco Essa propriedade é utilizada para especificar uma lista de elementos na mensagem de entrada que devem ser analisados em segundo plano pelo analisador XMLNSC.

As propriedades Registros e Elementos do nó TCPIPServerInput são descritas na tabela a seguir:

Propriedade M P Padrão Descrição
Detecção de registro SIM Não Final de Fluxo O mecanismo utilizado para identificar registros nos dados de entrada. As opções válidas são:
  • Final de Fluxo
  • Comprimento Fixo
  • Delimitado
  • Seqüência de Registro Analisado
Comprimento (bytes) SIM Não 0 O comprimento de cada registro, em bytes, quando a detecção de registroComprimento Fixo está selecionada.
Delimitador SIM Não Final de linha do DOS ou do UNIX O tipo de bytes do delimitador que separa ou finaliza cada registro quando a detecção de registro Delimitado está selecionada. As opções válidas são:
  • Final de linha do DOS ou do UNIX
  • Delimitador Customizado.
Delimitador Customizado (hexadecimal) Não Não   Os bytes do delimitador, expressos em hexadecimal, quando a detecção de registro Delimitado e Delimitador Customizado (Hexadecimal) são selecionados. Esta propriedade é obrigatória somente se a propriedade Delimitador estiver configurada como Delimitador Customizado (Hexadecimal).
Tipo de delimitador SIM Não Postfix A posição do delimitador quando a detecção de registro Delimitado e Delimitador Customizado (Hexadecimal) são selecionados. As opções válidas são:
  • Infix
  • Postfix
Esta propriedade será ignorada, a menos que a propriedade Delimitador seja configurada para Delimitador Customizado (Hexadecimal).

As propriedades Repetição do nó TCPIPServerInput são descritas na tabela a seguir:

Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Tentar mecanismo novamente SIM Não Failure Como o nó manipula uma falha de fluxo. As opções válidas são:
  • Failure
  • Repetição Curta
  • Repetição Curta e Longa
 
Tentar limite novamente SIM SIM 0 O número de vezes para tentar novamente a transação de fluxo quando o Mecanismo de Nova Tentativa é Nova Tentativa Curta. retryThreshold
Intervalo de Repetição curto (segundos) Não SIM 0 O intervalo, em segundos, entre cada repetição, se Limite de Repetição não for zero. shortRetryThreshold
Intervalo de Repetição longo (segundos) Não SIM 300 O intervalo entre as novas tentativas se o Mecanismo de Nova Tentativa for Nova Tentativa Curta e Longa e o limite de novas tentativas tiver sido atingido. longRetryThreshold

As propriedades Validação do nó TCPIPServerInput são descritas na tabela a seguir.

Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não SIM Nenhuma Essa propriedade controla se a validação ocorre. Valores válidos são
  • Nenhuma
  • Conteúdo e Valor (Content and Value)
  • Conteúdo
validateMaster
Ação de falha Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Os valores válidos são:
  • Rastreio do Usuário
  • Local Error Log
  • Exceção
  • Lista de Exceções (Exception List)
 

As propriedades Transações do nó TCPIPServerInput são descritas na tabela a seguir:

Propriedade M P Padrão Descrição
Modo de Transação Não SIM Não O modo de transação neste nó de entrada determina se o restante dos nós no fluxo são executados no ponto de sincronização. As opções válidas são:
  • Sim
  • Não
As propriedades Instâncias do nó TCPIPServerInput são descritas na tabela a seguir. Para obter uma descrição completa destas propriedades, consulte Propriedades Configuráveis do Fluxo de Mensagens.
Propriedade M P 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 a partir do conjunto de fluxos de mensagens.
  • Se você selecionar Utilizar Conjunto Associado ao Nó, as instâncias adicionais serã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ó. 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:56


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