fteCreateTransfer (iniciar una nueva transferencia de archivos)

Finalidad

Para obtener instrucciones sobre cómo transferir archivos, consulte Directrices para transferir archivos. Para la plataforma z/OS , puede transferir archivos de texto, conjuntos de datos y grupos de datos de generación (GDG).

Puede ejecutar el mandato fteCreateTransfer desde cualquier sistema que se pueda conectar a la red de IBM® MQ y, a continuación, direccionar al gestor de colas del agente de origen. Específicamente, para que se ejecute el mandato, debe instalar un componente Managed File Transfer (ya sea Servicio o Agente) en este sistema y configurar el componente Managed File Transfer en este sistema para que se comunique con la red IBM MQ .

Este mandato utiliza un archivo de propiedades denominado command.properties para conectarse a la red de IBM MQ . Si el archivo command.properties no contiene información de propiedades, se establece una conexión de modalidad de enlaces con el gestor de colas predeterminado del sistema local. Si el archivo command.properties no existe, se genera un error. Para obtener más información, consulte El archivo MFT command.properties.

Puede especificar varios archivos de origen para una transferencia de archivo pero se deben originar desde un mismo agente de origen y terminar en un mismo agente de destino. Transferir un único archivo de origen a varios archivo de destino en el mismo agente o en varios agentes distintos no está soportado en una misma transferencia. Los scripts Ant se pueden utilizar para enviar el mismo archivo de origen a varios destinos en uno o varios agentes. Para obtener más información, consulte Utilización de Apache Ant con MFT.

Caracteres especiales

Tenga cuidado cuando utilice parámetros que contienen caracteres especiales para evitar que el shell de mandatos interprete los caracteres de una forma imprevista. Por ejemplo, los nombres de conjunto de datos totalmente calificados que contienen comillas simples y las especificaciones de origen que contienen caracteres de asterisco podrían ser interpretados por el shell de mandatos en vez de pasarlos en la solicitud de transferencia. Para evitar que el shell de mandatos interprete los caracteres, encierre el parámetro entero entre comillas dobles o utilice la secuencia de escape del shell de mandatos para escapar los caracteres especiales.

Vías de acceso relativas

transferRoot=directory_name

Por ejemplo, especifique C:\TransferRoot como C:\\TransferRoot o C:/TransferRoot.

En z/OS, de forma predeterminada, el nombre de usuario bajo el que se ejecuta el agente se añade como prefijo de calificador de alto nivel a las especificaciones de conjunto de datos que no se han calificado al completo. Por ejemplo: //ABC.DEF. Para cambiar el valor que se añade como prefijo al nombre de conjunto de datos, establezca la propiedad transferRootHLQ en el archivo agent.properties. Este archivo se encuentra en el directorio MQ_DATA_PATH/mqft/config/coordination_qmgr/agents/agent_name . Añada la línea siguiente al archivo:

transferRootHLQ=prepend_value

Sin embargo, para las transferencias que implican un nodo Connect:Direct® en un sistema z/OS , la especificación del conjunto de datos se interpreta como un nombre completo. No se añade ningún calificador de alto nivel al nombre de conjunto de datos.

Parámetros para la invocación del agente

-sa nombre-agente-origen

Necesario. El nombre del agente del que se transfiere los archivos de origen.

Si especifica un agente de puente de protocolo como agente de origen, no podrá especificar un conjunto de datos como especificación de archivo de origen.

Si especifica el parámetro -td y el archivo de definición de transferencia contiene el agente de origen que desea utilizar para la transferencia, no especifique el parámetro -sa.

-sm nombre_gestor_agente_origen

Opcional. El nombre del gestor de colas al que está conectado al agente de origen.

Si no especifica el parámetro -sm, el gestor de colas que se utiliza lo determina el conjunto de opciones de configuración en uso, que se basa en el nombre de agente de origen. Si el archivo agent.properties para el agente de origen no se puede encontrar, la transferencia de archivos no se ejecuta correctamente.

-da nombre_agente_destino

Necesario. El nombre del agente al que se transfieren los archivos.

Si especifica el parámetro -td y el archivo de definición de transferencia contiene el agente de destino que desea utilizar para la transferencia, no especifique el parámetro -da.

-dm nombre_gestor_agente_destino

Opcional. El nombre del gestor de colas al que está conectado el agente de destino.

Si no especifica el parámetro -dm, el gestor de colas que se utiliza lo determina el conjunto de opciones de configuración en uso, que se basa en el nombre de agente de destino. Si el archivo agent.properties para el agente de destino no se puede encontrar, la transferencia de archivos no se ejecuta correctamente.

Parámetros para la generación de plantillas de transferencia

-gt vía_acceso_archivo_plantilla_transferencia

Opcional. Genera un mensaje XML de plantilla de transferencia y graba este mensaje en un archivo. Si especifica este parámetro, no se envía ninguna solicitud de transferencia a Managed File Transfer. En lugar de ello, se graba el contenido del mensaje de solicitud de transferencia en el documento XML nombrado. A continuación, puede utilizar este documento XML para definir la tarea para supervisión de recursos. Consulte el comandofteCreateMonitor para obtener información sobre cómo crear un monitor de recursos. Si no especifica este parámetro, tiene lugar el comportamiento predeterminado y se lleva a cabo una solicitud de transferencia real.

Debe proporcionar la vía de acceso y el nombre completos de un archivo de salida XML como entrada de este parámetro, por ejemplo C:\templates\transfer_reports.xml

En z/OS, debe almacenar el documento de plantilla de transferencia en un archivo UNIX en z/OS UNIX System Services. No se pueden almacenar documentos de plantilla de transferencia en archivos secuenciales en z/OS o miembros PDS.

En IBM i, debe almacenar el documento de plantilla de transferencia en el sistema de archivos integrado.

El mensaje XML de plantilla de transferencia que crea utilizando el parámetro -gt no es la misma que la plantilla de transferencia que crea utilizando el mandato fteCreateTemplate, lo que significa que no puede utilizar los dos tipos diferentes de plantilla indistintamente.

Nota: Si desea generar un documento XML de plantilla de transferencia ejecutando el mandato fteCreateTransfer con el parámetro -gt y, a continuación, proporcionar dicho documento XML de plantilla de transferencia como entrada al mandato fteCreateTransfer utilizando el parámetro -td , debe asegurarse de que el documento XML de plantilla de transferencia se ha generado especificando los parámetros que son mutuamente excluyentes con la opción -td .

Los parámetros mutuamente excluyentes con la opción -td son:

• -dd directorio_destino
• Vía de acceso de origen
• -df archivo_destino
• -cs suma de comprobación
• -de comportamiento_archivo_destino
• -dq cola_destino
• -t tipo_transferencia
• -sd disposición_archivo_origen

Por ejemplo, no es posible especificar los parámetros -td y -t (indicando si la transferencia es binaria o de texto) en el mandato fteCreateTransfer . Esto significa que si desea pasar un documento XML de plantilla de transferencia al mandato y especificar que la transferencia debe ser una transferencia de texto, debe crear el documento XML especificando los parámetros de texto -gt y -t .

Este parámetro no está soportado en REST API.

Parámetros para la planificación de transferencias

-ss hora_inicio_planificación

Opcional. Especifica la hora y la fecha en que desea que la transferencia planificada tenga lugar. Utilice uno de los siguientes formatos para especificar la hora y la fecha. Especifique la hora utilizando el reloj de 24 horas:

