Use o nó TCPIPServerOutput para criar uma conexão do servidor com um soquete TCP/IP bruto e para enviar dados através da conexão para um aplicativo externo.
O nó TCPIPServerOutput atende em uma porta TCP/IP e aguarda um nó cliente fazer uma conexão com a porta. Quando o nó cliente se conecta à porta, o nó de servidor cria uma conexão para o cliente. 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 TCPIPServer padrão para determinar quais atributos são utilizados para a conexão do 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.
Quando a conexão tiver sido estabelecida, os dados serão enviados. Se os dados não tiverem sido enviados com êxito dentro do limite de tempo especificado pela propriedade Tempo limite para enviar um registro de dados do nó, 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.
Propriedades no ambiente local podem substituir a conexão TCP/IP usada pelo nó.
Local no Ambiente Local | Descrição |
---|---|
$LocalEnvironment/Destination/TCPIP/Output/Hostname | O nome do host utilizado para fazer uma conexão. |
$LocalEnvironment/Destination/TCPIP/Output/Port | O número da porta utilizado para fazer uma conexão. |
$LocalEnvironment/Destination/TCPIP/Output/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/Destination/TCPIP/Output/ReplyId | O ID de Resposta que está armazenado nesta conexão. Pode ser qualquer cadeia de texto. |
$LocalEnvironment/Destination/TCPIP/Output/Timeout | O valor de tempo limite usado ao enviar dados à conexão do servidor TCP/IP. Este valor substitui a propriedade Tempo limite ao enviar um registro de dados especificada no nó. |
É possível selecionar dinamicamente os detalhes da conexão (nome do host e número da porta) e a conexão utilizada (ID) por meio dessas propriedades. 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. Esse comportamento pode ser utilizado para armazenar IDs de Resposta de outros nós TCPIP ou de outros transportes, como WebSphere MQ.
A saída do nó contém as mesmas informações que a entrada, e quaisquer campos que estavam ausentes na entrada serão atualizados com detalhes da conexão utilizada. Por exemplo, se a propriedade Id não for fornecida como entrada (porque você deseja criar uma conexão ou reutilizar uma conexão do conjunto), o ambiente local de saída conterá o ID da conexão que é usada.
Local no Ambiente Local | Descrição |
---|---|
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/Hostname | O nome do host utilizado para fazer uma conexão. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/Port | O número da porta utilizado para fazer uma conexão. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/OpenTimestamp | O registro de data e hora em que a conexão foi aberta pela primeira vez |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/CloseTimestamp | O registro da data e hora em que a conexão foi fechada (nulo se ainda não estiver fechada). |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/SequenceNumber | O número de seqüência da mensagem recebida nesta conexão. O primeiro registro tem um número de sequência 1, o segundo registro tem um número de sequência 2, e assim por diante. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/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/WrittenDestination/TCPIP/Output/ConnectionDetails/ReplyId | O ID de Resposta que está armazenado nesta conexão. Pode ser qualquer cadeia de texto. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/ClientDetails/Hostname | O nome completo do domínio do computador a partir do qual o cliente conectou-se. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/ClientDetails/Address | O endereço IP do computador a partir do qual o cliente conectou-se. |
Se a conexão for fechada (ou ocorrer qualquer outro tipo de exceção) ao utilizar o transporte TCP/IP, será emitida uma exceção. Essa exceção vai para o terminal Failure se ele estiver conectado, caso contrário, ela retorna ao fluxo de mensagens.
O nó também possui um terminal de entrada Close. Se uma mensagem for enviada para este terminal, a conexão será fechada utilizando uma combinação dos detalhes fornecidos no nó e no ambiente local.
O nó TCPIPServerOutput está contido no repositório TCPIP da paleta e é representado no ambiente de trabalho 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.
Ao colocar uma instância do nóTCPIPServerOutput em um fluxo de mensagens, é possível configurá-la (para obter mais informações, consulte Configurando um Nó do Fluxo de Mensagens). As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco naquela visualização.
Para configurar o nó TCPIPServerOutput:
Os terminais do nó TCPIPServerOutput são descritos na tabela a seguir.
Terminal | Tipo | Descrição |
---|---|---|
In | Dados de entrada | O terminal de entrada que aceita a mensagem para processamento pelo nó. |
Fechar | Controle de Entrada | O terminal de entrada para o qual uma mensagem será roteada quando a conexão especificada no ambiente local for fechada. |
Saída | dados de saída | O terminal de saída para o qual a mensagem será roteada se for enviada com êxito para um recurso externo. A mensagem recebida no terminal In é propagada para o terminal Out e permanece inalterada, exceto pela inclusão de informações de status. |
Fechar | Controle de saída | O terminal de saída para o qual uma mensagem propagada do terminal de entrada Close será roteada. |
Failure | dados de saída | O terminal de saída para o qual a mensagem será roteada se for detectada uma falha no nó. |
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).
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | TCPIPServerOutput | O nome do nó. |
Descrição Breve | 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ó TCPIPServerOutput 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 para envio de um registro de dados (segundos) | SIM | SIM | 60 | Especifica por quanto tempo o nó aguardará ao tentar enviar dados. É possível especificar qualquer período de tempo em segundos. | timeoutSendingData |
As propriedades Avançadas do nó TCPIPServerOutput 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 saída após o envio de um registro | SIM | Não | Desmarcada | Especifica se o fluxo de saída será fechado logo após o envio dos dados. Por padrão, esta propriedade não será selecionada. |
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:
|
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:
|
Enviar para: | SIM | Não | Uma Conexão | Especifica
se os dados devem ser enviados para uma conexão ou para todas as conexões disponíveis. As opções válidas são:
|
As propriedades Pedido do nó TCPIPServerOutput são descritas na tabela a seguir:
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Local dos dados | SIM | Não | $Body | O local na árvore de mensagens de entrada que contém o registro a ser gravado. |
Local da Porta | SIM | Não | $LocalEnvironment/Destination/TCPIP/Output/Port | O local do elemento de mensagem que contém a porta. |
ID | SIM | Não | $LocalEnvironment/Destination/TCPIP/Output/Id | O local do elemento de mensagem que contém o ID. |
Local do ID de Resposta | SIM | Não | $LocalEnvironment/Destination/TCPIP/Output/ReplyId | O local do elemento de mensagem que contém o ID de Resposta. |
As propriedades Registros e Elementos do nó TCPIPServerOutput são descritas na tabela a seguir:
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Definição do registro | SIM | Não | O registro são dados não modificados | Esta propriedade controla como os registros
derivados da mensagem são gravados. As opções válidas são:
|
Comprimento (bytes) | SIM | Não | 0 | O comprimento necessário do registro de saída. Esta propriedade se aplica apenas quando Definição de Registro está configurado paraRegistros são dados de comprimento fixo. |
Byte de preenchimento (hexadecimal) | SIM | Não | 20 | O byte hexadecimal de dois dígitos a ser usado para preencher mensagens curtas quando a Definição de Registro está configurada como O Registro São Dados de Comprimento Fixo. |
Delimitador | SIM | Não | Final de linha do sistema intermediário | O delimitador a ser utilizado quando Definição de Registro está configurado paraRegistros são dados delimitados. As opções válidas são:
|
Delimitador customizado (hexadecimal) | Não | Não | Nenhuma | A seqüência de bytes do delimitador a ser utilizada quando Definição de Registro é configurado paraRegistros são dados delimitados e Delimitador está configurado paraDelimitador Customizado (Hexadecimal). |
Tipo de delimitador | SIM | Não | Postfix | Essa propriedade especifica a forma na qual os delimitadores devem ser inseridos entre registros quando Definição de Registro está configurada para Registros são dados delimitados. As opções válidas são:
|
As propriedades Validação do nó TCPIPServerOutput 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 | Herdar | Essa propriedade controla se a validação ocorre. Os 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. |