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 FileOutput

Utilice el nodo FileOutput para grabar mensajes en archivos.

Finalidad

Puede grabar uno o más mensajes de transacciones de flujos de mensajes en un archivo en el sistema de archivos del intermediario. Cada mensaje, cuando se graba en el archivo, se convierte en una secuencia de bytes denominada registro. Los registros se acumulan hasta que se desencadena un proceso que completa el archivo y lo coloca en el directorio de salida especificado o en un directorio del servidor o SFTP remoto. Las propiedades del nodo especifican cómo se acumulan los registros en los archivos y dónde se colocan los archivos cuando terminan.

El nodo FileOutput se encuentra en la bandeja Archivo de la paleta y está representado en el entorno de trabajo por el siguiente icono:

Icono de nodo FileOutput

Proceso de registros

El nodo FileOutput graba archivos como una secuencia de uno o más registros. Cada registro se genera a partir de un solo mensaje recibido en el terminal In (de entrada) del nodo.

De forma predeterminada, cada archivo consta de un solo registro pero las propiedades del nodo FileOutput pueden especificar que el archivo consta de diversos registros y la forma en que se acumulan tales registros en un archivo. Si se graban varios registros, el nodo FileOutput empieza con un archivo vacío y graba registros en él hasta que se recibe un mensaje en el terminal Finish File. El nodo no añade registros nuevos a un archivo que existe. Pueden acumularse varios registros en un archivo de las siguientes maneras:
  • Concatenados: el registro creado a partir de cada mensaje se añade, sin modificar, al archivo.
  • Rellenados: cada registro se ajusta para que tenga una longitud específica y se rellena con un byte de relleno, si es necesario, antes de añadirlo al archivo.
  • Delimitados: se utiliza un delimitador para separar o terminar los registros cuando se añaden al archivo.

Para cada mensaje recibido, tanto en el terminal In (de entrada) como en el terminal Finish File, puede modificar el directorio de salida y el nombre de archivo que se deben grabar (o finalizar) por el uso de elementos del mensaje. En el nodo, puede especificar estos elementos, que, de forma predeterminada, identifican elementos en el entorno local, en el separador de propiedades de Solicitud.

Proceso de archivos

El nodo FileOutput graba los mensajes acumulados en un archivo y lo coloca en un directorio especificado (el directorio de salida) en uno de los siguientes momentos:
  • Después de cada registro, si el archivo debe contener un solo registro. (Especifique este comportamiento estableciendo la propiedad Definición de registro en El registro es Archivo completo en el separador Registros y elementos.)
  • Cuando un terminal Finish File recibe un mensaje.
El nombre del directorio de salida y los nombres de los archivos de salida vienen determinados por las propiedades del nodo que especifique y por los elementos del mensaje que se está procesando.

El nodo FileOutput utiliza subdirectorios del directorio de salida para almacenar archivos durante el proceso y después del mismo. Todos estos subdirectorios empiezan con el prefijo mqsi e incluir los subdirectorios llamados mqsitransit (el directorio de tránsito) y mqsiarchive (el directorio de archivado). Los registros no se acumulan directamente en un archivo del directorio de salida aunque sí se acumulan en un archivo del directorio de tránsito. Los archivos se mueven del directorio de tránsito al directorio de salida cuando se completa el archivo. Si se ha de mover un archivo al directorio de salida con el mismo nombre que un archivo que ya está allí, puede elegir entre suprimir el archivo del directorio de salida, moverlo al directorio de archivado (mqsiarchive) o renombrarlo antes de moverlos al directorio de archivado.

Puede especificar que el nodo FileOutput transfiera archivos a un servidor FTP o SFTP remoto como parte del proceso de archivos. Si el archivo se transfiere satisfactoriamente, puede suprimirse del sistema de archivos local o, de forma opcional, retenerse para que se lleve a cabo de la forma habitual el resto del proceso de archivos. El servidor se identifica por la propiedad Servidor remoto y puerto en el nodo. Alternativamente, puede alterar temporalmente la propiedad de nodo estableciendo un valor en el entorno local. También puede utilizar el entorno local para especificar que se ejecuten mandatos antes o después de que finalice una transferencia FTP o SFTP. Para obtener más información, consulte Alteraciones temporales del entorno local para el servidor remoto en el nodo FileOutput.

