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