yyyy-MM-ddThh:mm

hh:mm

Las transferencias de archivos planificadas empiezan al cabo de un minuto de la hora de inicio de planificación, si no existan problemas que puedan afectar a la transferencia. Por ejemplo, podrían surgir problemas con la red o el agente que impidan que se inicie la transferencia planificada.

-tb

Opcional. Especifica la base horaria que desea utilizar para la transferencia de archivos planificada. Es decir, si desea utilizar el tiempo del sistema o la hora universal coordinada (UTC). Debe utilizar este parámetro únicamente con el parámetro -ss. Especifique una de las opciones siguientes:

admin

Las horas de inicio y finalización utilizadas para la transferencia programada se basan en la hora y fecha del sistema en el que se inicia la transferencia. Por ejemplo, podría ser la hora y fecha de la máquina en la que se inicia una transferencia a través del comando fteCreateTransfer o IBM MQ Explorer.

Nota: Cuando se inicia una transferencia utilizando el REST API, la opción de administración se asigna a la hora y fecha de la máquina en la que se está ejecutando el servidor web IBM MQ .

source

Las horas de inicio y finalización de la transferencia planificada se basan en la hora y la fecha del sistema donde está ubicado el agente de origen.

UTC

Las horas de inicio y finalización utilizadas para la transferencia planificada se basan en la hora Universal coordinada (UTC).

-oi

Opcional. Especifica el intervalo en el que se produce la transferencia. Debe utilizar este parámetro únicamente con el parámetro -ss. Especifique una de las opciones siguientes:

minutos

horas

días

semanas

meses

años

-of frecuencia_apariciones

Opcional. Especifica con qué frecuencia se realiza la transferencia planificada. Por ejemplo, cada 5 semanas o cada 2 meses. Debe especificar este parámetro únicamente con los parámetros -oi y -ss. Si no especifica este parámetro, se utiliza un valor predeterminado de 1.

-oc recuento_apariciones

Opcional. Especifica cuántas veces desea que se produzca esta transferencia planificada. Una vez que se alcanza el número de apariciones, se suprime la transferencia planificada.

Especifique este parámetro únicamente con los parámetros -oi y -ss.

Si especifica el parámetro -oc, no podrá especificar el parámetro -es porque estos parámetros son mutuamente exclusivos.

Puede omitir los parámetros -oc y -es con objeto de crear una transferencia que se repita indefinidamente.

-es hora_final_planificación

Opcional. La fecha y la hora de finalización de una transferencia planificada repetitiva.

Debe especificar este parámetro únicamente con los parámetros -oi y -ss.

Si especifica el parámetro -es, no podrá especificar el parámetro -oc porque estos parámetros son mutuamente exclusivos.

Puede omitir los parámetros -es y -oc con objeto de crear una transferencia que se repita indefinidamente.

Utilice uno de los siguientes formatos para especificar la fecha y la hora de finalización. Especifique la hora utilizando el reloj de 24 horas:

yyyy-MM-ddThh:mm

hh:mm

Parámetros para desencadenar transferencias

-tr

Opcional. Especifica una condición que debe cumplirse para que tenga lugar esta transferencia de archivos. Si la condición no es verdadera, de acuerdo con el agente de origen, se descarta la transferencia de archivos y no se realiza ninguna transferencia. Especifique el formato siguiente:

condition,namelist

donde condición es uno de los valores siguientes:

file=exist

Existe como mínimo uno de los archivos en la lista de nombres. Es decir, si existe alguno de los archivos en la lista de nombres, la condición se cumple.

file!=exist

No existe como mínimo uno de los archivos en la lista de nombres. Es decir, si no existe ninguno de los archivos en la lista de nombres, la condición se cumple.

filesize> =tamaño

Existe como mínimo uno de los archivos en la lista de nombres y tiene el tamaño mínimo especificado en tamaño. tamaño es un entero con una unidad de tamaño opcional de KB, MB o GB. Por ejemplo, filesize">"=10KB. Si no especifica una unidad de tamaño, se presupone que el tamaño es en bytes. En todos los sistemas operativos, debe escribir el símbolo mayor que (>) entre comillas dobles cuando especifique la opción filesize en la línea de mandatos, tal como se muestra en este ejemplo.

Y donde listanombres es una lista separada por comas de nombres de archivos situados en el mismo sistema que el agente de origen. En función del sistema operativo, si desea utilizar nombres de vías de acceso o nombres de archivos en una lista de nombres que contenga espacios, puede que tenga que escribir los nombres de vías de acceso y los nombres de archivos entre comillas.

Puede especificar más de una condición desencadenante utilizando el parámetro -tr más de una vez. No obstante, en dicho caso, cada condición desencadenante separada debe cumplirse para que se produzca la transferencia de archivos.

Nota: Para supervisar continuamente un recurso para que una condición desencadenante sea verdadera, se recomienda encarecidamente utilizar la supervisión de recursos. Puede crear un monitor de recursos utilizando el fteCreateMonitor comando.

En el ejemplo siguiente, el archivo file1.doc se transfiere de AGENT1 a AGENT2, con la condición de que exista el archivo A.txt, o el archivo B.txt, o bien ambos archivos en AGENT1 y de que el archivo A.txt o el archivo B.txt o ambos archivos sean iguales a o mayores que 1 GB:

fteCreateTransfer -sa AGENT1 -sm QM_JUPITER -da AGENT2 -dm QM_NEPTUNE
-tr file=exist,C:\export\A.txt,C:\export\B.txt
-tr filesize">"=1GB,C:\export\A.txt,C:\export\B.txt
-df C:\import\file1.doc C:\export\file1.doc 

Puede combinar los parámetros de desencadenamiento con los parámetros de planificación. Si especifica ambos tipos de parámetros, las condiciones desencadenantes se aplican a la transferencia de archivos creada mediante los parámetros de planificación.

El parámetro -tr no es compatible con los agentes de puente de protocolo ni en el CreateTransfer REST API.

-tl

Opcional. Especifica si las anomalías desencadenantes se registran en el registro de transferencias. Especifique una de las opciones siguientes:

sí

Se crean entradas de registro de transferencias para transferencias desencadenantes anómalas. Este comportamiento es el que se produce aunque no especifique el parámetro -tl.

no

No se crean entradas de registro de transferencias para transferencias desencadenas anómalas.

Parámetros para especificar opciones de transferencia

-jn nombre_trabajo

Opcional. Un identificador de nombre de trabajo definido por el usuario que se añade al mensaje de registro de transferencia cuando se inicia la transferencia.

-md

Opcional. Especifica los metadatos definidos por el usuario que se pasan a los puntos de salida ejecutados por el agente. El parámetro -md puede tomar uno o varios pares de nombre-valor separados por comas. Cada par de nombres consta de name=value. Puede utilizar el parámetro -md más de una vez en un mandato.

Cuando la propiedad de agente enableUserMetadataOptions se establece en un valor de true, determinadas claves de metadatos definidas por el usuario proporcionan más opciones a la transferencia. Para obtener más información sobre las claves de metadatos definidas por el usuario que se admiten actualmente, consulte enableUserMetadataOptions: Claves de metadatos definidas por el usuario ' MFT ' admitidas. Cuando la propiedad enableUserMetadataOptions se establece en true, los nombres de clave que empiezan por com.ibm.wmqfte. no están soportados para el uso definido por el usuario.