Durante la operación de transferencia de archivos, FileOutput crea el archivo de destino. Sin embargo, el archivo de destino es legible antes de que se complete la transferencia de archivos. Por lo tanto, asegúrese de que las aplicaciones remotas no lean el archivo hasta que se haya completado la transferencia de archivos.

Cuando se graban varios registros, no se lleva a cabo el proceso de archivos hasta que se recibe un mensaje en el terminal Finish File del nodo. Cualquier mensaje recibido en el terminal Finish File hace que el archivo se mueva del directorio de tránsito al directorio de salida especificado o a un directorio FTP o SFTP remoto.

No es un error si el proceso de archivos se inicia cuando no hay ningún archivo en el directorio de tránsito.

Si establece la propiedad Definición de registro en El registro es Archivo completo en el separador Registros y elementos, se hará caso omiso de los mensajes recibidos en el proceso Finish File porque ya se habrá procesado el archivo.

Propagación de mensajes

Para cada mensaje recibido en el terminal In (de entrada) y después que el nodo lo haya procesado correctamente, se propaga una copia al terminal Out (de salida) para procesarla posteriormente si el terminal está conectado.

Para cada mensaje recibido en el terminal Finish File y después que el nodo lo haya procesado satisfactoriamente, se propaga una copia al terminal End of Data para su posterior proceso si el terminal está conectado.

Cuando un nodo FileOutput propaga un mensaje, al terminal Out o al terminal End of Data, éste almacena información en el árbol de mensaje LocalEnvironment.WrittenDestination.File. En esta tabla se describen los elementos de LocalEnvironment.WrittenDestination.File:
Nombre de elemento Tipo de datos de elemento Descripción
Directorio CHARACTER La vía de acceso absoluta del directorio de salida en el formato utilizado por el sistema de archivos del intermediario. Por ejemplo, en sistemas Windows la vía de acceso del directorio empieza por el prefijo de letra de unidad (como C:).
Name CHARACTER Nombre del archivo de salida.
Action CHARACTER Los valores posibles son:
  • Replace si se sustituye un archivo de salida del mismo nombre.
  • Create si se crea un nuevo archivo de salida.
  • Append si este mensaje está asociado con un registro que se añade a un archivo de salida.
  • Finish si se recibe un mensaje de Finish File y no hay ningún archivo para finalizar (por ejemplo, si se especifica El registro es Archivo completo y se envía un mensaje al terminal Finish File).
  • Transmit si el archivo se ha transferido por FTP o SFTP y el archivo no se ha retenido.
Timestamp CHARACTER La fecha y la hora, en formato de serie de caracteres, en las que el nodo a empezado a procesar este archivo. Este valor se añade como prefijo a los nombres de archivos que se archivan si establece la propiedad Acción si el archivo existe en Indicación de fecha y hora, Archivar, Sustituir archivo existente y Añadir a archivo existente en el separador Básicas.

Varias instancias

Es posible que varios flujos de mensajes graben en el mismo archivo, lo que puede ocurrir cuando hay instancias adicionales del flujo, o cuando varios flujos contienen nodos FileOutput. El nodo FileOutput permite que una sola instancia, dentro de un grupo de ejecución y entre grupos de ejecución, grabe en un archivo a la vez. Mientras se está grabando un registro, todas las demás instancias del grupo de ejecución deben esperar. El orden en el que las instancias obtienen acceso no está definido.

Cuando finalice el archivo, la primera instancia en obtener acceso lleva a cabo el proceso y las otras instancias no encontrarán el archivo. El elemento Action del árbol de mensaje de LocalEnvironment.WrittenDestination.File se establece en Finish para todas las instancias que no pueden descubrir el archivo en el directorio de tránsito.

