Utilice el nodo CDOutput cuando utilice IBM® Sterling Connect:Direct con WebSphere Message Broker.
Este tema contiene los apartados siguientes:
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:
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.
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 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.
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 | Sí | 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 | Sí | 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 | Sí | Sí | 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 | Sí | 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 | Sí | 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 | Sí | Sí | RPL - sustituir archivo | Cómo crear el archivo en el sistema secundario:
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 | sí | Sí | 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 | Sí | No | El registro es Archivo completo | Especifica cómo se colocan los registros en
el archivo de salida. Las opciones válidas son:
|
Longitud (bytes) | Sí | 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) | Sí | 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 | Sí | 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:
|
Delimitador personalizado (hexadecimal) | Sí | 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 | Sí | 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:
|
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 | Sí | Sí | Heredar | Esta propiedad controla si tiene lugar la validación. Los valores válidos son:
|
validateMaster |
Acción para anomalía | Sí | 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:
|
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. |