Los metadatos de usuario proporcionados en el mandato fteCreateTransfer se ponen a disposición como una variable de entorno para un proceso llamado a través de los parámetros presrc, postsrc, predsty postdst .

Por ejemplo, la siguiente transferencia da como resultado que una variable de entorno denominada procname se establezca en compress (procname=compress) y esté disponible para el script proc.sh :

fteCreateTransfer -sa ESBPA1 -sm ESBP10 -da INFOPA1 
-dm INFOP1 -md procname=compress -df /home/mqm/hosts.out /etc/hosts -de overwrite 
-postdst /home/mqm/proc.sh

-cs suma de comprobación

Opcional. Especifica si un algoritmo de suma de comprobación se ejecuta en los datos de transferencia de archivos para comprobar la integridad de los archivos transferidos. Especifique una de las opciones siguientes:

MD5

Calcula una suma de comprobación MD5 para los datos. La suma de comprobación resultante para los archivos de origen y de destino se escribe en el registro de transferencias para fines de validación. De forma predeterminada, Managed File Transfer calcula las sumas de comprobación MD5 para todas las transferencias de archivos.

ninguno

No se calcula ninguna suma de comprobación MD5 para los datos de transferencia de archivos. El registro de transferencias registra que la suma de comprobación estaba establecida en none y que el valor de la suma de comprobación está en blanco. Por ejemplo:

<checksum method="none"></checksum>

Si se utiliza la opción none, es posible que el rendimiento de la transferencia de archivos mejore, en función del entorno. Sin embargo, seleccionar esta opción quiere decir que no se realiza ninguna validación de los archivos de origen o de destino.

Si especifica el parámetro -cs, no podrá especificar el parámetro -td porque estos parámetros son mutuamente exclusivos. No obstante, puede especificar el comportamiento de la suma de comprobación en el archivo de definición de transferencia.

-pr prioridad_transferencia

Opcional. Especifica el nivel de prioridad de la transferencia. La prioridad es un valor que está en el rango 0-9, donde 0 es la prioridad más baja. El nivel de prioridad predeterminado es el nivel de prioridad del agente de origen.

Este valor coincide con el valor de prioridad de mensaje de IBM MQ, consulte Obtención de mensajes de una cola: prioridad para obtener más información. El tráfico de mensajes para los datos de transferencia de archivos toma de forma predeterminada un nivel de prioridad de 0, lo que permite que el tráfico de mensajes de IBM MQ tenga prioridad.

-qmp booleano

Opcional. Especifica si el primer mensaje grabado en la cola de destino por la transferencia tiene establecidas las propiedades de mensaje IBM MQ . Las opciones válidas son las siguientes:

true

Establece propiedades de mensaje en el primer mensaje creado por la transferencia.

falso

No establece propiedades de mensajes en el primer mensaje creado por la transferencia. Éste es el valor predeterminado.

Sólo puede especificar el parámetro -qmp si también especifica el parámetro -dq. Para obtener más información, consulte MQ propiedades de los mensajes establecidas por MFT en los mensajes escritos en las colas de destino

-qs tamaño_mensaje

Opcional. Especifica si dividir el archivo en varios mensajes de longitud fija. Todos los mensajes tienen el mismo ID de grupo IBM MQ ; el último mensaje del grupo tiene establecido el distintivo IBM MQ LAST_MSG_IN_GROUP. El tamaño del mensaje es especificado por el valor de mensaje_tamaño. El formato de tamaño_mensaje es longitudunidades, donde longitud es un valor de entero positivo y unidades es uno de los siguientes valores:

B

Bytes. El valor mínimo permitido es dos veces el valor máximo de bytes por carácter de la página de códigos de los mensajes de destino.

K

Esto equivale a 1024 bytes.

M

Esto equivale a 1048576 bytes.

Si el archivo se transfiere en modalidad de texto, y está en un juego de caracteres de doble byte o un juego de caracteres de varios bytes, el archivo se divide en mensajes en el límite de caracteres más cercano al tamaño de mensaje especificado.

Sólo puede especificar el parámetro -qs si también especifica el parámetro -dq. Puede especificar solo uno de los parámetros -qs, -dqdb y -dqdt.

-qi

Opcional. El uso de esta opción incluye el delimitador que se utiliza para dividir el archivo en varios mensajes en los mensajes. Se incluye el delimitador al principio o al final del mensaje, en función del parámetro -dqdp (que especifica prefijo o postfijo). De forma predeterminada, el delimitador no se incluye en los mensajes.

Sólo puede especificar el parámetro -qi si también especifica uno de los parámetros -dqdt y -dqdb.

--p opciones_configuración

Opcional. Este parámetro determina el conjunto de opciones de configuración utilizado para crear la transferencia de archivo. Utilice el nombre de un gestor de colas de coordinación no predeterminado como entrada de este parámetro. A continuación, el mandato utiliza el conjunto de archivos de propiedades que están asociadas con este gestor de colas de coordinación no predeterminado.

Si no especifica este parámetro, se utilizará el conjunto de opciones de configuración que se basan en el gestor de colas de coordinación predeterminado.

Este parámetro no es compatible con la interfaz de REST API .

-w TiempoEspera

Opcional. Especificar el parámetro -w hace que el mandato fteCreateTransfer espere una respuesta del agente. Si no especifica este parámetro, el mandato fteCreateTransfer espera un máximo de cinco segundos para recibir un acuse de recibo del agente de origen para la transferencia que indique que el agente ha recibido la solicitud de transferencia. Si no se recibe ningún acuse de recibo durante la espera de cinco segundos, el mandato fteCreateTransfer devuelve el siguiente mensaje de aviso:

BFGCL0253W: No acknowledgment to command from agent within timeout.

El código de retorno será 0, a menos que haya utilizado la opción -w en la línea de mandatos.

El argumento tiempo_espera es opcional. Si especifica tiempo_espera, el mandato fteCreateTransfer esperará tanto segundos como el valor de tiempo_espera hasta que el agente responda. Si el agente no responde antes de que se alcance el límite de tiempo, el mandato genera un aviso y finaliza con un código de retorno de 2 o 3. If you do not specify a tiempo de espera value, or you specify a tiempo de espera value of -1, then the command waits until the agent responds.

El servicio REST no proporciona una opción equivalente para este parámetro, ya que no se recomienda el tiempo de espera ideal en una implementación de servicio REST.

-rt tiempo_espera_recuperación

Opcional. Establece la cantidad de tiempo, en segundos, durante el cual un agente de origen sigue intentando recuperar una transferencia de archivo estancada. Especifique una de las opciones siguientes:

-1

El agente sigue intentando recuperar la transferencia estancada hasta que ésta se lleve a cabo. La utilización de esta opción equivale al comportamiento predeterminado del agente cuando la propiedad no se ha establecido.

0

El agente detiene la transferencia de archivo tan pronto como se inicia la recuperación.

>0

El agente sigue intentando recuperar la transferencia estancada durante el periodo de tiempo en segundos según se haya establecido mediante el valor entero positivo especificado. Por ejemplo,

-rt 21600

indica que el agente sigue intentando recuperar la transferencia durante 6 horas desde que se inició la recuperación. El valor máximo para este parámetro es 999999999.

