WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo TCPIPServerReceive

Utilice el nodo TCPIPServerReceive para recibir datos a través de una conexión TCP/IP de servidor.

Este tema contiene las siguientes secciones:

Finalidad

El nodo TCPIPServerReceive espera la recepción de datos en una conexión TCP/IP y los recupera. Si la conexión está cerrada, se genera una excepción.

Cuando se establece una conexión, los datos se envían al nodo TCPIPServerReceive. Si el nodo TCPIPServerReceive no recibe correctamente todos los datos en el tiempo especificado en la propiedad Se ha excedido el tiempo de espera de registro de datos, el mensaje se envía al terminal Timeout; si no hay ningún terminal Timeout conectado, 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.

Tabla 1. Propiedades de entrada de entorno local
Ubicación en entorno local para entrada en el nodo Descripción
$LocalEnvironment//TCPIP/Receive/Hostname El nombre de host utilizado para realizar una conexión.
$LocalEnvironment//TCPIP/Receive/Port El número de puerto utilizado para realizar una conexión.
$LocalEnvironment/TCPIP/Receive/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/TCPIP/Receive/ReplyId El ID de respuesta que se ha de almacenar en esta conexión. Este ID se puede utilizar posteriormente cuando los datos se devuelven en un nodo de entrada. El ID de respuesta Puede ser cualquier serie de texto.
$LocalEnvironment/TCPIP/Receive/Timeout El valor de tiempo de espera utilizado cuando se está a la espera de datos en la conexión de servidor TCP/IP. Este valor prevalece sobre la propiedad Tiempo de espera a la espera de un registro de datos especificada en el nodo.
$LocalEnvironment/TCPIP/Receive/Length El valor utilizado para alterar temporalmente el número de bytes que se van a leer cuando se utilizan registros de tamaño fijo. Este valor prevalece sobre la propiedad Longitud (bytes) especificada en el nodo. Si la propiedad Detección de registros se establece en un valor que no sea Longitud fija, se ignora el campo de entorno local. Si este campo no está presente o se evalúa en nulo, se ignora y se utiliza el valor del nodo.

Estas propiedades permiten seleccionar dinámicamente los detalles de la conexión (nombre de host y número de puerto) y la conexión utilizada (ID). 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. De esta forma, puede almacenar ID de respuesta procedentes de otros nodos TCPIP o de otros transportes como, por ejemplo, WebSphere MQ.

Cuando se ha recuperado un registro, el campo Detalles de conexión del árbol de entorno local se rellena con los detalles de la conexión que está utilizando.

Tabla 2. Propiedades de salida de entorno local
Ubicación en entorno local para salida desde el nodo Descripción
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Type El servidor.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Hostname El nombre de host utilizado para realizar una conexión.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/Port El número de puerto utilizado para realizar una conexión.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/OpenTimestamp La indicación de fecha y hora de la primera apertura de la conexión.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/CloseTimestamp La indicación de fecha y hora de cierre de la conexión (nulo si no se ha cerrado aún).
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/SequenceNumber/InputRecord 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/TCPIP/Receive/ConnectionDetails/SequenceNumber/OutputRecord El número de secuencia del mensaje que se envía 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/TCPIP/Receive/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/TCPIP/Receive/ConnectionDetails/ReplyId El ID de respuesta que se ha almacenado en esta conexión. Puede ser cualquier serie de texto.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Hostname El nombre del dominio totalmente calificado del sistema desde el que se ha conectado el cliente.
$LocalEnvironment/TCPIP/Receive/ConnectionDetails/ClientDetails/Address La dirección IP del sistema desde el que se ha conectado el cliente.

El nodo TCPIPServerReceive se encuentra en el cajón TCPIP de la paleta y está representado en el WebSphere Message Broker Toolkit mediante el siguiente icono:

Icono de nodo TCPIPServerReceive

Estructura de mensajes

El nodo TCPIPServerReceive maneja mensajes en los siguientes dominios de mensajes:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Utilización del nodo TCPIPServerReceive en un flujo de mensajes

Vea los siguientes ejemplos para saber cómo se utiliza el nodo TCPIPServerReceive:

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.

Configuración del nodo TCPIPServerReceive

Cuando haya colocado una instancia del nodo TCPIPServerReceive en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades.

Todas las propiedades obligatorias que no tienen un valor predeterminado aparecen con un asterisco.

