Utilize o nó TCPIPServerReceive para receber dados através de uma conexão TCP/IP do servidor.
Este tópico contém as seguintes seções:
O nó TCPIPServerReceive aguarda o recebimento de dados em uma conexão TCP/IP e recupera os dados. Se a conexão for fechada, será emitida uma exceção.
Quando uma conexão for estabelecida, os dados serão enviados para o nó TCPIPServerReceive. Se o nó TCPIPServerReceive falhar em receber todos os dados dentro do tempo especificado na propriedade Tempo limite ao aguardar um registro de dados, a mensagem será enviada ao terminal Timeout; se nenhum terminal Timeout estiver conectado, uma exceção será lançada.
É possível configurar o broker para utilizar SSL para nós TCP/IP; consulte SSL e os Nós TCP/IP.
Propriedades no ambiente local podem substituir a conexão TCP/IP usada pelo nó.
Local no ambiente local para entrada no nó | Descrição |
---|---|
$LocalEnvironment//TCPIP/Receive/Hostname | O nome do host utilizado para fazer uma conexão. |
$LocalEnvironment//TCPIP/Receive/Port | O número da porta utilizado para fazer uma conexão. |
$LocalEnvironment/TCPIP/Receive/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/Receive/ReplyId | O ID de Resposta a ser armazenado nesta conexão. Este ID poderá então ser utilizado, quando os dados forem retornados em um nó de entrada. O ID de Resposta pode ser qualquer cadeia de texto. |
$LocalEnvironment/TCPIP/Receive/Timeout | O valor de tempo limite usado ao aguardar dados na conexão do servidor TCP/IP. Este valor substitui a propriedade Tempo limite ao aguardar um registro de dados especificada no nó. |
$LocalEnvironment/TCPIP/Receive/Length | O valor usado para substituir o número de bytes a serem lidos ao usar registros de tamanho fixo. Este valor substitui a propriedade Comprimento (bytes) especificada no nó. Se a propriedade Detecção de Registro for configurada com algo diferente de Comprimento Fixo, o campo do ambiente local será ignorado. Se este campo não estiver presente ou for avaliado como nulo, ele será ignorado e o valor no nó será usado. |
Essas propriedades permitem que os detalhes da conexão (nome do host e número da porta) e a conexão utilizada (ID) sejam selecionados dinamicamente. O ID de Resposta também pode ser configurado na conexão, o que permite que uma cadeia seja armazenada na conexão e apareça no ambiente local. Desta maneira, você pode armazenar IDs de Resposta a partir de outros nós TCPIP ou de outros transportes, tais como WebSphere MQ.
Quando um registro tiver sido recuperado, o campo ConnectionDetails na árvore de ambiente local será preenchido com os detalhes da conexão que está sendo usada.
Local no ambiente local para saída do nó | Descrição |
---|---|
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Type | O Servidor. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Hostname | O nome do host utilizado para fazer uma conexão. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Port | O número da porta utilizado para fazer uma conexão. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/OpenTimestamp | O registro de data e hora em que a conexão foi aberta pela primeira vez |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/CloseTimestamp | O registro da data e hora em que a conexão foi fechada (nulo se ainda não estiver fechada). |
$LocalEnvironment/TCPIP/Receive/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 é 2 e assim por diante. |
$LocalEnvironment/TCPIP/Receive/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 é 2 e assim por diante. |
$LocalEnvironment/TCPIP/Receive/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/Receive/ConnectionDetails/ReplyId | O ID de Resposta que está armazenado nesta conexão. Pode ser qualquer cadeia de texto. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Hostname | O nome completo do domínio do computador a partir do qual o cliente conectou-se. |
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Address | O endereço IP do computador a partir do qual o cliente conectou-se. |
O nó TCPIPServerReceive 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ó TCPIPServerReceive 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ó TCPIPServerReceive:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>
Se você configurar valores, e se eles 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 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 Sequência de Registros Analisados, o nó TCPIPServerReceive não determina ou limita o comprimento de um registro. 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 de mensagens descritas na amostra Sistema de Mensagens Grande para fazer melhor uso da memória disponível.
Os terminais do nó TCPIPServerReceive são descritos na tabela a seguir.
Terminal | Descrição |
---|---|
In | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
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. |
Timeout | O terminal para o qual uma mensagem é enviada quando o tempo especificado na propriedade Tempo limite para aguardar um registro de dados tiver sido excedido. O texto da mensagem é O valor de tempo limite foi excedido. |
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. |
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ó TCPIPServerReceive são descritas na tabela a seguir.
Propriedade | M | A | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | TCPIPServerReceive | 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ó TCPIPServerReceive determinam como a conexão TCP/IP é controlada e são descritas na tabela a seguir.
Propriedade | M | A | 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. Os seguintes formatos
são suportados:
|
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. 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. | timeoutWaitingForData |
As propriedades Avançadas do nó do TCPIPServerReceive determinam como o fluxo de dados é controlado e são descritas na tabela a seguir.
Propriedade | M | A | 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 ou para liberar o fluxo de entrada 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á reservado ou liberado
e retornado ao conjunto para utilização por qualquer nó de saída.
Estas opções estarão disponíveis
apenas se você não tiver selecionado a propriedade Fechar
fluxo de saída após o envio de um registro.
|
As propriedades de Pedido do nó do TCPIPServerReceive especificam o local dos dados a serem gravados. Você pode especificar as propriedades nessa guia como as expressões XPath ou ESQL. O Assistente de Conteúdo está disponível na visualização Propriedades e também no XPath Expression Builder, que pode ser executado clicando em Editar à direita de cada propriedade. As propriedades de Pedido são descritas na seguinte tabela:
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Local da Porta | SIM | Não | $LocalEnvironment/TCPIP/Receive/Port | O local do elemento de mensagem que contém a porta. Especifique o local do valor para substituir a Porta que está configurada na propriedade Detalhes da Conexão da guia Básico. Se você não especificar um local, o valor padrão será $LocalEnvironment/TCPIP/Receive/Port. |
Local do ID | SIM | Não | $LocalEnvironment/TCPIP/Receive/Id | O local do elemento de mensagem que contém o ID. Especifique o local do ID do soquete que está sendo usado. Esse identificador interno é utilizado por WebSphere Message Broker exclusivamente para identificar uma conexão. Se você não especificar um local, o valor padrão será $LocalEnvironment/TCPIP/Receive/Id. |
Local do ID de Resposta | SIM | Não | $LocalEnvironment/TCPIP/Receive/ReplyId | O local do elemento de mensagem que contém o ID de Resposta. Especifique o local do ID de Resposta que está armazenado na conexão que está sendo usada. O ID de Resposta pode ser utilizado quando os dados forem retornados em um nó de entrada. Se você não especificar um loca, o valor padrão será $LocalEnvironment/TCPIP/Receive/ReplyId. |
Local da duração do registro | Não | Não | $LocalEnvironment/TCPIP/Receive/Length | O local do elemento de mensagem que contém a duração do registro a ser lida. Especifique o local do valor para substituir a propriedade Comprimento (bytes) na guia Registros e Elementos. Se você não especificar um local, o valor-padrão será $LocalEnvironment/TCPIP/Receive/Length. |
As propriedades de Resultado do nó do TCPIPServerReceive determinam onde a resposta deve ser armazenada e são descritas na tabela a seguir:
Propriedade | M | A | Padrão | Descrição |
---|---|---|---|---|
Local de dados de saída | Não | Não | $OutputRoot | O local de início na árvore de mensagens de saída no qual os elementos
analisados a partir da cadeia de bits da mensagem estão armazenados. Consulte o Combinando uma Mensagem de Resultado com uma Mensagem Recebida. |
Copiar ambiente local | Não | Não | Selecionada | Especifica se o ambiente local será copiado na mensagem de saída.
|
As propriedades de Análise da Mensagem de Entrada do nó do TCPIPServerReceive determinam como analisar a mensagem recebida.
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>
Se você configurar valores, e se eles forem diferentes dos valores no cabeçalho MQRFH2, os valores no cabeçalho MQRFH2 terão precedência.
As propriedades Análise de Mensagem de Entrada do nó TCPIPServerReceive são descritas na tabela a seguir.
Propriedade | M | A | 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ó TCPIPServerReceive são descritas na tabela a seguir.
Propriedade | M | A | 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:
|
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ó do TCPIPServerReceive especificam como os dados são interpretados como registros e são descritas na seguinte tabela:
Propriedade | M | A | Padrão | Descrição |
---|---|---|---|---|
Detecção de registro | SIM | Não | Conexão Fechada | O mecanismo utilizado para identificar registros nos dados de entrada.
|
Comprimento (bytes) | SIM | Não | 0 | Se você configurar a Detecção
de Registro como Comprimento Fixo,
use Comprimento para especificar o
comprimento necessário do registro de saída em bytes. 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 Sequência de Registros Analisados, o nó TCPIPServerReceive não determina ou limita o comprimento de um registro. 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 de mensagens descritas na amostra Sistema de Mensagens Grande para fazer melhor uso da memória disponível. |
Delimitador | SIM | Não | Final de linha do DOS ou do UNIX | Se você configurou Detecção de Registro para Delimitado, utilize Delimitador para especificar o delimitador que deverá
ser utilizado. Escolha a partir das seguintes opções:
|
Delimitador customizado (hexadecimal) | Não | Não | O byte ou bytes do delimitador a serem usados quando a detecção de registro Delimitada e o Delimitador Customizado (Hexadecimal) são selecionados. Esta propriedade é obrigatória somente se a propriedade Delimitador estiver configurada como Delimitador Customizado (Hexadecimal). 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). | |
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:
O nó TCPIPServerReceive 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. Esta propriedade será ignorada, a menos que a propriedade Delimitador seja configurada para Delimitador Customizado (Hexadecimal). |
As propriedades Validação do nó TCPIPServerReceive são descritas na tabela a seguir.
Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.
Propriedade | M | A | 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. Você pode configurar essa propriedade
somente se configurar Validar como Conteúdo ou Conteúdo
e Valor. Os valores válidos são:
|
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. |