Si se especifica el valor de tiempo de espera de recuperación de transferencia de esta forma, se establece en base a la transferencia. Para establecer un valor global para todas las transferencias en una red Managed File Transfer , puede añadir una propiedad al archivo The agent.properties.

Parámetros para la invocación de programas

Para obtener más información sobre cómo puede iniciar un programa desde Managed File Transfer, consulte Especificación de programas para ejecutar con MFT. Para ver ejemplos de especificación de un programa a invocar utilizando los parámetros que se describen aquí, consulte Ejemplos de uso de fteCreateTransfer para iniciar programas.

-presrc pre_llamada_origen

Opcional. Especifica el programa a invocar en el agente de origen antes de iniciar la transferencia. Utilice el formato siguiente para llamada_origen_anterior:

[type:]commandspec[,[retrycount][,[retrywait][,successrc]]]

En esta sintaxis, las variables son:

tipo

Opcional. Los valores válidos son executable, antscript, y jcl. El valor predeterminado es executable.

El valor de " jcl " solo es aplicable cuando se dirige a un agente en un entorno de " z/OS ". En este caso, el mandato hace referencia a un archivo ZFS, un conjunto de datos legible por QSAM o un miembro de un PDS. El contenido debe ser JCL que se pueda enviar.

especMandato

Necesario. La especificación del mandato. Utilice uno de los siguientes formatos:

• Escriba executable: command[(arg1,arg2,...)]

  Si los argumentos contienen sustituciones de variables, como ${FilePath} o ${FileName}, que sólo son válidas si la sustitución se inicia mediante un supervisor de recursos, las variables se sustituyen por el primer elemento de la solicitud de transferencia.

  Por ejemplo, si una solicitud de transferencia consta de los archivos "reports01.csv, reports02.csv, reports03.csv" y el directorio de destino es "/output", la siguiente solicitud de transferencia:

  
  fteCreateTransfer -sa 1 -da 2 -presrc "executable:archive(${FileName})" 
  -dd TargetDir "${FilePath}" -gt task.xml

  se sustituye por

  
  fteCreateTransfer -sa 1 -da 2 -presrc "executable:archive(reports01.csv)" 
  -dd TargetDir "/ouptut" -gt task.xml

• Escriba antscript: command[(name1=var1|target1,name2=var2|target2,...)]
• Escriba jcl: command

donde:

mandato

Necesario. El nombre del programa a llamar.

El valor jcl sólo es aplicable cuando está destinado a un agente en un entorno z/OS .

Los argumentos entre corchetes ([ ]) son opcionales y la sintaxis depende del tipo de mandato. Los caracteres de paréntesis, comas (,) y barra inclinada invertida (\) que están dentro del mandato o los parámetros se deben codificar con un carácter de escape de barra inclinada invertida (\).

retrycount

Opcional. El número de veces que se reintenta llamar al programa si el programa no devuelve un código de retorno satisfactorio. El valor predeterminado es 0.

retrywait

Opcional. El tiempo de espera, en segundos, antes de intentar de nuevo la invocación de programa. El valor predeterminado es 0 (no hay espera entre reintentos).

successrc

Opcional. Expresión que se utiliza para determinar cuándo la invocación de programa se ejecuta satisfactoriamente. Esta expresión puede estar compuesta de una o más expresiones. Combine estas expresiones con un carácter de barra vertical (|) para representar un valor booleano OR, o un ampersand (&) para representar el valor booleano AND. Cada expresión tiene el siguiente formato:

[>|<|!]value

donde

>

Opcional. Una prueba 'mayor que' del valor.

<

Opcional. Una prueba 'menor que' del valor.

!

Opcional. Una prueba no igual del valor.

valor

Necesario. Un entero válido.

Si no especifica este parámetro, se utiliza un valor predeterminado de 0 .

-predst pre_llamada_destino

Opcional. Especifica el programa a invocar en el agente de destino antes de iniciar la transferencia. llamada_destino_anterior tiene el mismo formato que llamada_origen_anterior.

-postsrc post_llamada_origen

Opcional. Especifica el programa a invocar en el agente de origen cuando la transferencia haya finalizado. llamada_origen_posterior tiene el mismo formato que llamada_origen_anterior.

-postdst post_llamada_destino

Opcional. Especifica el programa a invocar en el agente de destino cuando la transferencia haya finalizado. llamada_destino_posterior tiene el mismo formato que llamada_origen_anterior.

Parámetros para especificar el destino

Es necesario uno de los parámetros -td, -df, -dd, -ds, -dqy -dp . No puede especificar más de uno de estos parámetros en una solicitud de transferencia; se excluyen mutuamente.

-td archivo_definición_transferencia

Opcional. El nombre del documento XML que define una o varias especificaciones de archivos de origen y destino para la transferencia. Alternativa, el nombre del documento XML que contiene una solicitud de transferencia gestionada (que puede haber sido generada por el parámetro -gt). Si especifica el parámetro -td y también cualquier otro parámetro en la línea de mandatos, estos otros parámetros alterarán temporalmente el valor correspondiente del archivo de definición de transferencia.

El mandato fteCreateTransfer ubica el archivo de definición de transferencia en relación con el directorio actual. Si no puede utilizar la notación de vía de acceso relativa para especificar la ubicación del archivo de definición de transferencia, utilice en su lugar la vía de acceso completa y el nombre de archivo del archivo de definición de transferencia.

En z/OS, debe almacenar el archivo de definición de transferencia en un archivo de configuración de transferencia ( UNIX ) en z/OS UNIX System Services. No puede almacenar archivos de definición de transferencia en archivos secuenciales de z/OS o miembros PDS.

En IBM i, debe almacenar el archivo de definición de transferencia en el sistema de archivos integrado.

Para obtener más información, consulte Utilización de archivos de definición de transferencia.

-df archivo_destino

Opcional. El nombre del archivo de destino.

Si el agente de destino es un agente de puente Connect:Direct , el archivo de destino se especifica con el formato connect_direct_node_name:file_path. El agente de puente Connect:Direct sólo acepta vías de acceso de archivo especificadas en este formato. Si el agente de destino es un agente puente ( Connect:Direct ) y el destino es un miembro PDS, también debe especificar el parámetro -de con un valor de overwrite.

Tenga en cuenta la información siguiente:

• Si el agente de destino es un agente de puente de protocolo y desea especificar un punto final para un archivo, utilice el formato siguiente:

  protocol_server:file_path

  donde servidor_protocolo es el nombre del servidor de protocolo (que es opcional) y vía_acceso_archivo es la vía de acceso del archivo en el sistema del servidor de protocolo. Si no especifica un servidor de protocolo, se utiliza el servidor de protocolo predeterminado.
• Si desea invocar cualquiera de las salidas de usuario de E/S de transferencia de Managed File Transfer que ha definido en el agente de destino, puede utilizar el parámetro -df en una transferencia.
• Cuando el agente de destino está en z/OS, si el archivo especificado comienza por //, se asume que es un conjunto de datos de particiones ( z/OS ).

-dd directorio_destino

Opcional. El nombre del directorio al que se transfiere el archivo. Especifique un nombre de directorio válido en el sistema donde se ejecuta el agente de destino.

