Utilice el nodo TCPIPClientOutput para crear una conexión de cliente para un socket TCP/IP primario y para enviar datos a una aplicación externa a través de dicha conexión.
El nodo TCPIPClientOutput abre conexiones para una aplicación de servidor remoto que esté a la escucha en un puerto TCP/IP. El nodo no realiza directamente las conexiones sino que se obtienen de una agrupación de conexiones gestionada por el grupo de ejecución de WebSphere Message Broker. El grupo de ejecución utiliza el servicio configurable TCPIPClient predeterminado cuyos atributos se utilizan para la conexión del socket No obstante, si el servicio configurable se ha establecido en el nodo, el servicio configurable se utilizará para todas las propiedades, incluidos el número de host y el de puerto.
Puede configurar el intermediario para que utilice SSL para nodos TCP/IP; consulte SSL y los nodos TCP/IP.
El servicio TCPIPClient configurable se utiliza para crear una agrupación de conexiones de cliente preparadas para su proceso. Para utilizar esta función, se ha de haber establecido la propiedad minimumConnections en un valor superior a cero. El grupo de ejecución garantizará que el número de conexiones especificado esté siempre disponible creándolas durante el arranque y creándolas hasta que se alcance el valor mínimo.
El nodo solicita una conexión de cliente y, si no hay ninguna conexión disponible para enviar datos, el nodo de salida solicita que la agrupación cree una nueva conexión. Si no se ha excedido la propiedad maximumConnections se creará una nueva conexión.
Cuando se haya establecido la conexión, se enviarán los datos. Si los datos no se han enviado correctamente dentro del límite de tiempo especificado por la propiedad Tiempo de espera para enviar un registro de datos del nodo, se genera una excepción.
Las propiedades del entorno local pueden alterar temporalmente la conexión TCP/IP utilizada por el nodo:
Ubicación en entorno local | Descripción |
---|---|
$LocalEnvironment/Destination/TCPIP/Output/Hostname | El nombre de host utilizado para realizar una conexión. |
$LocalEnvironment/Destination/TCPIP/Output/Port | El número de puerto utilizado para realizar una conexión. |
$LocalEnvironment/Destination/TCPIP/Output/Id | El ID del socket que se está utilizando. Este valor es un identificador interno utilizado por WebSphere Message Broker para identificar de forma exclusiva una conexión. |
$LocalEnvironment/Destination/TCPIP/Output/ReplyId | El ID de respuesta que se ha almacenado en esta conexión. Puede ser cualquier serie de texto. |
$LocalEnvironment/Destination/TCPIP/Output/Timeout | El valor de tiempo de espera utilizado al enviar datos a la conexión de cliente TCP/IP. Este valor prevalece sobre la propiedad Tiempo de espera excedido en el envío de un registro de datos especificado en el nodo. |
Esta propiedad le permite elegir dinámicamente los detalles de la conexión (nombre de host y número de puerto) y la conexión utilizada (ID). También puede establecer el ID de respuesta en la conexión. El ID de respuesta permite almacenar una serie de caracteres en la conexión y que aparezca en el entorno local. Puede utilizar esta conexión para almacenar ID de respuesta de otros nodos TCPIP o de otros transportes, como WebSphere MQ
La salida del nodo contiene la misma información que la entrada, más los campos que faltaran de la entrada que se actualizan con detalles de la conexión utilizada. Por ejemplo, si no se proporciona la propiedad Id como entrada (porque se desea crear una nueva conexión o utilizar una conexión de la agrupación), el entorno local de salida contiene el ID de la conexión utilizada.
Ubicación en entorno local | Descripción |
---|---|
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/Hostname | El nombre de host utilizado para realizar una conexión. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/Port | El número de puerto utilizado para realizar una conexión. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/OpenTimestamp | La indicación de fecha y hora de la primera apertura de la conexión. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/CloseTimestamp | La indicación de fecha y hora de cierre de la conexión (nulo si no se ha cerrado aún). |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/SequenceNumber | El número de secuencia del mensaje recibido en esta conexión. El primer registro tiene el número de secuencia 1; el segundo registro tiene el número de secuencia 2, y así sucesivamente. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/Id | El ID del socket que se está utilizando. Este ID es un identificador interno utilizado por WebSphere Message Broker para identificar de forma exclusiva una conexión. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/ReplyId | El ID de respuesta que se ha almacenado en esta conexión. Puede ser cualquier serie de texto. |
Si se cierra la conexión (o se produce cualquier otro tipo de excepción) mientras se está utilizando el transporte TCP/IP, se genera una excepción. Esta excepción se dirige al terminal de anomalías si está conectado, de lo contrario la excepción vuelve al flujo.
El nodo tiene también un terminal de entrada de cierre. Si se envía un mensaje a ese terminal, la conexión se cierra utilizando una combinación de los detalles que se proporcionan en el nodo y el entorno local.
El nodo TCPIPClientOutput se encuentra en la bandeja TCPIP de la paleta y está representado en el entorno de trabajo por el siguiente icono:
Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.
Una vez ha puesto una instancia del nodo TCPIPClientOutput en un flujo de mensajes, puede configurarlo (para obtener más información, consulte Configurar un nodo de flujo de mensajes). Las propiedades del nodo se visualizan en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco en esta vista.
Para configurar el nodo TCPIPClientOutput:
Los terminales del nodo TCPIPClientOutput están descritos en la siguiente tabla.
Terminal | Tipo | Descripción |
---|---|---|
In (de entrada) | Datos de entrada | El terminal de entrada que acepta un mensaje para que lo procese el nodo. |
Close (de cierre) | Control de entrada | El terminal de entrada al que se direcciona un mensaje cuando la conexión indicada en el entorno local está cerrada. |
Out (de salida) | Datos de salida | El terminal de salida al que se direcciona el mensaje si se envía satisfactoriamente a un recurso externo. El mensaje recibido en el terminal In (de entrada) se propaga al terminal Out (de salida) y se deja sin cambios excepto en la adición de información de estado. |
Close (de cierre) | Control de salida | El terminal de salida al que se direcciona un mensaje propagado desde el terminal de entrada de cierre (Close). |
Failure (de anomalías) | Datos de salida | El terminal de salida al que se direcciona el mensaje si se detecta una anomalía en el nodo. |
Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | TCPIPClientOutput | El nombre del nodo. |
Descripción corta | No | No | Descripción breve del nodo. | |
Descripción larga | No | No | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Las propiedades básicas del nodo TCPIPClientOutput se describen en la siguiente tabla:
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Detalles de conexión | Sí | Sí | Serie de caracteres que contiene el nombre de host y el número de puerto que han de utilizarse, o el nombre de un servicio configurable. | connectionDetails | |
Tiempo de espera excedido en el envío de un registro de datos (segundos). | Sí | Sí | 60 | Especifica cuánto tiempo espera el nodo cuando intenta enviar datos. Puede especificar cualquier cantidad de tiempo en segundos. | timeoutSendingData |
En la tabla siguiente se describen las propiedades Avanzadas del nodo TCPIPClientOutput.
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Cerrar conexión | Sí | No | No | Controla cuándo se cierra la conexión o si permanece abierta. Las opciones válidas son:
|
Cerrar corriente de salida después de haber enviado un registro. | Sí | No | No seleccionado | Indica si se ha de cerrar la corriente de salida tan pronto como se hayan enviado los datos. Esta propiedad no está seleccionada de forma predeterminada. |
Modificación de la corriente de datos de salida | No | No | Dejar sin cambios | Especifica si esta secuencia de salida se reserva o se libera y se devuelve a la agrupación para
que la utilice cualquier nodo de salida.
Las opciones válidas son:
|
Modificación de la corriente de datos de entrada | No | No | Dejar sin cambios | Especifica si se va a reservar la corriente de entrada para que la utilicen únicamente los nodos de entrada y recepción que especifiquen el ID de conexión, o para liberarla al final de flujo de mensajes. Las opciones válidas son:
|
Enviar a: | Sí | No | Una conexión | Especifica si los datos se van a enviar a una conexión o a las conexiones disponibles. Las opciones válidas son:
|
Las propiedades de Solicitud del nodo TCPIPClientOutput se describen en la siguiente tabla:
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Ubicación de datos | Sí | No | $Body | La ubicación en el árbol de mensajes de entrada que contiene el registro que se ha de grabar. |
Ubicación del nombre de host | Sí | No | $LocalEnvironment/Destination/TCPIP/Output/Hostname | La ubicación del elemento de mensaje que contiene el nombre de host. |
Ubicación de puerto | Sí | No | $LocalEnvironment/Destination/TCPIP/Output/Port | La ubicación del elemento de mensaje que contiene el puerto. |
Ubicación de ID | Sí | No | $LocalEnvironment/Destination/TCPIP/Output/Id | La ubicación del elemento de mensaje que contiene el ID. |
Ubicación del ID de respuesta | Sí | No | $LocalEnvironment/Destination/TCPIP/Output/ReplyId | La ubicación del elemento de mensaje que contiene el ID de respuesta. |
Las propiedades de Registros y Elementos del nodo TCPIPClientOutput se describen en la siguiente tabla:
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Definición de registro | Sí | No | El registro tiene Datos sin modificar | Esta propiedad controla cómo se graban los registros procedentes del mensaje. Las opciones válidas son:
|
Longitud (bytes) | Sí | No | 0 | La longitud requerida del registro de salida. Esta propiedad solo se aplica cuando se especifica El registro tiene Datos de longitud fija en Definición de registro. |
Byte de relleno (hexadecimal) | Sí | No | 20 | El byte hexadecimal de dos dígitos que se debe utilizar para rellenar mensajes cortos cuando se especifica El registro tiene Datos de longitud fija en Definición de registro. |
Delimitador | Sí | No | Fin de línea del sistema del intermediario | El delimitador que se debe utilizar cuando se especifica El registro tiene Datos delimitados en Definición de registro. Las opciones válidas son:
|
Delimitador personalizado (hexadecimal) | No | No | Ninguno | La secuencia de bytes del delimitador que se debe utilizar cuando se especifica El registro tiene Datos delimitados en la propiedad Definición de registro y Delimitador personalizado (hexadecimal) en la propiedad Delimitador. |
Tipo de delimitador | Sí | No | Posfijo | Esta propiedad especifica la manera en que los delimitadores deben insertarse entre los registros cuando se especifica El registro tiene Datos delimitados en Definición de registro. Las opciones válidas son:
|
Las propiedades de validación del nodo TCPIPClientOutput se describen en la tabla siguiente.
Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Validar | No | Sí | Heredar | Esta propiedad controla si tiene lugar la validación. Los valores válidos son:
|
validateMaster |
Acción para anomalía | No | No | Excepción | Esta propiedad controla qué sucede si falla la
validación. Sólo
puede establecer esta propiedad si establece
Validar en
Contenido o
Contenido y valor. Los valores válidos son:
|
Propiedad | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Sucesos | No | No | Ninguno | Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y
Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles. Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado. |