Configure el nodo TCPIPServerReceive:

  1. Opcional: En el separador Descripción, especifique una Descripción corta, una Descripción larga, o ambas. En este separador también puede renombrar el nodo.
  2. En el separador Básicas, establezca las propiedades que determinan cómo se controla la conexión TCP/IP.
    • Utilice la propiedad Detalles de conexión para especificar el nombre de host y el número de puerto que han de utilizarse, o el nombre de un servicio configurable. Esta propiedad es obligatoria. Se da soporte a los siguientes formatos:
      • Nombre de servicio configurable. Este valor se utiliza para buscar el puerto y el nombre de host de servicios configurables. Por ejemplo, TCPIPProfile1.
      • <Nombre de host>:<Puerto>. Este valor es el nombre de host seguido del número de puerto (separado por el signo de dos puntos); por ejemplo, tcpip.server.com:1111.
      • <Puerto>. Este valor es el número de puerto. En este caso, se supone que el nombre de host es localhost.
    • Utilice la propiedad Tiempo de espera esperando un registro de datos (segundos) para indicar cuánto tiempo va a estar a la escucha un nodo en una conexión a la espera de más datos después de la llegada del primer byte de datos. Puede especificar cualquier cantidad de tiempo en segundos. El valor predeterminado es 60 segundos. Cuando se excede el tiempo especificado, todos los datos disponibles se envían al terminal de anomalías (Failure).
  3. En el separador Avanzadas, establezca las propiedades que determinan cómo se controla la secuencia de datos.
    • Utilice la propiedad Cerrar conexión para especificar cuándo y cómo se ha de cerrar la conexión.
      • Seleccione No para dejar abierta la conexión. Este valor es el predeterminado.
      • Seleccione Después del tiempo de espera para cerrar la conexión cuando se produzca un tiempo de espera excedido.
      • Seleccione Después de recibir los datos para cerrar la conexión cuando se encuentra el final del registro.
    • Seleccione >Cerrar corriente de entrada después de recibir un registro para cerrar la corriente de entrada tan pronto como se hayan recuperado los datos. De forma predeterminada, esta propiedad no está seleccionada. Cuando la corriente de entrada de la conexión esté reservada ningún otro nodo podrá utilizarla sin conocer el ID.
    • Utilice la propiedad Modificación de la corriente de datos de entrada para indicar 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 liberar la corriente de entrada al final del flujo.
      • Seleccione Dejar sin cambios para dejar la corriente de entrada tal como estaba cuando entró en el nodo. Este valor está seleccionado de forma predeterminada.
      • Seleccione Liberar corriente de datos de entrada para especificar que esta corriente de entrada se devuelve a la agrupación y está disponible para que la utilice cualquier nodo de entrada.
      • Seleccione Reservar corriente de datos de entrada (para que la utilicen futuros nodos TCPIP de entrada y recepción) para especificar que esta corriente de entrada sólo podrá ser utilizada por este nodo y otros nodos de entrada o recepción que lo soliciten especificando el ID de conexión. Cuando la corriente de entrada de la conexión esté reservada ningún otro nodo podrá utilizarla sin especificar el ID de conexión correcto.
      • Seleccione Reservar corriente de datos de entrada (para que la utilicen futuros nodos TCPIP de entrada y recepción) y a continuación liberar después de propagar para especificar que esta corriente de entrada sólo podrá ser utilizada por este nodo y nodos de recepción que lo soliciten especificando el ID de conexión correcto. Después de haber propagado el mensaje, esta corriente de entrada se devuelve a la agrupación y queda disponible para que la utilice cualquier nodo de entrada o de recepción.
    • Utilice la propiedad Modificación de la corriente de datos de salida para indicar si debe reservarse o liberarse la corriente de salida. Estas opciones sólo están disponibles si no se ha seleccionado la propiedad Cerrar corriente de salida después de enviar un registro.
      • Seleccione Dejar sin cambios para dejar la corriente de salida tal como estaba cuando entró en el nodo. Este valor está seleccionado de forma predeterminada.
      • Seleccione Liberar corriente de datos de salida para especificar que esta corriente de salida se devuelve a la agrupación y está disponible para que la utilice cualquier nodo de salida.
      • Seleccione Reservar corriente de datos de salida (para que la utilicen futuros nodos TCPIP de salida) para especificar que esta corriente de entrada salida sólo podrá ser utilizada por este nodo y otros nodos de salida que lo soliciten especificando el ID de conexión. Cuando la corriente de entrada de la conexión esté reservada ningún otro nodo podrá utilizarla sin especificar el ID de conexión correcto.
      • Seleccione Reservar corriente de datos de salida (para que la utilicen futuros nodos TCPIP de salida)a continuación liberar después de propagar para especificar que esta corriente de salida sólo podrá ser utilizada por este nodo y por nodos de salida que lo soliciten especificando el ID de conexión correcto. Después de haber propagado el mensaje, esta corriente de datos de salida se devuelve a la agrupación y queda disponible para que la utilice cualquier nodo de salida.
  4. En el separador Solicitud, especifique la ubicación de los datos que se deben grabar. Puede especificar las propiedades de este separador como expresiones XPath o ESQL. La Ayuda de contenido está disponible en el panel de propiedades y también en el Creador de expresiones XPath que puede ejecutar pulsando el botón Editar situado a la derecha de cada propiedad.
    • En Ubicación del nombre de host, especifique la ubicación del valor que va a alterar temporalmente el Nombre de host establecido en la propiedad Detalles de conexión del separador Básico Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/Hostname.
    • En Ubicación del puerto, especifique la ubicación del valor que va a alterar temporalmente el Puerto establecido en la propiedad Detalles de conexión del separador Básico. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/Port.
    • En ID ubicación, especifique la ubicación del Id del socket que se está utilizando. Es un identificador interno utilizado por WebSphere Message Broker para identificar exclusivamente una conexión. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/Id.
    • En Ubicación de ID de respuesta, especifique la ubicación del ID de respuesta que está almacenado en la conexión que se está utilizando. El ID de respuesta se puede utilizar cuando los datos se devuelven en un nodo de entrada. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/ReplyId.
  5. En el separador Resultado, establezca los valores de las propiedades que determinen dónde se almacena la respuesta.
    • Utilice la propiedad Ubicación de datos de salida para especificar la ubicación de inicio del árbol de mensajes de salida donde la que se almacenan los elementos analizados de la serie de bits del mensaje. El valor predeterminado es $OutputRoot.
    • Utilice la propiedad Copiar entorno local para especificar si el entorno local se copia en el mensaje de salida.
      • Si se ha seleccionado Copiar entorno local, se creará una nueva copia del entorno local en el árbol y se rellenará con el contenido del entorno local procedente del nodo anterior. Por lo tanto, si un nodo cambia el entorno local, los nodos ascendentes no quedarán afectados por esos cambios porque tienen sus propias copias. Este valor es el predeterminado.
      • Si no se ha seleccionado Copiar entorno local, el nodo no genera su propia copia del entorno local sino que utiliza en entorno local que le ha pasado el nodo precedente. Por lo tanto, si un nodo cambia el entorno local, los cambios se reflejarán en los nodos en sentido ascendente.
  6. En el separador Análisis de mensaje de entrada, establezca valores para las propiedades que el nodo utiliza para determinar cómo analizar el mensaje de entrada.
    Si el mensaje de entrada tiene una cabecera MQRFH2, no es necesario que establezca valores para las propiedades de Análisis de mensajes de entrada, porque los valores se obtienen de la carpeta <mcd> en la cabecera MQRFH2; por ejemplo:
    <mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
    <Fmt>XML</Fmt></mcd>

    Si establece valores y estos difieren de los de la cabecera MQRFH2, los valores de la cabecera MQRFH2 tienen prioridad.

    • En Dominio de mensajes, seleccione en la lista el nombre del analizador que utiliza. El valor predeterminado es BLOB. Puede elegir entre las siguientes opciones:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      También puede especificar un analizador definido por el usuario, si es lo adecuado.
    • Si utiliza el analizador DFDL, el analizador MRM o el analizador XMLNSC en modalidad de validación, seleccione el Modelo de mensaje relevante en la lista. Esta lista se llena con conjuntos de mensajes disponibles cuando se selecciona MRM o XMLNSC como Dominio de mensajes, o con archivos de esquema DFDL disponibles al seleccionar DFDL como Dominio de mensajes.
    • Si utiliza los analizadores DFDL o MRM, seleccione el mensaje correcto en la lista de Mensaje. Esta lista se llena con los mensajes definidos en el Modelo de mensaje que se ha seleccionado.
    • Si está utilizando el analizador MRM, seleccione el formato del mensaje en la lista de Formato físico. Esta lista incluye todos los formatos físicos que se han definido para este Modelo de mensaje.
    • Especifique el ID de juego de caracteres codificado del mensaje ID de juego de caracteres codificado del mensaje.
    • Seleccione la codificación del mensaje en la lista Codificación del mensaje o especifique un valor de codificación numérica. Para obtener más información sobre la codificación, consulte Conversión de datos.
  7. En el subseparador Opciones de análisis:
    • De forma predeterminada, Temporización de análisis está establecido en A petición con lo cual el análisis del mensaje se retrasa. Para hacer que el mensaje se analice inmediatamente, consulte Análisis a petición.
    • Si está usando el analizador XMLNSC, establezca valores para las propiedades que determinan el funcionamiento del analizador XMLNSC. Para obtener más información, consulte Manipular mensajes en el dominio XMLNSC.
  8. Utilice el separador Registros y elementos para especificar cómo se interpretan los datos como registros. Sólo se recupera un registro cada vez que se inicia el nodo TCPIPServerReceive; por lo tanto, si la corriente TCP/IP contiene varios mensajes lógicos, deberá iniciar el nodo varias veces para recibir todos los mensajes.
    • Utilice la propiedad Detección de registros para determinar cómo se dividen los datos en registros, cada uno de los cuales genera un solo mensaje. Elija una de las siguientes opciones:
      • Conexión cerrada indica que todos los datos enviados durante una conexión son un único registro.
      • Longitud fija especifica que cada registro tiene una longitud con un número de bytes fijo. Cada registro contiene el número de bytes especificado en la propiedad Longitud, salvo posiblemente un registro final más corto en el archivo.
      • Seleccione Delimitados, si los registros que está procesando están separados, o interrumpidos, por un final de línea DOS o UNIX o por una secuencia de bytes de delimitador definido por el usuario. Especifique el delimitador y el tipo de delimitador en las propiedades Delimitador y Tipo de delimitador.
      • Seleccione Secuencia de registros analizados si los datos contienen una secuencia de uno o varios registros reconocidos en serie por el analizador especificado en Dominio de mensajes. El nodo propaga cada registro reconocido como mensaje independiente. Si selecciona esta opción de Detección de registros, el analizador especificado en Dominio de mensajes debe ser XMLNSC o MRM (formato físico CWF o TDS).
    • Si establece Detección de registros en Longitud fija, utilice Longitud para especificar la longitud requerida del registro de salida. Debe ser un valor entre 1 byte y 100 MB. El valor predeterminado es 80 bytes.

      Si establece Detección de registros en Conexión cerrada, Longitud fija o Delimitada, se aplica un límite de 100 MB a la longitud de los registros. Si establece Detección de registros en Secuencia de registros analizados, el nodo TCPIPServerReceive no determina ni limita la longitud de un registro. Los nodos que están en sentido descendente en el flujo de mensajes pueden intentar determinar la longitud de registro o procesar un registro largo. Si tiene pensado procesar registros de gran tamaño de esta forma, asegúrese de que el intermediario tiene suficiente memoria. Es posible que tenga que aplicar las técnicas de flujo de mensajes descritas en el ejemplo de Mensajes grandes para aprovechar al máximo la memoria disponible.

    • Si establece Detección de registros en Delimitada, utilice Delimitador para especificar el delimitador que se va a utilizar. Elija una de las siguientes opciones:
      • Fin de línea de DOS o UNIX, en sistemas UNIX, especifica el carácter de salto de línea (<LF>, X'0A') y, en los sistemas Windows, especifica un carácter de retorno de carro seguido de un carácter de salto de línea (<CR><LF>, X'0D0A'). El nodo trata las dos series como delimitadores, sin tener en cuenta el sistema en el que se ejecuta el intermediario. Si las dos series pueden verse en el mismo registro, el nodo reconoce a las dos como delimitadores. El nodo no reconoce X'15' que en sistemas z/OS es el byte de 'nueva línea'; establezca esta propiedad en Delimitador personalizado y establezca Delimitador personalizado en 15 si el archivo de entrada se ha codificado utilizando nuevas líneas EBCDIC.
      • Delimitador personalizado (hexadecimal),permite especificar una secuencia de bytes en Delimitador personalizado (hexadecimal)
    • En Delimitador personalizado (hexadecimal), especifique el byte o bytes de delimitador que se deben utilizar cuando Delimitador se establece en Delimitador personalizado (hexadecimal). Especifique este valor como una serie de número par de dígitos hexadecimales. El valor predeterminado es X'0A' y la longitud máxima de la serie es 16 bytes (representada por 32 dígitos hexadecimales).
    • Si establece Detección de registros en Delimitada, utilice el Tipo de delimitador para especificar el tipo de delimitador. Los valores permitidos son:
      • Infijo. Si selecciona este valor, cada delimitador separa los registros. Si los datos finalizan con un delimitador, los datos (longitud cero) que siguen al delimitador final siguen propagándose aunque no contengan datos.
      • Posfijo. Si especifica este valor, cada delimitador termina registros. Si los datos finalizan con un delimitador, no se propaga ningún registro vacío después del delimitador. Si los datos no finalizan con un delimitador, se procesan como si el delimitador siguiera a los bytes finales de los datos. Posfijo es el valor predeterminado.
    • El nodo TCPIPServerReceive considera cada aparición del delimitador en la entrada como separación (infijo) o terminación (posfijo) de cada registro. Si los datos empiezan con un delimitador, el nodo trata el contenido (longitud cero) que precede a ese delimitador como un registro y propaga un registro vacío al flujo. El delimitador nunca se incluye en el mensaje propagado.
  9. Utilice el separador Validación para proporcionar validación basándose en el conjunto de mensajes para los mensajes predefinidos. Para obtener más información sobre la validación, consulte Validar mensajes. Para obtener más información sobre cómo cumplimentar este separador, consulte Propiedades del separador de validación.