Si el agente de destino es un agente de puente Connect:Direct , el directorio de destino se especifica con el formato connect_direct_node_name:directory_path. Si el agente de destino es un agente de puente Connect:Direct y el destino es un PDS, también debe especificar el parámetro -de con un valor de sobrescritura.

Tenga en cuenta la información siguiente:

• Si el agente de destino es un agente de puente de protocolo y desea especificar un directorio para un punto final determinado, utilice el formato siguiente:

  protocol_server:directory_path

  donde servidor_protocolo es el nombre del servidor de protocolo (que es opcional) y vía_acceso_directorio es la vía de acceso de directorio en el sistema del servidor de protocolo. Si no especifica un servidor de protocolo, se utiliza el servidor de protocolo predeterminado.

• Si desea invocar cualquiera de las salidas de usuario de E/S de transferencia de Managed File Transfer que ha definido en el agente de destino, puede utilizar el parámetro -dd en una transferencia.

• Cuando el agente de destino está en z/OS, si el archivo especificado comienza por //, se asume que es un conjunto de datos particionado z/OS .

- ds destination_sequential_data_set

Solo z/OS. Opcional. El nombre del conjunto de datos secuenciales o miembro PDS a los que se transfieren los archivos. Especifique un nombre de conjunto de datos secuenciales o un miembro del conjunto de datos particionados. Para obtener información sobre la transferencia de conjuntos de datos, consulte las Directrices para la transferencia de archivos.

La sintaxis del nombre del conjunto de datos es la siguiente:

 //data_set_name{;attribute(value);..;attribute(value)} 

o

 //pds_data_set_name(member_name){;attribute(value);..;attribute(value)}

Es decir, un especificador de nombre de conjunto de datos con el prefijo // y opcionalmente seguido por un número de atributos separados por punto y coma.

Por ejemplo:

//'TEST.FILE.NAME';DSNTYPE(PDS);RECFM(F,B);BLKSIZE(800);LRECL(80);CYL;SPACE(2,2)

Si el conjunto de datos se encuentra en un nodo Connect:Direct , debe añadir el nombre de nodo al prefijo del nombre del conjunto de datos. Por ejemplo:

CD_NODE1://'OBJECT.LIB';RECFM(F,B);BLKSIZE(800);LRECL(80)

Si el agente de destino es un agente de puente Connect:Direct y el destino es un miembro PDS, también debe especificar el parámetro -de con un valor de sobrescritura. Para obtener más información sobre las transferencias de conjuntos de datos hacia o desde nodos de Connect:Direct , consulte Transferencia de conjuntos de datos hacia y desde nodos de Connect:Direct.

Para las transferencias que sólo implican agentes de Managed File Transfer , si la parte de nombre de conjunto de datos está entre comillas simples, especifica un nombre de conjunto de datos completo. Si el nombre de conjunto de datos no está encerrado entre caracteres de comillas simples, el sistema añade el calificador de alto nivel predeterminado para el agente de destino (bien el valor de la propiedad de agente transferRootHLQ o el ID de usuario con el que se ejecuta el agente, si no se ha establecido transferRootHLQ).

Nota: Sin embargo, para las transferencias que implican un nodo de tipo " Connect:Direct " en un sistema de tipo " z/OS ", la especificación del conjunto de datos se interpreta como un nombre completo. No se añade ningún calificador de alto nivel al nombre de conjunto de datos. Este es el caso incluso si el nombre del conjunto de datos está entre comillas simples.

Cuando transfiere un archivo o conjunto de datos a cinta, se sustituye cualquier conjunto de datos existente que ya se encuentra en la cinta. Los atributos del nuevo conjunto de datos se establecen a partir de los atributos que se pasan en la definición de transferencia. Si no se especifica ningún atributo, los atributos se establecen en el mismo conjunto de datos de origen o en los valores predeterminados cuando el origen es un archivo. Se ignoran los atributos de un conjunto de datos de cinta existente.

Los atributos del conjunto de datos se utilizan para crear un conjunto de datos o para garantizar que un conjunto de datos existente sea compatible. La especificación de los atributos del conjunto de datos está en un formato adecuado para BPXWDYN (consulte Solicitar asignación dinámica para obtener más información). Cuando el agente ha de crear un conjunto de datos de destino, se especifican automáticamente los siguientes atributos BPXWDYN: DSN(nombre_conjunto_datos) NEW CATALOG MSG(descriptor_archivo_numérico). Managed File Transfergenera el valor de numeric_file_descriptor . Para una transferencia de conjunto de datos a conjunto de datos, se seleccionan los atributos RECFM, LRECL y BLKSIZE del origen para un nuevo conjunto de datos de destino. El valor SPACE para un nuevo conjunto de datos de destino no lo establece Managed File Transfer y se utilizan los valores predeterminados del sistema. Por consiguiente, se recomienda especificar el atributo SPACE cuando se vaya a crear un nuevo conjunto de datos. Puede utilizar la propiedad bpxwdynAllocAdditionalProperties en el archivo agent.properties para establecer opciones BPXWDYN que se apliquen a todas las transferencias. Para obtener más información, consulte El archivo MFT agent.properties.

Algunas opciones BPXWDYN no deben especificarse cuando se utiliza el comando fteCreateTemplate , el comando fteCreateTransfer o la propiedad bpxwdynAllocAdditionalProperties en el archivo agent.properties . Para obtener una lista de estas propiedades, consulte las propiedades BPXWDYN que no debe utilizar con MFT.

El parámetro -ds no está soportado cuando el agente de destino es un agente de puente de protocolo.

Si desea invocar cualquiera de las salidas de usuario de E/S de transferencia de Managed File Transfer que ha definido para un agente, no especifique el parámetro-ds en una transferencia. El uso del parámetro -ds impide que se invoquen las salidas de usuario de E/S de transferencia para el destino y significa que en su lugar se utiliza la E/S estándar de Managed File Transfer .

- dp destination_partitioned_data_set

Solo z/OS. Opcional. El nombre PDS de destino a los que se transfieren los archivos. Especifique un nombre de conjunto de datos particionados. Si se crea un PDS como resultado de la transferencia, este PDS se crea como PDSE predeterminado. Puede alterar el valor predeterminado especificando DSNTYPE=PDS.

La sintaxis del conjunto de datos PDS es la siguiente:

//pds_data_set_name{;attribute;..;attribute}

La sintaxis del nombre del conjunto de datos es la misma que la descrita para el parámetro -ds destination_sequential_data_set . Todos los detalles de sintaxis para especificar conjuntos de datos que se encuentran en nodos Connect:Direct también se aplican al parámetro -dp . Si el agente de destino es un agente de puente Connect:Direct , también debe especificar el parámetro -de con un valor de sobrescritura.

El parámetro -dp no está soportado cuando el agente de destino es un agente de puente de protocolo.

Si desea invocar cualquiera de las salidas de usuario de E/S de transferencia de Managed File Transfer que ha definido para un agente, no especifique el parámetro-dp en una transferencia. El uso del parámetro -dp impide que se invoquen las salidas de usuario de E/S de transferencia para el destino y significa que en su lugar se utiliza la E/S estándar de Managed File Transfer .

-dq cola_destino

Opcional. El nombre de una cola de destino a la que se transfieren los archivos. De forma opcional, puede incluir un nombre de gestor de colas en esta especificación, utilizando el formato QUEUE@QUEUEMANAGER. Si no especifica un nombre de gestor de colas, se utiliza el nombre del gestor de colas de agente de destino. Debe especificar un nombre de cola válido que exista en el gestor de colas.

