Utilice el nodo CDInput para obtener una vista previa de los archivos cuando utilice IBM® Sterling Connect:Direct junto con WebSphere Message Broker.
Este tema contiene los apartados siguientes:
Puede utilizar el nodo CDInput para ampliar el soporte de WebSphere Message Broker para procesar archivos a través de su integración con IBM Sterling Connect:Direct.
En z/OS, cuando el nodo CDInput recibe la notificación de llegada de un conjunto de datos que necesita procesar, el nodo copia el conjunto de datos en UNIX System Services temporalmente, antes de procesarlo.
El nodo CDInput se encuentra en la bandeja Archivo de la paleta y está representado en el WebSphere Message Broker Toolkit por el siguiente icono:
Puede utilizar el nodo CDInput en cualquier flujo que esté diseñado para aceptar archivos de una red IBM Sterling Connect:Direct.
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.
Los terminales del nodo CDInput están descritos en la siguiente tabla.
Terminal | Descripción |
---|---|
Failure (de anomalías) | El terminal de salida al que se direcciona un mensaje si se produce un error antes de que el mensaje se propague al terminal Out (de salida). Los mensajes propagados a este terminal no se validan, incluso si ha especificado, utilizando la propiedad Validar, que la validación debe llevarse a cabo. |
Out (de salida) | El terminal de salida al que se direcciona un mensaje si éste se extrae satisfactoriamente del archivo de entrada. 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. |
End of Data (fin de datos) | El terminal de salida al que se direcciona el mensaje de fin de datos una vez que se han procesado todos los mensajes de un archivo.
La transacción de flujo de mensajes de fin de datos se inicia sólo si este terminal está conectado. La estructura de fin de datos consta de un cuerpo de mensaje vacío y la información del Entorno local propagada desde el terminal de salida. |
Catch (de captación) | El terminal de salida al que se direcciona un mensaje si se genera una excepción en sentido descendente y después este nodo la capta. Las excepciones se detectan sólo si este terminal está conectado. |
Las tablas siguientes describen las propiedades del nodo que el usuario puede establecer en un separador especificado. La columna con la cabecera O indica si la propiedad es obligatoria (marcada en el kit de herramientas con un asterisco si es necesario especificar un valor cuando no se ha definido ningún valor predeterminado). La columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añada el flujo de mensajes al archivo BAR para desplegarlo).
Cuando el nodo CDInput propaga un mensaje, almacena información sobre el mismo en los árboles de mensajes LocalEnvironment.CD y LocalEnvironment.CD.Transfer. Si el archivo de entrada está vacío, se propaga un mensaje vacío (suponiendo que sea válido). Si especifica un patrón de nombre de archivo que contiene caracteres comodines en la propiedad Filtro de nombre de archivo, el nodo CDInput copia los caracteres en el nombre de archivo que coincide con los caracteres comodín, junto con cualquier carácter intermedio, al árbol de mensajes LocalEnvironment.Wildcard.WildcardMatch. Si desea más información, consulte Utilización de las variables de entorno local con los nodos de archivo.
Propiedades de Descripción
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Nombre de nodo | No | No | CDInput | El nombre del nodo. |
Descripción corta | No | No | Ninguno | Descripción breve del nodo. |
Descripción larga | No | No | Ninguno | Texto que describe la finalidad del nodo en el flujo de mensajes. |
Propiedades Básicas
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Filtro de directorios | No | Sí | Ninguno | Especifique el directorio desde el cual el nodo puede procesar archivos. Si esta propiedad se deja en blanco, el nodo puede procesar archivos de todos los directorios. Si se despliegan varios nodos CDInput en el mismo grupo de ejecución, los archivos se distribuyen aleatoriamente entre los nodos a menos que el filtrado esté definido. El directorio debe ser uno existente. Si WebSphere Message Broker y el servidor IBM Sterling Connect:Direct están en máquinas distintas, éste es la vía de acceso al directorio en la máquina del intermediario. Para obtener información sobre las diversas configuraciones cuando se utiliza IBM Sterling Connect:Direct, consulte Propiedades de configuración avanzadas cuando se utilizan nodos IBM Sterling Connect:Direct y remítase a las secciones Input (de entrada). Si el campo brokerPathToInputDir en el servicio configurable está definido, el filtro de directorio puede ser una vía de acceso relativa a dicho valor; de lo contrario, debe ser una vía de acceso absoluta. En z/OS, si el archivo es un conjunto de datos secuenciales, un conjunto de datos particionados o un miembro de conjunto de datos particionados, deje el campo de filtro de Directorio en blanco. |
Filtro de nombres de archivo | Sí | Sí | Ninguno | Especifique un nombre de archivo o una secuencia de caracteres que coincida con un nombre de archivo. El nombre de archivo o la secuencia de caracteres pueden contener al menos uno de los caracteres comodín siguientes:
De forma predeterminada, el nodo procesa todos los archivos. Si se despliegan varios nodos CDInput en el mismo grupo de ejecución, los archivos se distribuyen aleatoriamente entre los nodos a menos que el filtrado esté definido. El nodo CDInput puede procesar conjuntos de datos secuenciales, conjuntos de datos particionados o miembros de conjuntos de datos particionados de z/OS. La sintaxis para direccionar un conjunto de datos se basa en el nombre completo del conjunto de datos; por ejemplo, MBUSER.TEST1. Los caracteres comodín se pueden utilizar en cualquier lugar del filtro de nombre de archivo de conjunto de datos, esto funciona de la misma manera que para patrones de filtro de nombre de archivo normales. Para un miembro con un conjunto de datos particionados, utilice corchetes para especificar el nombre de miembro; por ejemplo, MBUSER.TEST(MEME01). Cuando recibe un conjunto de datos particionados enteros, cada miembro del conjunto de datos recibido se procesa como un mensaje individual. |
Servicio configurable de Servidor de Connect:Direct | No | Sí | Valor predeterminado | El nombre del servicio configurable que se está utilizando para conectar al Servidor de Connect:Direct, para poder recopilar información de la transferencia. Si este valor no está establecido, se utiliza el servicio configurable predeterminado (denominado "Predeterminado"). El servicio configurable predeterminado se conecta a un Servidor de Connect:Direct situado en la misma máquina que el intermediario y utilizando configuraciones de puerto predeterminadas. El servicio configurable predeterminado también utiliza la identidad de seguridad "predeterminada", que debe crearse utilizando el mandato mqsisetdbparms; por ejemplo: mqsisetdbparms MB8BROKER -n cd::default -u mqbroker -p xxxxxxx Para obtener información sobre las diversas configuraciones cuando se utiliza IBM Sterling Connect:Direct, consulte Propiedades de configuración avanzadas cuando se utilizan nodos IBM Sterling Connect:Direct y remítase a las secciones Input (de entrada). |
Acción si el proceso es satisfactorio | Sí | No | Ninguna acción | Seleccione la acción a realizar cuando el nodo haya procesado satisfactoriamente el archivo. Puede optar por dejar el archivo en el directorio de entrada si otros procesos también necesitan acceder al archivo. En este caso, la notificación de IBM Sterling Connect:Direct se suprime y el archivo se deja en su lugar. La supresión de archivos impide que se acumulen archivos procesados Utilice la opción de indicación de fecha y hora si es necesario realizar un archivado del archivo para registrar todas las transferencias realizadas. Tenga presente que en z/OS, la opción de Añadir indicación de fecha y hora no está soportada cuando se utilizan conjuntos de datos. |
Propiedades de Análisis de mensaje de entrada
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Dominio de mensajes | No | No | Ninguno | Dominio que se utiliza para analizar el mensaje de entrada. | |
Conjunto de mensajes | No | No | Ninguno | Nombre o identificador del conjunto de mensajes
en el que se define el mensaje de entrada. Si establece esta propiedad y, a continuación, actualiza las dependencias del proyecto para eliminar esta referencia de conjunto de mensajes, se emite un aviso. Actualice la propiedad Conjunto de mensajes o restaure la referencia a este proyecto de conjunto de mensajes. |
|
Tipo de mensaje | No | No | Ninguno | Nombre del mensaje de entrada. | |
Formato del mensaje | No | No | Ninguno | Nombre del formato físico del mensaje de entrada. | |
ID de juego de caracteres codificado del mensaje | Sí | Sí | Valor predeterminado del sistema de intermediario | El ID del juego de caracteres codificado utilizado para interpretar los bytes del archivo que se lee. | messageCodedCharSetIdProperty |
Codificación del mensaje | Sí | Sí | Determinado por el sistema de intermediario | El esquema de codificación para números utilizado para interpretar los bytes del archivo que se lee. 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 |
Propiedades de Opciones de análisis
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Temporización del análisis | No | No | A petición | Especifica cuando se analiza un mensaje de entrada. Los valores válidos son:
Si desea ver una descripción completa de esta propiedad, consulte Análisis a petición. |
Crear árbol utilizando tipos de datos de esquema XML | No | No | Deseleccionado | Especifica si los elementos de sintaxis del árbol de mensajes tienen tipos de datos obtenidos del esquema XML. |
Utilizar analizador compacto XMLNSC para dominio XMLNS | No | No | Deseleccionado | Especifica si el analizador compacto
XMLNSC se utiliza para mensajes en el dominio XMLNS. Si establece esta
propiedad, los datos del mensaje aparecen bajo XMLNSC en los nodos que están
conectados al terminal de salida cuando uno de los siguientes elementos es
XMLNS:
|
Retener el contenido mixto | No | No | Deseleccionado | Especifica si el analizador XMLNSC crea elementos en el árbol de mensajes para texto combinado 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 | Deseleccionado | Especifica si el analizador XMLNSC crea elementos en el árbol de mensajes para 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 | Deseleccionado | Especifica si el analizador XMLNSC crea elementos en el árbol de mensajes para 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 | Especifica una lista de elementos en el mensaje de entrada que el analizador XMLNSC debe analizar de forma opaca. El análisis opaco sólo se realiza si la validación no está habilitada (es decir, si Validar tiene el valor Ninguno); las entradas que se especifiquen en Elementos opacos se omiten si la validación está habilitada. |
Propiedades de Reintento
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Mecanismo de reintento | Sí | No | Anomalía | Cómo maneja el nodo una anomalía del flujo. Las opciones válidas son:
|
|
Umbral de reintentos | Sí | Sí | 0 | El número de veces que debe reintentarse la transacción de flujos cuando el valor de la propiedad Mecanismo de reintento es Reintento corto. | retryThreshold |
Intervalo de reintento corto (segundos) | No | Sí | 0 | El intervalo, en segundos, entre cada reintento si la propiedad Umbral de reintentos no es cero. | shortRetryInterval |
Intervalo de reintento largo (segundos) | No | Sí | 300 | El intervalo entre reintentos si la propiedad Mecanismo de reintento es Reintento corto y largo y se ha agotado el umbral de reintentos. | longRetryInterval |
Acción si el archivo falla | Sí | Sí | No se requiere ninguna acción | Acción que el nodo lleva a cabo con el archivo de entrada
si todos los intentos para procesar el contenido de este archivo fallan.
Las opciones válidas son:
|
Propiedades de Registros y elementos
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Detección de registros | Sí | No | Todo el archivo | El mecanismo utilizado para identificar registros en el archivo de entrada. Las opciones válidas son:
|
Longitud | Sí | No | 80 | La longitud de cada registro cuando se selecciona la detección de registros Longitud fija. |
Delimitador | Sí | Sí | Fin de línea de DOS o UNIX | El tipo de bytes de delimitador que separan o terminan cada registro cuando se ha seleccionado la detección de registros Delimitados. Las opciones válidas son:
|
Delimitador personalizado | No | Sí | Ninguno | Los bytes de delimitador, expresados en hexadecimal, cuando se selecciona la detección de registros Delimitados y el Delimitador personalizado. Esta propiedad sólo es obligatoria si la propiedad Delimitador no se ha establecido en Delimitador personalizado. |
Tipo de delimitador | Sí | No | Posfijo | La posición del delimitador cuando se selecciona la detección de registros Delimitados. Las opciones válidas son:
|
Propiedades de Validación
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í | Ninguno | 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. Los valores válidos son:
|
Propiedades de Transacciones
Propiedad | M | C | Valor predeterminado | Descripción |
---|---|---|---|---|
Modalidad de transacción | No | No | No | La modalidad de transacción de este nodo de entrada determina si el resto de los nodos del flujo se procesan bajo punto de sincronismo. Las opciones válidas son:
|
Propiedades de Instancias.
Para ver la descripción completa de estas propiedades, consulte Propiedades configurables del flujo de mensajes.
Propiedad | M | C | Valor predeterminado | Descripción | Propiedad de mandato mqsiapplybaroverride |
---|---|---|---|---|---|
Agrupación de instancias adicionales | No | Sí | Utilizar agrupación asociada al flujo de mensajes | La agrupación de la que se obtienen instancias adicionales.
|
componentLevel |
Instancias adicionales | No | Sí | 0 | El número de instancias adicionales que el nodo puede iniciar si la propiedad Agrupación de instancias adicionales se establece en Utilizar agrupación asociada al nodo. | additionalInstances |
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. |