Utilize o nó TCPIPClientReceive para receber dados através de uma conexão TCP/IP do cliente.
Este tópico contém as seguintes seções:
O nó TCPIPClientReceive 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.
É 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 for estabelecida, os dados serão enviados para o nó TCPIPClientReceive. Se o nó TCPIPClientReceive falhar ao receber todos os dados dentro do tempo especificado na propriedade Tempo Limite para Aguardar um Registro de Dados, a mensagem será enviada para o terminal de tempo limite; se nenhum terminal de tempo limite estiver conectado, será emitida uma exceção.
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 cliente 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 de qualquer dado que seja recebido de volta a partir desta conexão. Esta conexão pode ser utilizada para armazenar IDs de Resposta de outros nós TCPIP ou de outros transportes, tal como WebSphere MQ.
Quando um registro tiver sido recuperado, o campo ConnectionDetails no ambiente local será preenchido com os detalhes da conexão que está sendo utilizada.
Local no ambiente local para saída do nó | Descrição |
---|---|
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Type | O cliente. |
$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. Este ID pode ser qualquer cadeia de texto. |
O nó TCPIPClientReceive 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ó TCPIPClientReceive 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ó TCPIPClientReceive:
<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 Sequencia de Registros Analisados, o nó TCPIPClientReceive 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 descritas na amostra Sistema de Mensagens Grande para utilizar melhor a memória disponível.
Os terminais do nó TCPIPClientReceive 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ó TCPIPClientReceive são descritas na tabela a seguir.
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | TCPIPClientReceive | 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ó TCPIPClientReceive 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ó TCPIPClientReceive 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 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.
As opções válidas são:
|
As propriedades Pedido do nó TCPIPClientReceive são descritas na tabela a seguir:
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Local do nome do host | Sim | Não | $LocalEnvironment/TCPIP/Receive/Hostname | O local do elemento de mensagem que contém o nome do host. |
Local da Porta | Sim | Não | $LocalEnvironment/TCPIP/Receive/Port | O local do elemento de mensagem que contém a porta. |
Local do ID | Sim | Não | $LocalEnvironment//TCPIP/Receive/Id | O local do elemento de mensagem que contém o 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. |
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 Resultado do nó TCPIPClientReceive são descritas na tabela a seguir:
Propriedade | M | P | 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 de Mensagem de Entrada do nó TCPIPClientReceive 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ó TCPIPClientReceive 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 é utilizado para mensagens no Domínio XMLNS. Se você configurar essa propriedade, os detalhes 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ó TCPIPClientReceive são descritas na tabela a seguir:
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Detecção de registro | Sim | Não | Conexão Fechada | 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 Validação do nó TCPIPClientReceive 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. 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. |