El parámetro -dq no está soportado cuando el agente de destino es un agente de puente de protocolo o un agente de puente Connect:Direct , o cuando la especificación de origen es una cola.

Si desea invocar cualquiera de las salidas de usuario de E/S de transferencia de Managed File Transfer que ha definido para un agente, no especifique el parámetro-dq en una transferencia. El uso del parámetro -dq impide que se invoquen las salidas de usuario de E/S de transferencia para el destino y significa que en su lugar se utiliza la E/S estándar de Managed File Transfer .

-dqp persistente

Opcional. Especifica si los mensajes escritos en la cola de destino son persistentes. Las opciones válidas son las siguientes:

true

Escribe mensajes persistentes en la cola de destino. Éste es el valor predeterminado.

falso

Escribe mensajes no persistentes en la cola de destino.

qdef

El valor de persistencia se toma del atributo DefPersistence de la cola de destino.

Sólo puede especificar el parámetro -dqp si también especifica el parámetro -dq.

-dqdb delimitador_hexadecimal

Opcional. Especifica el delimitador hexadecimal que utilizar al dividir un archivo binario en varios mensajes. Todos los mensajes tienen el mismo ID de grupo IBM MQ ; el último mensaje del grupo tiene establecido el distintivo IBM MQ LAST_MSG_IN_GROUP. El formato para especifica un byte hexadecimal como un delimitador es xNN, donde N es un carácter en el rango 0-9 o a-f. Puede especificar una secuencia de bytes hexadecimales como delimitador especificando una lista separada por comas de bytes hexadecimal, por ejemplo: x3e,x20,x20,xbf.

Sólo puede especificar el parámetro -dqdb si también especifica el parámetro -dq y la transferencia está en modalidad binaria. Puede especificar solo uno de los parámetros -qs, -dqdb y -dqdt.

-dqdt patrón

Opcional. Especifica la expresión regular Java que utilizar al dividir un archivo de texto en varios mensajes. Todos los mensajes tienen el mismo ID de grupo IBM MQ ; el último mensaje del grupo tiene establecido el distintivo IBM MQ LAST_MSG_IN_GROUP. El formato para especificar una expresión regular como delimitador es una expresión regular que está entre paréntesis, (regular_expression), o entre comillas dobles, regular_expression. Para obtener más información, consulte Expresiones regulares utilizadas por MFT.

De forma predeterminada, la longitud de la serie que la expresión regular puede encontrar está limitada por el agente de destino a cinco caracteres. Puede cambiar este comportamiento editando la propiedad de agente maxDelimiterMatchLength. Para obtener más información, consulte Propiedades avanzadas de agente.

Sólo puede especificar el parámetro -dqdt si también especifica el parámetro -dq y el valor text para el parámetro -t. Puede especificar solo uno de los parámetros -qs, -dqdb y -dqdt.

-dqdp posición

Opcional. Especifica la posición esperada de los delimitadores de texto y binario de destino al dividir archivos. Sólo puede especificar el parámetro -dqdp si también especifica uno de los parámetros -dqdt y -dqdb.

Especifique una de las opciones siguientes:

prefijo

Los delimitadores se esperan al principio de cada línea.

postfijo

Los delimitadores se esperan al final de cada línea. Ésta es la opción predeterminada.

-de comportamiento_archivo_destino

Opcional. Especifica la acción que hay que realizar si el archivo de destino existe en el sistema de destino. Las opciones válidas son las siguientes:

error

Informa de un error y el archivo no se transfiere. Éste es el valor predeterminado.

overwrite

Sobrescribe el archivo de destino existente.

Si especifica el parámetro -de, no podrá especificar el parámetro -td porque estos parámetros son mutuamente exclusivos. No obstante, puede especificar el comportamiento de que el archivo de destino existe en el archivo de definición de transferencia.

--t tipo de transferencia

Opcional. Especifica el tipo de transferencia de archivos: en modalidad binaria o modalidad de texto.

binary

Los datos en el archivo se transfieren sin conversión alguna. Éste es el valor predeterminado.

text

Se convierten la página de códigos y los caracteres de fin de línea del archivo. Puede especificar qué página de códigos y fin de línea desea utilizar para la conversión con los parámetros -sce, -dce o -dle. Si no especifica los parámetros -sce, -dce o -dle, las conversiones exactas realizadas dependen del sistema operativo del agente de origen y del agente de destino.

Por ejemplo, un archivo que se transfiere de Windows a z/OS tiene su página de códigos convertida de ASCII a EBCDIC. Cuando un archivo se convierte de ASCII a EBCDIC, los caracteres de fin de la línea se convierten de pares de caracteres de retorno de carro (CR) y salto de línea (LF) ASCII a un carácter de línea nueva (NL) EBCDIC.

Para obtener más información sobre cómo se transfieren los conjuntos de datos de z/OS , consulte Transferencia de archivos y conjuntos de datos entre z/OS y sistemas distribuidos y Transferencia entre conjuntos de datos en z/OS.

Si especifica el parámetro -t, no podrá especificar el parámetro -td porque estos parámetros son mutuamente exclusivos. No obstante, puede especificar el comportamiento de la modalidad de transferencia en el archivo de definición de transferencia.

-dce codificación_caracteres_destino

Opcional. Especifica qué codificación de caracteres utilizar para grabar el archivo en el destino. Esta opción sólo es aplicable a archivos de texto y por ello también debe especificarse -t text. Las páginas de códigos disponibles para la conversión dependen de la plataforma del agente de destino. Para obtener una lista de las páginas de códigos disponibles, consulte Páginas de códigos disponibles para MFT.

noswaplfnl

De forma predeterminada, Managed File Transfer utiliza swaplfnl con juegos de caracteres EBCDIC soportados. Al utilizar swaplfnl, cambia el comportamiento de la correlación de juego de caracteres del y al carácter EBCIDIC LF 0x25. Sin embargo, a veces esto puede producir una correlación no deseada. Utilice noswaplfnl para alterar temporalmente este comportamiento.

-dle fin_línea_destino

Opcional. Especifica los caracteres de fin de línea que se utilizan cuando el archivo se escribe en el destino. Esta opción sólo es aplicable a archivos de texto y, por lo tanto, también debe especificar el parámetro -t text . Las opciones válidas son:

LF

Salto de línea. Este es el valor predeterminado para las plataformas siguientes:

• AIX® and Linux® plataformas
• z/OS UNIX System Services archivos

Cuando se utilizan las páginas de códigos EBCDIC estándar que se proporcionan con Managed File Transfer para archivos EBCDIC, los caracteres de fin de línea se correlacionan con un carácter NL (0x15) y no con un carácter LF (0x25).

CRLF

Retorno de carro seguido por salto de línea. Este es el valor predeterminado para Windows.

Si el destino de la transferencia es un conjunto de datos de z/OS , esta opción se ignora.

-dtr

Opcional. Especifica que los registros de destino que sean mayores que el atributo de conjunto de datos LRECL se truncan. Si no se especifica este parámetro, los registros se ajustan automáticamente. Este parámetro sólo es válido para transferencias en modalidad de texto, en las que el destino sea un conjunto de datos.

-dfa atributos