Terminales y propiedades

Los terminales del nodo TCPIPServerReceive se describen en la tabla siguiente.

Terminal Descripción
In (de entrada) El terminal de entrada que acepta un mensaje para que lo procese el nodo.
Out (de salida) El terminal de salida al que se direcciona el mensaje si se recupera satisfactoriamente de un recurso externo. Si no se producen errores en el nodo de entrada, un mensaje recibido de un recurso externo siempre se envía primero al terminal de salida.
Timeout (de tiempo de espera) El terminal al que se envía un mensaje cuando ha transcurrido el tiempo especificado en la propiedad Se ha excedido el tiempo de espera de registro de datos. El texto del mensaje es Se ha excedido el valor de tiempo de espera.
Failure (de anomalías) El terminal de salida al que se direcciona el mensaje si se produce un error. Estos errores incluyen las anomalías causadas por el proceso de reintentos. Aunque esté establecida la propiedad Validación, los mensajes propagados a este terminal no se validan.

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).

En la tabla siguiente se describen las propiedades de descripción del nodo TCPIPServerReceive.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No TCPIPServerReceive 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 TCPIPServerReceive determinan la forma en que se controla la conexión TCP/IP y las encontrará descritas en la tabla siguiente.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Detalles de conexión   Una serie que contiene el número de puerto que se debe utilizar, o el nombre de un servicio configurable. Se da soporte a los siguientes formatos:
  • Nombre de servicio configurable. Este valor se utiliza para buscar el puerto y el nombre de host de servicios configurables. Por ejemplo, TCPIPProfile1.
  • <Puerto>. Este valor es el número de puerto; por ejemplo, 1111.
  • <Puerto>. Este valor es el número de puerto. En este caso, se supone que el nombre de host es localhost.