Utilización de este nodo en un flujo de mensajes

El nodo FileOutput se puede utilizar en cualquier flujo de mensajes que envíe mensajes a archivos. Consulte el apartado Cómo trabajar con archivos. También puede consultar los ejemplos siguientes 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.

Si configura un nodo de archivo para utilizar FTP, puede que la red lo necesite para conectarse a un servidor proxy FTP, en lugar de hacerlo directamente al servidor FTP remoto. La forma de configurar los nodos de archivo para utilizar un proxy FTP dependerá de cómo gestione las solicitudes ese proxy. Para algunos proxies FTP, deberá codificar la información del servidor FTP de destino en las credenciales de inicio de sesión que cree con el mandato mqsisetdbparms. Por ejemplo, algunos proxies FTP dan soporte a los valores siguientes:
Username: NombreUsuarioHostDestinoFtp@NombreUsuarioProxy@NombreHostFtpDestino
Password: ContraseñaUsuarioFtpDestino@ContraseñaUsuarioProxy
Otros proxies podrían necesitar distintas codificaciones o puede que requieran una configuración externa o tal vez no pueda utilizarlos con los nodos de archivo.

Configuración del nodo FileOutput

Una vez ha puesto una instancia del nodo FileOutput en un flujo de mensajes, debe configurarlo (para obtener más información, consulte Configurar un nodo de flujo de mensajes). Las propiedades del nodo se muestran en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las propiedades que no tienen un valor predeterminado definido) están marcadas con un asterisco en esta vista.

Terminales y propiedades

Los terminales de nodo FileOutput 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 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 al transferir el mensaje a la cola de salida.

Las tablas siguientes describen las propiedades de nodo que el usuario puede establecer en un separador especificado. 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).

Las propiedades de Descripción del nodo FileOutput están descritas en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No FileOutput El nombre del nodo.
Descripción corta No No   Una 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 FileOutput se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Directorio No Ninguno Especifique el directorio de salida en el que el nodo FileOutput coloca sus archivos. Especifique el directorio como una vía de acceso de directorio relativa o absoluta. Si la vía de acceso de directorio es relativa, se basa en el directorio especificado en la variable de entorno MQSI_FILENODES_ROOT_DIRECTORY. Por ejemplo:
  • En Windows: C:\fileoutput
  • En UNIX: /var/fileoutput
Para grabar archivos en el directorio identificado mediante MQSI_FILENODES_ROOT_DIRECTORY, asegúrese de especificar un valor de . (un punto) en esta propiedad.

Puede alterar temporalmente la vía de acceso del directorio de salida que se va a utilizar estableciendo valores en el mensaje actual. Para obtener más información, consulte las propiedades del separador Solicitud.

outputDirectory
Nombre de archivo o patrón No Ninguno Especifique un patrón de nombre de archivo. Esta propiedad define el nombre del archivo que crea el nodo FileOutput. El valor es un nombre de archivo específico o una secuencia de caracteres (patrón) que coincide con un nombre de archivo. En este campo de propiedad sólo se permiten patrones con un solo carácter comodín (el asterisco, *). El nombre de archivo que se debe utilizar se determina de la forma siguiente:
  • Si el nombre de archivo no contiene ningún comodín, el valor de esta propiedad es el nombre del archivo creado. Este valor debe ser un nombre de archivo válido del sistema de archivos o del sistema de archivos de FTP que aloja el intermediario en el que se despliega el flujo de mensajes.
  • Si el nombre de archivo contiene un solo carácter comodín, el valor del elemento LocalEnvironment.Wildcard.WildcardMatch en el mensaje actual sustituye el carácter comodín, y el valor resultante es el nombre del archivo creado. Este valor debe ser un nombre de archivo válido del sistema de archivos o del sistema de archivos de FTP que aloja el intermediario en el que se despliega el flujo de mensajes. Si no se puede encontrar el valor WildcardMatch, el carácter comodín se sustituye por una serie vacía.
