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 CDInput

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:

Finalidad

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:

Icono del nodo CDnput

Utilización de este nodo en un flujo de mensajes

Puede utilizar el nodo CDInput en cualquier flujo que esté diseñado para aceptar archivos de una red IBM Sterling Connect:Direct.

Consulte el ejemplo siguiente para ver cómo se debe utilizar este nodo:

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.

Terminales y propiedades

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 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 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:

  • * (cualquier secuencia de cero o más caracteres)
  • ? (cualquier carácter individual)

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 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 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 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 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:
  • A petición
  • Inmediato
  • Completo

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:
  • La cabecera MQRFH2 de entrada.
  • La propiedad de Análisis de mensajes de entrada, Dominio de mensajes.
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 No Anomalía Cómo maneja el nodo una anomalía del flujo. Las opciones válidas son:
  • Anomalía
  • Reintento corto
  • Reintento corto y largo
 
Umbral de reintentos 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 0 El intervalo, en segundos, entre cada reintento si la propiedad Umbral de reintentos no es cero. shortRetryInterval
Intervalo de reintento largo (segundos) No 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 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:
  • No se requiere ninguna acción
  • Suprimir
  • Añadir indicación de fecha y hora Esta opción no está disponible en z/OS
 

Propiedades de Registros y elementos

Propiedad M C Valor predeterminado Descripción
Detección de registros No Todo el archivo El mecanismo utilizado para identificar registros en el archivo de entrada. Las opciones válidas son:
  • Todo el archivo
  • Longitud fija
  • Delimitados
  • Secuencia de registros analizados
Longitud No 80 La longitud de cada registro cuando se selecciona la detección de registros Longitud fija.
Delimitador 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:
  • Fin de línea de DOS o UNIX
  • Delimitador personalizado
Delimitador personalizado No 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 No Posfijo La posición del delimitador cuando se selecciona la detección de registros Delimitados. Las opciones válidas son:
  • Posfijo
  • Infijo
Esta propiedad se ignora salvo que la propiedad Delimitador se establezca en Delimitador personalizado.

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 Ninguno Esta propiedad controla si tiene lugar la validación. Los valores válidos son:
  • Ninguno
  • Contenido y valor
  • Contenido
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:
  • Rastreo de usuario
  • Anotaciones de error locales
  • Excepción
  • Lista de excepciones
 

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:
  • No

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 Utilizar agrupación asociada al flujo de mensajes La agrupación de la que se obtienen instancias adicionales.
  • Si selecciona Utilizar agrupación asociada al flujo de mensajes, las instancias adicionales se obtendrán del flujo de mensajes.
  • Si selecciona Utilizar agrupación asociada al nodo, se asignan instancias adicionales desde las instancias adicionales del nodo basándose en el número especificado en la propiedad Instancias adicionales.
componentLevel
Instancias adicionales No 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
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 17:00:42


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