connectionDetails
Tiempo de espera a la espera de un registro de datos (segundos). 60 Especifica cuánto tiempo va a estar a la escucha un nodo en una conexión a la espera de más datos después de la llegada del primer byte de datos. Puede especificar cualquier cantidad de tiempo en segundos. El valor predeterminado es 60 segundos. Cuando se excede el tiempo especificado, todos los datos disponibles se envían al terminal de anomalías (Failure). timeoutWaitingForData

Las propiedades Avanzadas del nodo TCPIPServerReceive determinan la forma en que se controla la secuencia de datos y las encontrará descritas en la tabla siguiente.

Propiedad O C Valor predeterminado Descripción
Cerrar conexión No No Controla cuándo se cierra la conexión o si permanece abierta. Las opciones válidas son:
  • Seleccione No para dejar abierta la conexión. Este valor es el predeterminado.
  • Seleccione Después del tiempo de espera para cerrar la conexión cuando se produzca un tiempo de espera excedido.
  • Seleccione Después de recibir los datos para cerrar la conexión cuando se encuentra el final del registro.
Cerrar corriente de entrada después de recibir un registro No No seleccionado Indica si se ha de cerrar la corriente de entrada tan pronto como se hayan recuperado los datos. Cuando la corriente de entrada de la conexión esté reservada ningún otro nodo podrá utilizarla sin conocer el ID. De forma predeterminada, esta propiedad no está seleccionada.
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:
  • Seleccione Dejar sin cambios para dejar la corriente de entrada tal como estaba cuando entró en el nodo. Este valor está seleccionado de forma predeterminada.
  • Seleccione Liberar corriente de datos de entrada para especificar que esta corriente de entrada se devuelve a la agrupación y está disponible para que la utilice cualquier nodo de entrada.
  • Seleccione Reservar corriente de datos de entrada (para que la utilicen futuros nodos TCPIP de entrada y recepción) para especificar que esta corriente de entrada sólo podrá ser utilizada por este nodo y otros nodos de entrada o recepción que lo soliciten especificando el ID de conexión. Cuando la corriente de entrada de la conexión esté reservada ningún otro nodo podrá utilizarla sin especificar el ID de conexión correcto.
  • Seleccione Reservar corriente de datos de entrada (para que la utilicen futuros nodos TCPIP de entrada y recepción) y a continuación liberar después de propagar para especificar que esta corriente de entrada sólo podrá ser utilizada por este nodo y nodos de recepción que lo soliciten especificando el ID de conexión correcto. Después de haber propagado el mensaje, esta corriente de entrada se devuelve a la agrupación y queda disponible para que la utilice cualquier nodo de entrada o de recepción.
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. Estas opciones sólo están disponibles si no se ha seleccionado la propiedad Cerrar corriente de salida después de enviar un registro.
  • Seleccione Dejar sin cambios para dejar la corriente de salida tal como estaba cuando entró en el nodo. Este valor está seleccionado de forma predeterminada.
  • Seleccione Liberar corriente de datos de salida para especificar que esta corriente de salida se devuelve a la agrupación y está disponible para que la utilice cualquier nodo de salida.
  • Seleccione Reservar corriente de datos de salida (para que la utilicen futuros nodos TCPIP de salida) para especificar que esta corriente de entrada salida sólo podrá ser utilizada por este nodo y otros nodos de salida que lo soliciten especificando el ID de conexión. Cuando la corriente de entrada de la conexión esté reservada ningún otro nodo podrá utilizarla sin especificar el ID de conexión correcto.
  • Seleccione Reservar corriente de datos de salida (para que la utilicen futuros nodos TCPIP de salida)a continuación liberar después de propagar para especificar que esta corriente de salida sólo podrá ser utilizada por este nodo y por nodos de salida que lo soliciten especificando el ID de conexión correcto. Después de haber propagado el mensaje, esta corriente de datos de salida se devuelve a la agrupación y queda disponible para que la utilice cualquier nodo de salida.