Puede alterar temporalmente el nombre del archivo estableciendo valores en el mensaje actual. Para obtener más información, consulte las propiedades del separador Solicitud. Si la propiedad Nombre de archivo o patrón está vacía, debe alterar temporalmente el nombre utilizando el mensaje actual. La sustitución de caracteres comodín sólo se produce si esta propiedad no se altera temporalmente de esta forma.

Los nombres de archivo se pasan al sistema de archivos al que tiene acceso el intermediario y deben seguir los convenios de estos sistemas de archivos. Por ejemplo, los nombres de archivo en sistemas Windows no son sensibles a las mayúsculas y minúsculas; mientras que en sistemas UNIX lo son.

outputFilename
Modalidad para grabar en el archivo No Almacenar provisionalmente en el directorio de tránsito Especifique si el archivo se debe almacenar o grabar directamente. Seleccione una de las opciones siguientes:
  • Almacenar provisionalmente y mover al directorio de salida cuando finalice el archivo
  • Grabar directamente en el archivo de salida
 
Acción si el archivo exista No Sustituir archivo existente Especifique cómo se va a procesar el archivo cuando se complete. Seleccione una de las opciones siguientes:
  • Sustituir archivo existente (el valor predeterminado) especifica que si existe un archivo con el mismo nombre en el directorio de salida, el nuevo archivo lo sustituye.
  • Añadir a un archivo existente mueve el archivo de salida al directorio de tránsito y añade el contenido del archivo al archivo. El archivo se devuelve al directorio de salida cuando finaliza la adición.
  • Error si el archivo existe especifica que se crea un nuevo archivo, y que si existe un archivo con el mismo nombre en el directorio de salida, el nuevo archivo permanece en el directorio de tránsito y se genera una excepción BIP3307.
  • Archivar y sustituir archivo existente especifica que si existe algún archivo con el mismo nombre en el directorio de salida, dicho archivo se mueve al directorio de archivado antes de que el nuevo archivo se coloque en el directorio de salida. Si existe algún archivo con el mismo nombre en el directorio de archivado, se generará una excepción.
  • Añadir indicación de fecha y hora, archivar y sustituir archivo existente especifica que si existe un archivo con el mismo nombre en el directorio de salida, su nombre se amplíe con una indicación de fecha y hora (una versión basada en caracteres de la fecha y hora) antes de moverlo al directorio de archivado. El formato de la indicación de fecha y hora es aaaaMMdd_HHmmss_SSSUUU, en hora UTC, donde UUU es un ID adicional para asegurar que la indicación de fecha y hora sea exclusiva.
 
Sustituir archivos archivadores duplicados No No seleccionado Marque el recuadro de selección Sustituir archivos archivadores duplicados para especificar que, en los casos en que se especifique Archivar y sustituir archivo existente o Añadir indicación de fecha y hora, archivar y sustituir archivo existente en Acción si el archivo existe, los archivos movidos al directorio de archivado sustituyan a los archivos que ya existen allí con el mismo nombre.

De forma predeterminada, este recuadro de selección está deseleccionado. Si este recuadro de selección no está marcado y si ya hay un archivo en el directorio de archivado con el mismo nombre que un archivo que se va a mover allí, se genera una excepción y el archivo nuevo permanece en el directorio de tránsito.

 

Las propiedades de solicitud del nodo FileOutput se describen en la siguiente tabla.

