Use o nó TCPIPClientOutput para criar uma conexão do cliente com um soquete TCP/IP bruto e para enviar dados através dessa conexão para um aplicativo externo.
O nó TCPIPClientOutput 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.
O serviço configurável TCPIPClient é utilizado para criar um conjunto de conexões do cliente prontas para processamento. Para utilizar esta função, a propriedade 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.
O nó solicita uma conexão do cliente e, se não houver conexões disponíveis para enviar dados, o nó de saída solicitará que o conjunto crie uma nova conexão. Se a propriedade maximumConnections não tiver sido excedida, será criada uma nova conexão.
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 ao enviar um registro de dados do nó, uma exceção será lançada.
As propriedades no ambiente local podem substituir a conexão TCP/IP utilizada 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 valor é um identificador interno utilizado por WebSphere Message Broker exclusivamente para identificar uma conexão. |
$LocalEnvironment/Destination/TCPIP/Output/ReplyId | O ID de Resposta que foi 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 cliente TCP/IP. Este valor substitui a propriedade Tempo limite ao enviar um registro de dados especificada no nó. |
Esta propriedade permitem que os detalhes da conexão (nome do host e número da porta) e a conexão utilizada (ID) sejam escolhidos dinamicamente. Você também pode configurar o ID de Repetição nesta conexão. Este ID de resposta permite que uma cadeia seja armazenada na conexão e apareça no ambiente local. Esta conexão pode ser utilizada para armazenar IDs de Resposta de outros nós TCPIP ou de outros transportes, tal 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 são atualizados com detalhes da conexão usada. Por exemplo, se a propriedade Id não for fornecida como entrada (porque você deseja criar uma nova conexão ou reutilizar uma conexão do conjunto), o ambiente local de saída conterá o ID da conexão utilizada.
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 possui um número de seqüência 1; O segundo registro possui um número de seqüê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 foi armazenado nesta conexão. Pode ser qualquer cadeia de texto. |
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. Esta exceção vai para o terminal de Falha se estiver conectado, senão a exceção retorna ao fluxo.
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ó TCPIPClientOutput 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óTCPIPClientOutput 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ó TCPIPClientOutput:
Os terminais do nó TCPIPClientOutput 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 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).
Propriedade | M | P | Padrão | Descrição |
---|---|---|---|---|
Nome do Nó | Não | Não | TCPIPClientOutput | 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ó TCPIPClientOutput 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 para envio de um registro de dados (segundos) | SIM | SIM | 60 | Especifica quanto tempo o nó aguarda ao tentar enviar dados. É possível especificar qualquer período de tempo em segundos. | timeoutSendingData |
As propriedades Avançadas do nó TCPIPClientOutput 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. Esta propriedade não é selecionada por padrã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:
|
Modificação do Fluxo de Entrada | Não | Não | Deixar Inalterado | Especifica se deve reservar o fluxo de entrada
para uso apenas pelos nós de entrada e recebimento que especificam o ID
da conexão ou para liberá-lo no final do fluxo de mensagens. As opções válidas são:
|
Enviar para: | SIM | Não | Uma Conexão | Especifique se os dados devem ser enviados a uma ou todas as conexões disponíveis. As opções válidas são:
|
As propriedades Pedido do nó TCPIPClientOutput 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 do Nome do Host | SIM | Não | $LocalEnvironment/Destination/TCPIP/Output/Hostname | O local do elemento da mensagem contendo o nome do host. |
Local da Porta | SIM | Não | $LocalEnvironment/Destination/TCPIP/Output/Port | O local do elemento de mensagem que contém a porta. |
Local do 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 da mensagem contendo o ID de resposta. |
As propriedades Registros e Elementos do nó TCPIPClientOutput 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. Essa propriedade se aplica somente quando O registro são dados de comprimento fixo é especificado em Definição de Registro. |
Byte de preenchimento (hexadecimal) | SIM | Não | 20 | O byte hexadecimal de dois dígitos a ser usado para preencher mensagens curtas quando O Registro são Dados de Comprimento Fixo é especificado na Definição de Registro. |
Delimitador | SIM | Não | Final de linha do sistema intermediário | O delimitador a ser utilizado quando O registro são dados delimitados é especificado no Definição de Registro. 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 Registros são dados delimitados for especificado na propriedade Definição de Registro e Delimitador Customizado (Hexadecimal) for especificado na propriedade Delimitador. |
Tipo de delimitador | SIM | Não | Postfix | Essa propriedade especifica a forma na qual os delimitadores devem ser inseridos entre registros quando O registro são dados delimitados é especificado na Definição de Registro. As opções válidas são:
|
As propriedades Validação do nó TCPIPClientOutput 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. |