Las propiedades Solicitud del nodo TCPIPServerReceive especifican la ubicación de los datos que se deben grabar. Puede especificar las propiedades de este separador como expresiones XPath o ESQL. La Ayuda de contenido está disponible en el panel de propiedades y también en el Creador de expresiones XPath que puede ejecutar pulsando el botón Editar situado a la derecha de cada propiedad. Las propiedades Solicitud se describen en la tabla siguiente:

Propiedad M C Default (valor predeterminado) Descripción
Ubicación de puerto No $LocalEnvironment/TCPIP/Receive/Port La ubicación del elemento de mensaje que contiene el puerto. Especifique la ubicación del valor que va a alterar temporalmente el Puerto establecido en la propiedad Detalles de conexión del separador Básico. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/Port.
Ubicación de ID No $LocalEnvironment/TCPIP/Receive/Id La ubicación del elemento de mensaje que contiene el ID. Especifique la ubicación del Id del socket que se está utilizando. Es un identificador interno utilizado por WebSphere Message Broker para identificar exclusivamente una conexión. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/Id.
Ubicación del ID de respuesta No $LocalEnvironment/TCPIP/Receive/ReplyId La ubicación del elemento de mensaje que contiene el ID de respuesta. Especifique la ubicación del ID de respuesta que está almacenado en la conexión que se está utilizando. El ID de respuesta se puede utilizar cuando los datos se devuelven en un nodo de entrada. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/ReplyId.
Ubicación de longitud de registro No No $LocalEnvironment/TCPIP/Receive/Length La ubicación del elemento de mensaje que contiene la longitud de registro que se va a leer. Especifique la ubicación del valor que va a alterar temporalmente la propiedad Longitud (bytes) en el separador Registros y elementos. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/TCPIP/Receive/Length.