Opcional. Al transferir a un agente de IBM MQ 8.0 Managed File Transfer que se ejecuta en 4690, este parámetro se utiliza para especificar una lista separada por signos de punto y coma de atributos de archivo que están asociados con los archivos de destino en la transferencia. El parámetro -dfa puede especificarse con o sin un valor. Por ejemplo, sin un valor:

-dfa ATTRIBUTE1;ATTRIBUTE2 

Por ejemplo, con un valor:

-dfa ATTRIBUTE1(VALUE);ATTRIBUTE2(VALUE)

Por ejemplo, un atributo con un valor y otro atributo sin ningún valor:

-dfa ATTRIBUTE1;ATTRIBUTE2(VALUE)

Puede utilizar el parámetro -dfa más de una vez en un mandato.

Para obtener más información sobre los atributos de archivo en 4690, consulte Atributos de distribución de archivos en la documentación de IBM MQ 8.0 .

Parámetros para la seguridad

-mquserid ID_usuario

Opcional. Especifica el ID de usuario que debe autenticarse con el gestor de colas de mandatos.

-mqpassword contraseña

Opcional. Especifica la contraseña que debe autenticarse con el gestor de colas de mandatos. También debe especificar el parámetro -mquserid. Si especifica -mquserid, pero no especifica -mqpassword, se le pedirá que proporcione la contraseña asociada. La contraseña no se mostrará.

Parámetros para especificar el origen

-sd disposición_archivo_origen

Opcional. Especifica la acción que se realiza en un archivo de origen en transferencias de archivo a archivo o de archivo a mensaje cuando dicho archivo de origen se transfiere correctamente a su destino. Las opciones válidas son las siguientes:

leave

Los archivos de origen se dejan sin cambios. Éste es el valor predeterminado.

delete

Los archivos de origen se suprimen del sistema de origen después de que se hayan transferido los archivos de origen correctamente.

Nota: Para transferencias de mensaje a archivo, los mensajes de la cola de origen siempre se suprimen una vez que se han transferido correctamente. Esto significa que si el parámetro -sd se establece en leave para una transferencia de mensaje a archivo, el valor se ignora.

En z/OS, si el origen es un conjunto de datos en cinta y se especifica la opción de eliminación, la cinta se vuelve a montar para eliminar el conjunto de datos. Este comportamiento es debido al comportamiento del entorno del sistema.

Si el origen es una cola y especifica la opción leave, el mandato devuelve un error y no se solicita una transferencia.

Si el agente de origen es un agente de puente Connect:Direct y especifica la opción delete , el comportamiento es diferente del comportamiento habitual de disposición de origen. Se da uno de los casos siguientes:

• Si Connect:Direct utiliza un proceso generado por Managed File Transfer para mover el archivo o conjunto de datos del origen, especificar la opción delete hace que la transferencia falle. Para especificar que el archivo de origen se suprime, debe someter un proceso Connect:Direct definido por el usuario. Para obtener más información, consulte Envío de un proceso Connect:Direct definido por el usuario desde una solicitud de transferencia de archivos.
• Si Connect:Direct utiliza un proceso definido por el usuario para mover el archivo o conjunto de datos del origen, este parámetro se pasa al proceso a través de la variable simbólica intrínseca %FTEFDISP. El proceso definido por el usuario determina si el origen se suprime o no. El resultado que la transferencia devuelve depende del resultado devuelto por el proceso definido por el usuario.

Si especifica el parámetro -sd, no podrá especificar el parámetro -td porque estos parámetros son mutuamente exclusivos. Sin embargo, puede especificar el comportamiento de disposición de origen en el archivo de definición de transferencia.

-r

Opcional. Transfiere archivos de forma repetitiva en subdirectorios cuando especificación_origen contiene caracteres comodín. Cuando Managed File Transfer se presenta con un carácter comodín como especificación_origen, los subdirectorios que coincidan con el carácter comodín sólo se transfieren si especifica el parámetro -r . Cuando especificación_origen coincide con un subdirectorio, se transfieren siempre todos los archivos de dicho directorio y los subdirectorios (incluidos los archivos ocultos).

Para obtener más información sobre cómo maneja Managed File Transfer los caracteres comodín, consulte Uso de caracteres comodín con MFT

Si especifica el parámetro -r, no podrá especificar el parámetro -td porque estos parámetros son mutuamente exclusivos. Sin embargo, puede especificar el comportamiento recurrente en el archivo de definición de transferencia.

-sce codificación_caracteres_origen

Opcional. Especifica qué codificación de caracteres utilizar para leer el archivo de origen al realizar la conversión de caracteres. Esta opción sólo es aplicable a archivos de texto y por ello también debe especificarse -t text. Las páginas de códigos disponibles para la conversión dependen de la plataforma del agente de destino, porque la conversión se realiza en el sistema de destino. Para obtener una lista de las páginas de códigos disponibles, consulte Páginas de códigos disponibles para MFT.

noswaplfnl

De forma predeterminada, Managed File Transfer utiliza swaplfnl con juegos de caracteres EBCDIC soportados. Al utilizar swaplfnl, cambia el comportamiento de la correlación de juego de caracteres del y al carácter EBCIDIC LF 0x25. Sin embargo, a veces esto puede producir una correlación no deseada. Utilice noswaplfnl para alterar temporalmente este comportamiento.

-skeep

Opcional. Especifica que los espacios finales se conservan en los registros de origen que se leen de un archivo de formato de longitud fija orientado a registros (por ejemplo, un conjunto de datos z/OS) como parte de una transferencia de modalidad de texto. Si no especifica este parámetro, los espacios de cola se eliminan de los registros de origen.

- delimitador srdb

Opcional. Para archivos de origen que están orientados a registros (por ejemplo, conjuntos de datos z/OS), especifica que se inserte uno o varios más valores de byte como delimitador cuando se añadan registros a un archivo binario. Debe especificar cada valor como dos dígitos hexadecimales en el rango 00-FF, con el prefijo x. Separe varios bytes con comas. Por ejemplo:

 -srdb x0A 

o

 -srdb x0D,x0A

Debe configurar la transferencia en modalidad binaria.

- posición de la SRDP

Opcional. Especifica la posición en la que insertar delimitadores de registro de origen. Sólo puede especificar el parámetro -srdp si también especifica el parámetro -srdb.

Especifique una de las opciones siguientes:

prefijo

Los delimitadores se insertan al principio de cada registro.

postfijo

Los delimitadores se insertan al final de cada registro. Ésta es la opción predeterminada.

-sq

Opcional. Especifica que el origen de una transferencia es una cola.

Si desea invocar cualquiera de las salidas de usuario de E/S de transferencia de Managed File Transfer que ha definido para un agente, no especifique el parámetro-sq en una transferencia. La utilización del parámetro -sq impide que se invoquen las salidas de usuario de E/S de transferencia para el origen y significa que en su lugar se utiliza la E/S estándar de Managed File Transfer .

-sqgi

Opcional. Especifica que los mensajes se agrupan por ID de grupo de IBM MQ . El primer grupo completo se escribe en el archivo de destino. Si no se especifica este parámetro, se escribirán todos los mensajes en la cola de origen en el archivo de destino.

Sólo puede especificar el parámetro -sqgi si también especifica el parámetro -sq.

-sqdt delimitador_texto

