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

TCPIPClientInput

Utilize o nó TCPIPClientInput para criar uma conexão do cliente com um soquete TCP/IP 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ó TCPIPClientInput abre conexões com um aplicativo de servidor remoto que está atendendo em uma porta TCP/IP. As conexões não são feitas diretamente pelo nó, mas obtidas de um conjunto de conexões gerenciado pelo grupo de execução WebSphere® Message Broker. O grupo de execução utiliza o serviço configurável TCPIPClient padrão para determinar quais atributos são utilizados para a conexão de soquete. No entanto, se o serviço configurável estiver configurado no nó, esse serviço será utilizado para todas as propriedades, incluindo o host e número da porta.

É 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 pelo conjunto de conexões, ela é enviada para um nó TCPIPClientInput (se o terminal Open do nó estiver conectado). O evento de entrada é enviado a apenas um nó TCPIPClientInput na conexão.

O nó solicita uma conexão do cliente que contém dados prontos para leitura. Até que essa conexão esteja disponível, o nó ficará pausado aguardando dados (de maneira semelhante ao nó MQInput). Portanto, dois critérios devem ser atendidos antes de o nó tornar-se ativo:
  • Uma conexão do cliente deve ser feita
  • Pelo menos um byte de dados está disponível para ser processado

Por padrão (conforme configurado no serviço configurável), nenhuma conexão do cliente é feita pelo nó de entrada. Este nó depende da criação de conexões do cliente por nós de saída ou de pedido. Neste modo de operação, um nó de entrada nunca é iniciado até que um nó de saída ou de pedido inicie uma interação.

O modo pode ser alterado no serviço configurável para criar um conjunto de conexões do cliente prontas para processamento. Para utilizar esta função, minimumConnections deve ser configurado como um valor maior que zero. O grupo de execução então assegura que o número especificado de conexões estejam sempre disponíveis, criando-as na inicialização e continuando a criá-las até que o valor mínimo seja atingido.

Este comportamento é diferente do nó TCPIPServerInput , que não tenta fazer um número mínimo de conexões. Para obter informações adicionais, consulte Nó TCPIPServerInput.

O nó cliente também possui um valor máximo, que limita quantas conexões ele pode criar. Pode haver mais conexões do que o valor mínimo como resultado de nós de saída criando conexões.

Quando conexões estão disponíveis, o segundo critério é atendido quando há pelo menos um byte de dados para ser processado; caso contrário, a conexão é fechada. Em qualquer caso, a conexão será concedida ao nó e o evento será processado.

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 cliente.
$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. um identificador interno utilizado pelo broker de mensagem para identificar exclusivamente uma conexão.
$LocalEnvironment/TCPIP/Input/ConnectionDetails/ReplyId O ID de Resposta que foi armazenado nesta conexão. O valor pode ser qualquer cadeia de texto.

Quando o nó tiver construído o registro a partir do fluxo da conexão, ele liberará a conexão de volta para o conjunto de conexões para utilização por outros nós. As propriedades na guia Avandaço mostrans como a conexão pode ser utilizada por outro nó no futuro. Por padrão, as propriedades Avançadas marcam o fluxo de entrada na conexão TCP/IP como reservado, o que significa que nenhum outro nó de entrada pode utilizá-lo até o uso atual do fluxo de mensagens ser concluído. Alternativamente, é possível reservar a conexão até ela ter a reserva cancelada por outro nó ou não reservá-la de jeito nenhum e permitir que qualquer outro nó (ou encadeamento neste nó) use a conexão imediatamente. Opções semelhantes estão disponíveis no fluxo de saída, mas são mantidas como não reservadas, por padrão.

Outro nó pode acessar um fluxo reservado apenas se o ID da conexão for conhecido. permite que todos os nós em um fluxo de mensagens acessem a mesma conexão utilizando o mesmo ID, enquanto impedem que qualquer outro fluxo adquira a conexão.

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

Ícone do nó TCPIPClientInput

Estrutura da mensagem

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

Utilizando o Nó TCPIPClientInput em um Fluxo de Mensagens

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

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ó TCPIPClientInput