Las propiedades Resultado del nodo TCPIPServerReceive determinan en lugar en el que se debe almacenar la respuesta y están descritas en la tabla siguiente:

Propiedad O C Valor predeterminado Descripción
Ubicación de datos de salida No No $OutputRoot La ubicación de inicio en el árbol de mensajes de salida donde la que se almacenan los elementos analizados de la serie de bits del mensaje.

Consulte Combinación de un mensaje de resultado con un mensaje de entrada.

Copiar entorno local No No Seleccionado Especifica si se copia el entorno local en el mensaje de salida.
  • Si se ha seleccionado Copiar entorno local, se creará una nueva copia del entorno local en el árbol y se rellenará con el contenido del entorno local procedente del nodo anterior. Por lo tanto, si un nodo cambia el entorno local, los nodos ascendentes no quedarán afectados por esos cambios porque tienen sus propias copias. Este valor es el valor predeterminado.
  • Si no se ha seleccionado Copiar entorno local, el nodo no genera su propia copia del entorno local sino que utiliza en entorno local que le ha pasado el nodo precedente. Por lo tanto, si un nodo cambia el entorno local, los cambios se reflejarán en los nodos en sentido ascendente.

Las propiedades de Análisis de mensajes de entrada del nodo TCPIPServerReceive determinan cómo se analiz el mensaje de entrada.