Estas propiedades especifican la ubicación de los datos que se deben grabar, y la información de control que altera temporalmente las propiedades Directorio y Nombre de archivo o patrón del separador Básicas. 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 abrir utilizando el botón Editar situado a la derecha de cada propiedad.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Ubicación de datos No $Body Especifique la ubicación de datos de entrada, que es la 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 es $Body, que significa todo el cuerpo del mensaje ($InputRoot.Body).
Cuando especifique esta propiedad y los datos del árbol de mensajes al que identifica pertenezcan a un analizador controlado por modelos como, por ejemplo, el analizador MRM o el analizador XMLNSC, tenga en cuenta los factores siguientes.
  • Si utiliza el formato CWF de MRM, asegúrese de que el árbol de mensajes identificado existe como una definición de mensaje. Si este elemento está definido sólo como un elemento global, se generan las excepciones BIP5180 y BIP5167.
  • Si utiliza el formato TDS de MRM, la serialización del mensaje identificado es satisfactoria si el elemento está definido como un elemento global o un mensaje. Sin embargo, si el campo identificado no se encuentra como mensaje o elemento global, se aplican las siguientes condiciones:
    • Si el campo es un campo sin secundarios en el árbol de mensajes, el campo se graba como autodefinido. No se realiza ninguna validación aunque la validación esté habilitada.
    • Si el campo es un elemento complejo, se genera una excepción interna (BIP5522), que indica que el tipo lógico no se puede convertir en una serie.
  • Si utiliza MRM XML, los sucesos son parecidos para el formato TDS de MRM excepto que, si el campo es un elemento complejo, se graba como autodefinido.
  • Si utiliza el analizador XMLNSC, no se produce ninguna validación incluso si la validación está habilitada.
 