Opcional. Especifica una secuencia de texto que insertar como delimitador al añadir varios mensajes a un archivo de texto. Puede incluir secuencias de escape de Java para literales en el delimitador. Por ejemplo, -sqdt \u007d\n.

El delimitador de texto se codifica en formato binario utilizando la codificación de origen de la transferencia. Cada mensaje se lee en formato binario. El delimitador codificado se añade como prefijo o se añade en formato binario al mensaje (tal como especifica el parámetro -sqdp ) y el resultado se transfiere en formato binario al agente de destino. Si la página de códigos del agente de origen incluye estados de desplazamiento a teclado estándar y desplazamiento desde teclado estándar, el agente presupone que cada mensaje está en el estado de desplazamiento desde teclado estándar al final del mensaje. En el agente de destino, los datos binarios se convierten de la misma manera que una transferencia de texto de archivo a archivo.

Sólo puede especificar el parámetro -sqdt si también especifica el parámetro -sq y el valor text para el parámetro -t.

-sqdb delimitador_hexadecimal

Opcional. Especifica uno o más valores de byte que insertar como delimitador al añadir varios mensajes un archivo de binario. Cada valor debe especificarse como dos dígitos hexadecimales en el rango 00-FF, con el prefijo x. Si se especifican varios bytes, se deben separar con comas. Por ejemplo, -sqdb x08,xA4.

Sólo puede especificar el parámetro -sqdb si también especifica el parámetro -sq. No puede especificar el parámetro -sqdb si también especifica el valor text para el parámetro -t.

-sqdp posición

Opcional. Especifica la posición de inserción de los delimitadores de texto y binario de origen. Puede especificar el parámetro -sqdp sólo si también ha especificado uno de los parámetros -sqdt y -sqdb.

Especifique una de las opciones siguientes:

prefijo

Los delimitadores se insertan al principio de cada mensaje.

postfijo

Los delimitadores se insertan al final de cada mensaje. Ésta es la opción predeterminada.

-sqwt tiempo_espera

Opcional. Especifica el tiempo, en segundos, que esperar hasta que se cumpla una de las siguientes condiciones:

• Para que un nuevo mensaje aparezca en la cola
• Si se ha especificado el parámetro -sqgi, para que un grupo completo aparezca en la cola

Si no se cumple ninguna de estas condiciones en el momento especificado por tiempo_espera, el agente de origen deja de leer la cola y completa la transferencia. Si no se especifica el parámetro -sqwt, el agente de origen deja de leer la cola de origen inmediatamente si la cola de origen está vacía o si, en caso de haber especificado el parámetro -sqgi, si no existe ningún grupo completo en la cola.

Para obtener información sobre el uso del parámetro -sqwt , consulte la Guía para especificar un tiempo de espera en una transferencia de mensaje a archivo.

Sólo puede especificar el parámetro -sqwt si también especifica el parámetro -sq.

especificación_origen

Una o varias de las especificaciones de archivo que determinan el origen u orígenes de la transferencia de archivos.

Necesario si especifica uno de los parámetros -df, -dd, -dp, -dqo -ds . Si especifica el parámetro -td, no especifique especificación_origen.

• Si no ha especificado el parámetro -sq, especificación_origen es una o más especificaciones de archivos que determinan el origen u orígenes de la transferencia de archivos. Las especificaciones de archivo pueden adoptar uno de cinco formatos y pueden incluir caracteres comodín. Para obtener más información sobre los caracteres comodín, consulte Uso de caracteres comodín con MFT. Puede utilizar en la especificación de archivo dos caracteres de escape de asterisco (**) que forman parte de la especificación del archivo.

  Puede especificar varias especificaciones de archivo de origen separadas por el carácter de espacio. No obstante, si especifica varias especificaciones de origen para los parámetros -df o -ds y especifica también -de overwrite, el destino contendrá únicamente los datos del archivo de origen que ha especificado por última vez. Si no especifica -de overwrite, la transferencia sólo se puede parcialmente satisfactoria. Si el archivo de destino no existía anteriormente, contendrá los datos para el archivo de origen que ha especificado en primer lugar.

  Para transferir archivos que contienen espacios en los nombres de archivo, por ejemplo a b.txt al archivo c d.txt, escriba entre comillas dobles los nombres de archivo que contienen espacios. Especifique el siguiente texto como parte del mandato fteCreateTransfer:

  -df "c d.txt" "a b.txt"

  Cada especificación de archivo debe tener una de las categorías siguientes:

  Nombres de archivo

  El nombre de un archivo, expresado en la notación apropiada para el sistema donde se está ejecutando el agente de origen. Cuando se especifica un nombre de archivo como especificación de archivo de origen, se copia el contenido del archivo.

  Directorios

  El nombre de un directorio, expresado en la notación apropiada para el sistema donde se está ejecutando el agente de origen. Cuando se especifica un directorio como especificación de archivo de origen, se copia el contenido del directorio. Más concretamente, se copian todos los archivos del directorio y de todos sus subdirectorios, incluidos los archivos ocultos.

  Por ejemplo, para copiar el contenido de DIR1 sólo en DIR2 , especifique fteCreateTransfer ... -dd DIR2 DIR1/*

  Conjunto de datos secuencial

  El nombre de un conjunto de datos secuenciales o miembro de conjunto de datos particionados. Indique los conjuntos de datos anteponiendo al nombre del conjunto de datos dos caracteres de barra inclinada (//).

  Si especifica un agente de puente de protocolo como agente de origen, no podrá especificar un conjunto de datos como especificación de archivo de origen.

  Conjunto de datos particionado

  El nombre de un conjunto de datos particionados. Indique los nombres de conjunto de datos anteponiendo al nombre del conjunto de datos dos caracteres de barra inclinada (//).

  Si especifica un agente de puente de protocolo como agente de origen, no podrá especificar un conjunto de datos como especificación de archivo de origen.

  Nombre de archivo o directorio en un nodo Connect:Direct

  (Sólo agente de puenteConnect:Direct ). El nombre de un nodo Connect:Direct , un carácter de dos puntos (:) y una vía de acceso de archivo o directorio en el sistema que aloja el nodo Connect:Direct . Por ejemplo, connect_direct_node_name:file_path.

  Si el agente de origen es un agente de puente Connect:Direct , sólo aceptará especificaciones de origen en este formato.

  Nota: Los caracteres comodín no están soportados en las vías de acceso de archivo cuando el agente de origen es un agente de puente Connect:Direct .

  Nombre de archivo o directorio en un servidor de archivos de protocolo

  El nombre de un servidor de archivos de protocolo, un carácter de dos puntos (:) y una vía de acceso a archivo o directorio en el sistema de servidor de protocolo. Por ejemplo, protocol_server:file_path.

  Si no especifica un servidor de protocolo, se utiliza el servidor de protocolo predeterminado.

• Si especifica el parámetro -sq, especificación_origen es el nombre de una cola local en el gestor de colas del agente de origen. Puede especificar sólo una cola de origen. La cola de origen se especifica con el siguiente formato:

  QUEUE_NAME

  El nombre del gestor de colas no se incluye en la especificación de la cola de origen porque el gestor de colas debe ser el mismo que el gestor de colas del agente de origen.
• Si el agente de origen está en z/OS, se asume que los archivos de origen que empiezan por // son conjuntos de datos particionados z/OS .

Otros parámetros

-? o -h

Opcional. Muestra la sintaxis del mandato.

Códigos de retorno