Si el mensaje de entrada tiene una cabecera MQRFH2, no es necesario establecer valores para las propiedades de Análisis de mensajes de entrada, porque los valores se obtienen de la carpeta <mcd> en la cabecera MQRFH2; por ejemplo:
<mcd><Msd>MRM</Msd><Set>DHM4UO906S001</Set><Type>receiptmsg1</Type>
<Fmt>XML</Fmt></mcd>

Si establece valores y estos difieren de los de la cabecera MQRFH2, los valores de la cabecera MQRFH2 tienen prioridad.

En la tabla siguiente se describen las propiedades de Análisis de mensajes de entrada del nodo TCPIPServerReceive.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Dominio de mensajes No No BLOB Dominio que se utiliza para analizar el mensaje de entrada.  
Modelo de mensaje No No   Nombre o ubicación del modelo de mensaje en el que se define el mensaje de entrada.  
Mensaje No No   El nombre o ubicación de un elemento global que modela un documento de datos entero y está incluido en su archivo de esquema de modelo de mensaje. Esta lista se llena con todos los mensajes disponibles que se han definido en el Modelo de mensaje que ha seleccionado.  
Formato físico No No   Nombre del formato físico del mensaje de entrada.  
ID de juego de caracteres codificado del mensaje No Valor predeterminado del sistema de intermediario El ID del juego de caracteres codificado utilizado para interpretar los datos que se leen. messageCodedCharSetIdProperty
Codificación del mensaje No Determinado por el sistema de intermediario El esquema de codificación para números y caracteres grandes utilizado para interpretar los datos que se leen. Los valores válidos son Determinado por el sistema de intermediario o un valor de codificación numérica. Para obtener más información sobre la codificación, consulte Conversión de datos. messageEncodingProperty

Las propiedades de análisis del nodo TCPIPServerReceive se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción
Temporización del análisis No No A petición Esta propiedad controla cuándo se analiza un mensaje de entrada. Los valores válidos son:
  • A petición
  • Inmediato
  • Completo
De forma predeterminada, Temporización de análisis está establecido en A petición con lo cual el análisis del mensaje se retrasa. Para hacer que el mensaje se analice inmediatamente, consulte Análisis a petición.
Crear árbol utilizando los tipos de datos de esquema XML No No No seleccionado Esta propiedad controla si los elementos de la sintaxis del árbol de mensajes toman los tipos de datos del esquema XML.
Utilizar analizador compacto XMLNSC para dominio XMLNS No No No seleccionado Esta propiedad controla si el analizador compacto XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta propiedad, los datos del mensaje se visualizarán bajo XMLNSC en los nodos que estén conectados al terminal de salida cuando la cabecera MQRFH2 de entrada o la propiedad de Análisis de mensaje de entrada, Dominio de mensajes, sea XMLNS.
Retener el contenido mixto No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra texto mixto en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para el texto mixto. Si deselecciona el recuadro, el texto mixto se ignora y no se crea ningún elemento.
Retener los comentarios No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra comentarios en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para los comentarios. Si deselecciona el recuadro, los comentarios se ignoran y no se crea ningún elemento.
Retener las instrucciones de proceso No No No seleccionado Esta propiedad controla si el analizador XMLNSC crea elementos en el árbol de mensajes cuando encuentra instrucciones de proceso en un mensaje de entrada. Si selecciona el recuadro, se crean elementos para las instrucciones de proceso. Si deselecciona el recuadro, las instrucciones de proceso se ignoran y no se crea ningún elemento.
Elementos opacos No No Espacio en blanco Esta propiedad se utiliza para especificar una lista de elementos del mensaje de entrada que el analizador XMLNSC deba analizar de forma opaca.

Las propiedades Registros y Elementos del nodo TCPIPServerReceive especifican la forma en que los datos se interpretan como registros y están descritas en la tabla siguiente:

Propiedad O C Valor predeterminado Descripción
Detección de registros No Conexión cerrada El mecanismo utilizado para identificar registros en los datos de entrada.
  • Conexión cerrada indica que todos los datos enviados durante una conexión son un único registro.
  • Longitud fija especifica que cada registro tiene una longitud con un número de bytes fijo. Cada registro contiene el número de bytes especificado en la propiedad Longitud, salvo posiblemente un registro final más corto en el archivo.
  • Seleccione Delimitados, si los registros que está procesando están separados, o interrumpidos, por un final de línea DOS o UNIX o por una secuencia de bytes de delimitador definido por el usuario. Especifique el delimitador y el tipo de delimitador en las propiedades Delimitador y Tipo de delimitador.
  • Seleccione Secuencia de registros analizados si los datos contienen una secuencia de uno o varios registros reconocidos en serie por el analizador especificado en Dominio de mensajes. El nodo propaga cada registro reconocido como mensaje independiente. Si selecciona esta opción de Detección de registros, el analizador especificado en Dominio de mensajes debe ser XMLNSC o MRM (formato físico CWF o TDS).
