Utilice el nodo TCPIPServerOutput para crear una conexión de servidor para un socket TCP/IP primario y para enviar datos a una aplicación externa a través de la conexión.
El nodo TCPIPServerOutput escucha en un puerto TCP/IP y espera a que un nodo de cliente establezca una conexión con el puerto. Cuando el cliente se conecta al puerto, el nodo de servidor crea una conexión para el cliente. 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 TCPIPServer 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.
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.
Puede configurar el intermediario para que utilice SSL para nodos TCP/IP; consulte SSL y los nodos TCP/IP.
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 ID 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 servidor 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. |
Puede seleccionar dinámicamente los detalles de la conexión (nombre de host y número de puerto) y la conexión utilizada (ID), utilizando estas propiedades. También se puede establecer el ID de respuesta en la conexión, lo que permite almacenar una serie de caracteres en la conexión y que aparezca en el entorno local. Este comportamiento se puede utilizar para almacenar IDs de respuesta de otros nodos TCPIP o de otros transportes como, por ejemplo, WebSphere MQ.
La salida del nodo contiene la misma información que la entrada, y cualquier campo que falte en la entrada se actualiza 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. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/ClientDetails/Hostname | El nombre del dominio totalmente calificado del sistema desde el que se ha conectado el cliente. |
$LocalEnvironment/WrittenDestination/TCPIP/Output/ConnectionDetails/ClientDetails/Address | La dirección IP del sistema desde el que se ha conectado el cliente. |
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 Failure (de anomalías) si está conectado, de lo contrario la excepción vuelve al flujo de mensajes.
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 TCPIPServerOutput 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 TCPIPServerOutput 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 TCPIPServerOutput:
Los terminales del nodo TCPIPServerOutput 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 | O | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | TCPIPServerOutput | 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 TCPIPServerOutput se describen en la siguiente tabla:
Propiedad | O | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Detalles de conexión | Sí | Sí | Una serie que contiene el número de puerto que se debe utilizar, 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 TCPIPServerOutput.
Propiedad | O | 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. De forma predeterminada, esta propiedad no está seleccionada. |
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. 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 todas las conexiones disponibles. Las opciones válidas son:
|
Las propiedades de Solicitud del nodo TCPIPServerOutput se describen en la siguiente tabla:
Propiedad | O | 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 de puerto | Sí | No | $LocalEnvironment/Destination/TCPIP/Output/Port | La ubicación del elemento de mensaje que contiene el puerto. |
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 TCPIPServerOutput se describen en la siguiente tabla:
Propiedad | O | 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 sólo se aplica cuando la Definición de registro se establece en El registro tiene Datos de longitud fija. |
Byte de relleno (hexadecimal) | Sí | No | 20 | El byte hexadecimal de dos dígitos que se debe utilizar para rellenar mensajes cortos cuando Definición de registro se establece en El registro tiene Datos de longitud fija. |
Delimitador | Sí | No | Fin de línea del sistema del intermediario | El delimitador que se va a utilizar cuando Definición de registro se establece en El registro tiene Datos delimitados. Las opciones válidas son:
|
Delimitador personalizado (hexadecimal) | No | No | Ninguno | La secuencia de bytes del delimitador que se debe utilizar cuando Definición de registro se establece en El registro tiene Datos delimitados y Delimitador se establece en Delimitador personalizado (hexadecimal). |
Tipo de delimitador | Sí | No | Posfijo | Esta propiedad especifica la manera en que los delimitadores se insertan entre los registros cuando Definición de registro se establece en El registro tiene Datos delimitados. Las opciones válidas son:
|
Las propiedades de validación del nodo TCPIPServerOutput se describen en la siguiente tabla.
Para ver la descripción completa de estas propiedades, consulte Propiedades de validación.
Propiedad | O | 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. |