Quando tiver colocado uma instância do nó TCPIPClientInput 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ó TCPIPClientInput:

  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 TCP/IP é controlada.
    • Utilize a propriedade Detalhes da Conexão para especificar o nome do host e o número da porta a serem utilizados, ou o nome de um 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 a porta e o nome do host em serviços configuráveis. Por exemplo, TCPIPProfile1.
      • <Nome do Host>:<Porta>. Este valor é o nome do host seguido do número da porta (separado por dois pontos). Por exemplo, tcpip.server.com:1111.
      • <Porta>. Este valor é o número da porta. Neste caso, o nome do host é assumido como localhost.
    • 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 reservar o fluxo de entrada para ser utilizado apenas por nós de entrada e recebimento que especificam o ID da conexão ou para liberar o fluxo de entrada 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 correto. 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 LocalEnvironment 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ê configurar valores diferentes daqueles 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. O padrão é Determinado pelo sistema broker. Você pode escolher a partir das seguintes opções:
      • Little Endian, com IEEE Floating Point (546)
      • Big Endian, com IEEE Floating Point (273)
      • Big Endian, com S390 Floating Point (785)
      • Determinado pelo Sistema Broker
      Para obter informações adicionais sobre codificação, consulte Conversão de Dados.
  5. Na subguia Opções do Analisador:
    • 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.
    • 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 o seguinte processamento de repetição:
    • Mecanismo de Repetição determina a ação que ocorre se o fluxo falhar. As seguintes opções podem ser configuradas:
      • 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 em 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ções foi alcançado, o nó utiliza o Intervalo de Repetição Longa entre as tentativas.
    • Especifique o Limite de Repetição. 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 ou Repetição Curta e Repetição Longa.
    • Especifique o Intervalo de Repetição Curto. O período de tempo, em segundos, a aguardar entre novas tentativas curtas.
    • Especifique o Intervalo de Repetição Longa. 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, exceto possivelmente um registro final menor no arquivo.
      • Selecione Delimitado se os registros que você está processando estiverem separados ou tiverem sido finalizados por um final de linha do DOS ou UNIX ou por uma sequência dos bytes do delimitador definido 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 que é especificado no Domínio de Mensagem. O nó propaga cada registro reconhecido como uma mensagem separada. Se você selecionar esta opção de 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 Conexão Fechada, Comprimento Fixo ou Delimitado, um limite de 100 MB se aplicará ao comprimento dos registros. Se você configurar Detecção de Registro para Sequencia de Registros Analisados, o nó TCPIPClientInput não determina ou limita o comprimento de um registro. Os nós que são recebidos no fluxo de mensagens podem tentar determinar a duração do registro ou processar um registro longo. Se você tiver a intenção de processar registros grandes dessa forma, assegure que seu broker tenha memória suficiente. Talvez você tenha que aplicar as técnicas de fluxo descritas na amostra Sistema de Mensagens Grande para utilizar melhor a memória disponível; consulte Large Messaging.

      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.

    • Se você configurou Detecção de Registro para Delimitado, utilize Delimitador para especificar o delimitador que deverá ser utilizado. Escolher entre:
      • 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 aparecerem no mesmo registro, o nó reconhece ambas como delimitadores. O nó não reconhece X'15' que, nos sistemas z/OS , é o byte 'newline'; especifique um valor Delimitador Customizado nessa propriedade e um valor 15 na propriedade Delimitador Customizado se seu arquivo de entrada for codificado utilizando novas linhas EBCDIC de um sistema files from a z/OS.
      • Delimitador Customizado, que permite que uma seqüência de bytes seja especificada em Delimitador Customizado.
    • Em Delimitador Customizado, o byte ou os bytes do delimitador a serem utilizados quando Delimitador Customizado estiver definido na propriedade Delimitador. 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ê especificar Delimitado em Detecção de registro, utilize Tipo de Delimitador para especificar o tipo de delimitador. Os valores permitidos são:
      • Infix. Se você selecionou esse valor, cada delimitador separa os registros. Se os dados terminarem com um delimitador, os dados (comprimento zero)após o delimitador final ainda são propagados, embora não contenha 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ó TCPIPClientInput 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 mais informações sobre como completar essa guia, consulte Propriedades da Guia Validação.
  9. Na guia Transações, configure o modo de transação. Embora operações TCP/IP 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. 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 exibem as instâncias adicionais (encadeamentos) que estão disponíveis para um nó. Para saber detalhes adicionais, consulte a seção Propriedades Configuráveis do Fluxo de Mensagens.

Terminais e Propriedades

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

Terminal Descrição
Aberto O terminal de saída para o qual uma mensagem é roteada quando uma conexão é aberta pela primeira vez. 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.

A conexão associada à mensagem é reservada a partir do conjunto de conexões geral até a propagação para o terminal Open ser concluída. Entretanto, a conexão pode ser acessada usando o connectionId especificado no ambiente local. Cada conexão que é criada é enviada ao terminal Open, incluindo quaisquer conexões criadas durante o fluxo por um nó TCPIPClientReceive ou nó TCPIPClientOutput.

Se o terminal Open não estiver conectado, os eventos de abertura serão disponibilizados automaticamente no conjunto de conexões.

Failure O terminal de saída para o qual a mensagem é encaminhada se um ocorrer erro. Este valor inclui 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.
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 no recebimento de dados 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 se você precisar inserir um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando você incluir o fluxo de mensagens no arquivo BAR para implementação).

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

Propriedade M P Padrão Descrição
Nome do Nó Não Não TCPIPClientInput 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ó TCPIPClientInput 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 nome do host e número da porta a serem 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ó TCPIPClientInput 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 Fim 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. Esta propriedade não é selecionada por padrão.
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 ou para liberá-lo no final do fluxo. As opções válidas são:
  • Deixar Inalterado
  • Reservar fluxo de entrada (para utilização pelos futuros nós TCPIP)
  • Reservar fluxo de entrada (para utilização pelos futuros nós TCPIP) e então liberar ao final do fluxo
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 LocalEnvironment 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ó TCPIPClientInput 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 que você selecionou.  
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 Intermediário 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 Sistema Intermediário Determinado 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 Intermediário 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ó TCPIPClientInput 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 têm 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ó TCPIPClientInput 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 (Hexadecimal)
Delimitador customizado (hexadecimal) Não Não   Os bytes do delimitador, expressos em hexadecimal, quando a detecção de registro Delimitado e Delimitador Customizado estã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ó TCPIPClientInput 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ções curtas Não Sim 0 O intervalo, em segundos, entre cada repetição, se Limite de Repetição não for zero. shortRetryInterval
Intervalo de repetições longas 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 exaurido. longRetryInterval

As propriedades Validação do nó TCPIPClientInput 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ó TCPIPClientInput 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 consistência. As opções válidas são:
  • Não
  • Sim
As propriedades Instâncias do nó TCPIPClientInput 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 Usar Conjunto Associado ao Nó, instâncias adicionais serão alocadas a partir 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:55


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