Longitud (bytes) No 0 Si establece Detección de registros en Longitud fija, utilice Longitud para especificar la longitud necesaria del registro de salida en bytes. Este valor debe estar en el rango de 1 byte a 100 MB. El valor predeterminado es 80 bytes.

Si establece Detección de registros en Conexión cerrada, Longitud fija o Delimitada, se aplica un límite de 100 MB a la longitud de los registros. Si establece Detección de registros en Secuencia de registros analizados, el nodo TCPIPServerReceive no determina ni limita la longitud de un registro. Los nodos que están en sentido descendente en el flujo de mensajes pueden intentar determinar la longitud de registro o procesar un registro largo. Si tiene pensado procesar registros de gran tamaño de esta forma, asegúrese de que el intermediario tiene suficiente memoria. Es posible que tenga que aplicar las técnicas de flujo de mensajes descritas en el ejemplo de Mensajes grandes para aprovechar al máximo la memoria disponible.

Delimitador No Fin de línea de DOS o UNIX Si establece Detección de registros en Delimitada, utilice Delimitador para especificar el delimitador que se va a utilizar. Elija una de las siguientes opciones:
  • Fin de línea de DOS o UNIX, en sistemas UNIX, especifica el carácter de salto de línea (<LF>, X'0A') y, en los sistemas Windows, especifica un carácter de retorno de carro seguido de un carácter de salto de línea (<CR><LF>, X'0D0A'). El nodo trata las dos series como delimitadores, sin tener en cuenta el sistema en el que se ejecuta el intermediario. Si las dos series se visualizan en el mismo registro, el nodo reconoce a las dos como delimitadores. El nodo no reconoce X'15' que en sistemas z/OS es el byte de 'nueva línea'; establezca esta propiedad en Delimitador personalizado y establezca Delimitador personalizado en 15 si el archivo de entrada se ha codificado utilizando nuevas líneas EBCDIC, como archivos EBCDIC de un sistema z/OS.
  • Delimitador personalizado (hexadecimal),permite especificar una secuencia de bytes en Delimitador personalizado (hexadecimal)
Delimitador personalizado (hexadecimal) No No   El byte o los bytes de delimitador que se deben utilizar cuando se ha seleccionado la detección de registros Delimitado y Delimitador personalizado (Hexadecimal). Esta propiedad sólo es obligatoria si la propiedad Delimitador se ha establecido en Delimitador personalizado (hexadecimal). Especifique este valor como una serie de número par de dígitos hexadecimales. El valor predeterminado es X'0A' y la longitud máxima de la serie es 16 bytes (representada por 32 dígitos hexadecimales).
Tipo de delimitador No Posfijo La ubicación del delimitador cuando se selecciona la detección de registros Delimitados y Delimitador personalizado (hexadecimal). Las opciones válidas son:
  • Infijo. Si selecciona este valor, cada delimitador separa los registros. Si los datos finalizan con un delimitador, los datos (longitud cero) que siguen al delimitador final siguen propagándose aunque no contengan datos.
  • Posfijo. Si especifica este valor, cada delimitador termina registros. Si los datos finalizan con un delimitador, no se propaga ningún registro vacío después del delimitador. Si los datos no finalizan con un delimitador, se procesan como si el delimitador siguiera a los bytes finales de los datos. Posfijo es el valor predeterminado.

El nodo TCPIPServerReceive considera cada aparición del delimitador en la entrada como separación (infijo) o terminación (posfijo) de cada registro. Si los datos empiezan con un delimitador, el nodo trata el contenido (longitud cero) que precede a ese delimitador como un registro y propaga un registro vacío al flujo. El delimitador nunca se incluye en el mensaje propagado.

Esta propiedad se ignora salvo que la propiedad Delimitador se haya establecido en Delimitador personalizado (hexadecimal).

Las propiedades de validación del nodo TCPIPServerReceive 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 Ninguno Esta propiedad controla si tiene lugar la validación. Los valores válidos son:
  • Ninguno
  • Contenido y valor
  • Contenido
  • Heredar
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:
  • Rastreo de usuario
  • Anotaciones de error locales
  • Excepción
  • Lista de excepciones
 
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
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.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:58


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac67350_