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