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 CDOutput

Utilice el nodo CDOutput cuando utilice IBM® Sterling Connect:Direct con WebSphere Message Broker.

Este tema contiene los apartados siguientes:

Finalidad

Utilice el nodo CDOutput para serializar el árbol de mensajes en un archivo y luego transferirlo entre dos Servidores de Connect:Direct. Un directorio bajo la vía de acceso de trabajo del grupo de ejecución se utiliza como área intermedia hasta que el archivo esté listo para transferirse. Cuando el archivo se ha transferido, se suprime del área intermedia.

El nodo CDOutput 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 CDOutput

Utilización de este nodo en un flujo de mensajes

Puede utilizar el nodo CDOutput junto con otro nodo de entrada de transporte; por ejemplo, MQInput. Los datos recibidos de WebSphere MQ se envían al nodo CDOutput que graba el archivo en un directorio interno utilizando el nombre de archivo asignado en el nodo. A continuación, el archivo se transfiere a través del Servidor de Connect:Direct de destino, donde se graba en el directorio y el nombre de archivo asignado en el nodo.

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 de nodo CDOutput se describen en la siguiente tabla:

Terminal Descripción
In (de entrada) El terminal de entrada que acepta un mensaje para que lo procese el nodo.
Finish File (finalizar archivo) El terminal de entrada que acepta un mensaje que desencadena el proceso final de un archivo.
Out (de salida) El mensaje recibido en el terminal In (de entrada) se propaga a este terminal si el registro se graba satisfactoriamente. El mensaje permanece igual, excepto por la información de estado en el Entorno local.
End of Data (fin de datos) El mensaje recibido en el terminal Finish File se propaga a este terminal si el archivo ha procesado satisfactoriamente.
Failure (de anomalías) El terminal de salida al que se direcciona el mensaje si se detecta una anomalía cuando se propaga un mensaje.

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 CDOutput propaga un mensaje, al terminal Out (de salida) o al terminal End of Data (fin de datos), guarda información sobre él en el árbol de mensajes LocalEnvironment.WrittenDestination.CD.

Puede sustituir lo siguiente:
  • Nombre de servidor secundario Connect:Direct (SNODE)
  • Nombre de proceso
  • Datos de contabilidad
  • Directorio de archivo de destino
  • Nombre del archivo de destino
  • Copiar desde las opciones incluyendo SYSOPTS
  • Copiar en las opciones incluyendo SYSOPTS
realizando los cambios en el árbol de mensajes LocalEnvironment.Destination.CD; para 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 CDOutput 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 Propiedad de mandato mqsiapplybaroverride
SNODE No Es lo mismo que el PNODE que se está utilizando El Servidor de Connect:Direct secundario (SNODE) al que se transfiere el archivo.

Si no está establecido, el archivo se vuelve a transferir al servidor Servidor de Connect:Direct primario (PNODE).

Debe configurar un Netmap en PNODE para garantizar que la transferencia accede a SNODE.

La entrada Netmap para este nodo SNODE debe contener el tipo de sistema operativo en el campo adecuado. Si PNODE está en un sistema operativo UNIX, debe utilizar el campo de descripción del Netmap para guardar esta información.

La descripción debe contener la serie remoteos=xxx , donde el valor es Windows, UNIX u OS390. El nodo CDOutput no se puede utilizar para transferir a un SNODE en sistemas operativos distintos de éste.

snode
Directorio de archivo de destino No Serie vacía El directorio al que se transfiere el archivo en el Servidor de Connect:Direct secundario (SNODE).

Tenga en cuenta que debe ser un directorio existente.

Si este campo se deja en blanco, SNODE utiliza el directorio predeterminado.

En z/OS, si el nombre de archivo es un conjunto de datos secuenciales o un miembro de conjunto de datos particionados, deje el campo de directorio en blanco.

destinationDirectory
Nombre del archivo de destino Ninguno El nombre de archivo o patrón específico que contiene un único comodín define el nombre del archivo que se va a crear mediante el Servidor de Connect:Direct secundario (SNODE).

El nombre de archivo puede ser un patrón que contiene un único comodín. El valor de comodín se toma del elemento de la carpeta de entorno local denominada LocalEnvironment.Wildcard.WildcardMatch . Normalmente este valor se establece con los nodos CDInput o FileInput.

Por ejemplo, si el nodo CDInput establece el patrón de archivos en *.in, coincide con el archivo test.in como "test". Si el patrón de archivos del nodo CDOutput se establece en *.out, "test" se sustituye para crear un nombre de archivo de test.out.

El nombre de archivo debe establecerse, pero se puede alterar utilizando el campo de entorno local LocalEnvironment.Destination.CD.Name

Puede especificar conjuntos de datos secuenciales de z/OS o miembros de conjuntos de datos particionados. Para conjuntos de datos secuenciales completos, especifique el nombre completo del conjunto de datos; por ejemplo, MBUSER.TEST1