Solicitar ubicación de propiedad de directorio $LocalEnvironment/Destino/Archivo/Directorio Especifique la ubicación del valor para alterar temporalmente la propiedad Directorio en el separador Básicas. Si no especifica una ubicación, el valor predeterminado es $LocalEnvironment/Destination/File/Directory. Si especifica una ubicación pero el elemento está vacío o falta, se utiliza la propiedad Directorio. El elemento tiene un tipo de datos CHARACTER y es una vía de acceso de directorio absoluta o relativa. Utilice el carácter separador de vía de acceso ('/' o '\') según el sistema de archivos en el que se ejecute el intermediario. Los caracteres separadores de vía de acceso finales se ignoran. Las vías de acceso de directorio relativas se basan en el valor de la variable de entorno MQSI_FILENODES_ROOT_DIRECTORY. requestDirectoryLocation
Solicitar ubicación de propiedad de nombre de archivo $LocalEnvironment/Destino/Archivo/Nombre Especifique la ubicación del valor para alterar temporalmente la propiedad Nombre de archivo o patrón en el separador Básicas. El elemento tiene un tipo de datos CHARACTER y es un nombre de archivo explícito. No se produce ninguna sustitución de comodín para este valor. Si la propiedad no está en el entorno local cuando el mensaje llega al terminal In (de entrada) o Finish File (finalización de archivo) del nodo, entonces el valor predeterminado debe utilizar la propiedad Nombre de archivo o patrón en el separador Básicas. requestNameLocation

Las propiedades de Registros y elementos del nodo FileOutput se describen en la siguiente tabla.

Estas propiedades especifican cómo graba el nodo FileOutput el registro derivado del mensaje.
Propiedad O C Valor predeterminado Descripción
Definición de registro No El registro es Archivo completo Especifique cómo se colocan los registros en el archivo de salida. Seleccione una de las opciones siguientes:
  • El registro es Archivo completo especifica que el archivo va a contener un solo registro. El archivo finaliza inmediatamente después de grabar el registro; el nodo FileOutput no espera un mensaje en el terminal Finish File. Este valor es el predeterminado.
  • El registro tiene Datos sin modificar especifica que los registros se acumulan en un archivo sin aplicar caracteres de relleno ni delimitadores. El archivo sólo termina cuando se recibe un mensaje en el terminal Finish File.
  • El registro tiene Datos de longitud fija especifica que los registros se rellenan hasta una longitud dada, si es necesario, y se acumulan en un archivo mediante concatenación. Especifique esta longitud en la propiedad Longitud. Si el registro es más largo que el valor especificado en Longitud, el nodo genera una excepción. Utilice la propiedad Byte de relleno para especificar el byte que se debe utilizar para rellenar el mensaje hasta la longitud necesaria. Se añaden registros en este archivo hasta que se recibe un mensaje en el terminal Finish File.
  • El registro tiene Datos delimitados para especificar que los registros se separen por un delimitador y se acumulen mediante encadenamiento. El delimitador se especifica mediante las propiedades Delimitador, Delimitador personalizado y Tipo de delimitador. Se añaden registros en este archivo hasta que se recibe un mensaje en el terminal Finish File.
Longitud No 80 Especifique la longitud (en bytes) de los registros cuando se especifique El registro tiene Datos de longitud fija en Definición de registro. Los registros que tienen una longitud superior a este valor hacen que se genere una excepción. Este valor debe estar en el rango de 1 byte a 104857600 bytes (100 MB). El valor predeterminado es 80 bytes.
Byte de relleno No X'20' Cuando se especifica El registro tiene Datos de longitud fija en Definición de registro, utilice la propiedad Byte de relleno para especificar el byte que se debe utilizar al rellenar registros hasta la longitud especificada si dichos registros tienen una longitud más corta que la especificada. Especifique este valor como dos dígitos hexadecimales. El valor predeterminado es X'20'.
Delimitador No Fin de línea del sistema del intermediario Especifique el delimitador que se debe utilizar si especifica El registro tiene Datos delimitados en Definición de registro. Seleccione una de las opciones siguientes:
  • Fin de línea del sistema del intermediario especifica que se utilice una secuencia de bytes de fin de línea como delimitador, según sea apropiado para el sistema de archivos en el que el intermediario se va a ejecutar. Por ejemplo, en sistemas Windows, el delimitador es un par 'retorno de carro, salto de línea' (X'0D0A'); en sistemas UNIX, es un solo byte de 'salto de línea' (X'0A'); en sistemas z/OS, es un byte de 'nueva línea' (X'15'). Este valor es el predeterminado.
  • Delimitador personalizado especifica que para delimitar registros se va a utilizar la secuencia de delimitador explícita definida en la propiedad Delimitador personalizado.
Delimitador personalizado No No Ninguno Especifique la secuencia de bytes de delimitador que se debe utilizar para delimitar registros cuando se especifica Delimitador personalizado en la propiedad Delimitador. 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.
Tipo de delimitador No Posfijo Si establece la propiedad Definición de registro en El registro tiene Datos delimitados, utilice Tipo de delimitador para especificar cómo va a separar los registros el delimitador. Seleccione una de las opciones siguientes:
  • Posfijo especifica que el delimitador se añade después de grabar cada registro. Este valor es el predeterminado.
  • Infijo especifica que el delimitador sólo se inserta entre dos registros adyacentes.

Las propiedades de validación del nodo FileOutput están descritas 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 Heredar Especifique 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 Especifica lo que 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 FTP del nodo FileOutput se describen en la siguiente tabla.

Para transferir archivos a un servidor FTP o SFTP, seleccione la propiedad Transferencia remota y, a continuación, establezca las propiedades descritas en esta tabla.
Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Transferencia remota No Borrado Para transferir archivos a un servidor FTP o SFTP, seleccione Transferencia remota y, a continuación, establezca las demás propiedades de esta tabla. fileFtp
Protocolo de transferencia No FTP Esta propiedad especifica el protocolo que se debe utilizar para la transferencia remota. Los valores válidos son:
  • FTP
  • SFTP
remoteTransferType
Servidor remoto y puerto No Ninguno Esta propiedad puede tener cualquiera de estos valores:
  • La dirección IP o el nombre (y, opcionalmente, el número de puerto) de un servidor FTP o SFTP remoto
  • El nombre de un servicio configurable de tipo FtpServer
Especifique la dirección IP y el número de puerto del servidor FTP o SFTP que se debe utilizar, empleando la sintaxis siguiente:
  • dirección_IP_o_URL o
  • dirección_IP_o_URL:número_puerto
Si especifica la dirección IP en formato IPv6, asegúrese de especificarlo entre los corchetes, por ejemplo:
  • [12a::13bd:24cd] o
  • [12a::13bd:24cd]:123 donde 123 es el número de puerto
Si está utilizando FTP y no especifica ningún número de puerto, se supone que se trata del puerto 21. Si está utilizando SFTP y no especifica ningún número de puerto, se supone que se trata del número de puerto 22. Sin embargo, si se ha definido un servicio configurable FtpServer, puede especificar el nombre del servicio configurable en este campo. Si se especifica un nombre de servicio configurable, se podrán alterar temporalmente las propiedades (alguna o todas) de la transferencia remota en el separador FTP mediante el servicio configurable. Para obtener información sobre cómo interactúan una definición de servicio configurable FtpServer y las propiedades de este separador, consulte Servicio configurable FtpServer.

Puede alterar temporalmente esta propiedad estableciendo la ubicación del servidor en el entorno local. Para obtener más detalles, consulte Alteraciones temporales del entorno local para el servidor remoto en el nodo FileOutput.

fileFtpServer
Identidad de seguridad No Ninguno Especifique el nombre de una identidad de seguridad que se haya definido utilizando el mandato mqsisetdbparms. El identificador de usuario y la contraseña que se deben utilizar para iniciar la sesión en el servidor FTP o SFTP se obtienen de esta definición. El nombre de la definición debe tener el prefijo ftp::. El valor de esta propiedad se altera temporalmente mediante el valor de la propiedad securityIdentity del servicio configurable de FtpServer, si se ha establecido. fileFtpUser
Directorio de servidor No "." Especifique el directorio en el servidor FTP o SFTP al que se van a transferir los archivos. El valor predeterminado es . (un punto), que indica el directorio predeterminado después del inicio de sesión. Si especifica una vía de acceso relativa, el directorio se basará en el directorio predeterminado después del inicio de sesión FTP o SFTP. Asegúrese de que la sintaxis de la vía de acceso se ajuste a los estándares de sistemas de archivos del servidor FTP o SFTP. El valor de esta propiedad se altera temporalmente mediante el valor de la propiedad remoteDirectory del servicio FtpServer configurable, si se ha establecido. fileFtpDirectory
Modalidad de transferencia No Binaria Especifique cómo se transfieren los archivos. Si el contenido del archivo no se transforma, seleccione Binaria. Si el archivo se transmite como ASCII, seleccione ASCII. El valor de esta propiedad se altera temporalmente mediante el valor de la propiedad transferMode del servicio configurable FtpServer, si se ha establecido.

Esta propiedad es válida solamente cuando se selecciona FTP como protocolo para la transferencia remota. Si ha especificado SFTP como protocolo, se hace caso omiso de la propiedad Modalidad de transferencia y se utiliza codificación Binaria.

 
Acción si el archivo remoto existe No No Sustituir archivo Especifique si debe crearse el archivo o añadirse a un archivo existente. Seleccione una de las opciones siguientes:
  • Sustituir archivo existente (el valor predeterminado) especifica que si existe un archivo con el mismo nombre en el directorio de salida, el nuevo archivo lo sustituye. El archivo se sustituye utilizando el verbo FTP put.
  • Añadir a un archivo existente mueve el archivo de salida al directorio de tránsito y añade el contenido del archivo al archivo. El archivo se transfiere a la máquina remota utilizando el verbo FTP append y se devuelve al directorio de salida cuando finaliza la adición.
 
Retener archivo local después de transferencia No No Borrado Para retener una copia local del archivo una vez completado el proceso de transferencia de archivos, seleccione el recuadro Retener archivo local después de transferencia. Si este recuadro está seleccionado, las copias locales se procesan una vez completada la transferencia, al igual que otros archivos de salida, tal como se especifica en el separador Básicas. Si el recuadro no está seleccionado, los archivos transferidos satisfactoriamente no se retienen localmente.  
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:44


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