Para un miembro con un conjunto de datos particionados, utilice corchetes para especificar el nombre de miembro; por ejemplo, MBUSER.TEST(MEME01).

Un carácter de comodín se puede utilizar en cualquier lugar dentro de un nombre de conjunto de datos y trabaja de la misma manera que los patrones de nombre de archivo normales.

destinationFileName
Servicio configurable CDServer No Valor predeterminado El nombre del servicio configurable que se utiliza para conectarse al Servidor de Connect:Direct primario (PNODE), con el fin de iniciar la transferencia.

Si este valor no está establecido, se utiliza el servicio configurable predeterminado (denominado "Predeterminado").

El servicio configurable predeterminado se conecta a un PNODE localizado en la misma máquina que el intermediario y utilizando las 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 Output (salida).

 
Nombre de proceso No Ninguno El nombre utilizado para el script de proceso generado para enviar el archivo desde el Servidor de Connect:Direct primario (PNODE) hasta el Servidor de Connect:Direct secundario (SNODE).

Utilice esta opción si desea identificar esta transferencia de forma exclusiva.

Si este valor no está establecido, se utiliza el nombre de proceso WMBPROC.

Puede utilizar cualquier nombre que desee en el script de proceso. Tenga en cuenta, sin embargo, que el nombre debe tener un máximo de ocho caracteres y no puede contener espacios.

processName
Disposición RPL - sustituir archivo Cómo crear el archivo en el sistema secundario:
  • RPL - Sustituir o crear un archivo nuevo
  • MOD - Añadir al archivo existente. Esta opción está disponible en z/OS
  • NEW - Crear un archivo nuevo

En z/OS, para conjuntos de datos particionados, sólo se da soporte a las opciones RPL y NEW. Los intentos NEW de asignar un conjunto de datos particionado nuevo, con las siguientes opciones de IBM Sterling Connect:Direct SPACE: '(23036,(2,1,1))'

Puede alterar estos valores en el entorno local utilizando: LocalEnvironment.Destination.CD.Copy.To.Option.SPACE =

disposición
Modalidad de transferencia Transferencia binaria (sin conversión)

La modalidad en la que se transfiere el archivo.

binaria - El archivo se transfiere como binario, sin conversión

texto - El archivo se transfiere con conversión entre las páginas de códigos locales, según sea necesario.

Cuando se utiliza la modalidad de transferencia "texto" en z/OS, IBM Sterling Connect:Direct requiere que el archivo contenga al menos un carácter de línea nueva. Debe asegurarse de que el archivo se cree en el formato correcto para que IBM Sterling Connect:Direct complete satisfactoriamente la transferencia de texto.

transferMode

Propiedades de Solicitud

Propiedad M C Valor predeterminado Descripción
Ubicación de datos No No $Body Ubicación en el árbol de mensajes de entrada que contiene el registro que se va a grabar en el archivo de salida. El valor predeterminado, $Body, indica todo el mensaje.

Propiedades de Registros y elementos

Propiedad M C Valor predeterminado Descripción
Definición de registro No El registro es Archivo completo Especifica cómo se colocan los registros en el archivo de salida. Las opciones válidas son:
  • El registro es Archivo completo
  • El registro tiene Datos sin modificar
  • El registro tiene Datos de longitud fija
  • El registro tiene Datos delimitados
Longitud (bytes) No 80 La longitud requerida del registro de salida. La propiedad sólo está disponible cuando el valor de El registro es Datos de longitud fija se especifica en la Definición del registro.
Byte de relleno (hexadecimal) No 20 El byte hexadecimal de dos dígitos que se debe utilizar para rellenar mensajes cortos. La propiedad sólo está disponible cuando el valor de El registro es Datos de longitud fija se especifica en la Definición del registro.
Delimitador No Fin de línea del sistema del intermediario Debe utilizarse el delimitador. La propiedad sólo está disponible cuando El registro es Datos delimitados se especifica en la Definición de registro. Las opciones válidas son:
  • Fin de línea del sistema del intermediario
  • Delimitador personalizado (hexadecimal)
Delimitador personalizado (hexadecimal) No Ninguno Secuencia de bytes de delimitador que debe utilizarse. La propiedad sólo está disponible cuando El registro es Datos delimitados se especifica en la propiedad Definición de registro, y Delimitador personalizado (hexadecimal) se especifica en la propiedad Delimitador.
Tipo de delimitador No Posfijo Esta propiedad especifica cómo deben insertarse los delimitadores entre registros. La propiedad sólo está disponible cuando El registro es Datos delimitados se especifica en la Definición de registro. Las opciones válidas son:
  • Posfijo
  • Infijo

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 Heredar 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 Excepción Esta propiedad controla qué sucede si falla la validación. Esta propiedad sólo está disponible si se 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 17:00:42


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