fteCreateTransfer（开始新的文件传输）

用途

有关如何传输文件的指导信息，请参阅 传输文件的准则。 对于 z/OS 平台，您可以传输文本文件，数据集和生成数据组 (GDG)。

您可以从可以连接到 IBM® MQ 网络的任何系统运行 fteCreateTransfer 命令，然后路由到源代理队列管理器。 具体而言，要运行该命令，必须在此系统上安装 Managed File Transfer 组件 (服务或代理程序) ，并在此系统上配置 Managed File Transfer 组件以与 IBM MQ 网络进行通信。

此命令使用名为 command.properties 的属性文件来连接到 IBM MQ 网络。 如果 command.properties 文件不包含属性信息，将对本地系统上的缺省队列管理器进行绑定方式连接。 如果 command.properties 文件不存在，将生成错误。 有关更多信息，请参阅 MFT command.properties 文件。

您可以针对一个文件传输指定多个源文件，但它们必须源自一个源代理，并终止于一个目标代理。 不支持在单个传输中将一个源文件传输到相同代理或多个不同代理上的多个目标文件。 Ant 脚本编制可用于将同一源文件发送到一个或多个代理程序上的多个目标。 有关更多信息，请参阅 将 Apache Ant 与 MFT配合使用。

特殊字符

使用包含特殊字符的参数时，请谨慎操作，以免命令 shell 错误地解释这些字符。 例如，命令 shell 可能会解释包含单引号的标准数据集名称和包含星号字符的源规范，而不是在传输请求中传递。 为避免命令 shell 对字符进行解释，请使用双引号括起整个参数，或使用命令 shell 的转义序列对特殊字符进行转义。

相对路径

transferRoot=directory_name

例如，将 C:\TransferRoot 指定为 C:\\TransferRoot 或 C:/TransferRoot。

在 z/OS上，缺省情况下，将代理程序运行所使用的用户名作为高级限定符前缀添加到尚未完全限定的数据集规范。 例如：//ABC.DEF。 要更改作为前缀添加到数据集名称的值，请在 agent.properties 文件中设置 transferRootHLQ 属性。 该文件位于 MQ_DATA_PATH/mqft/config/coordination_qmgr/agents/agent_name 目录。 将以下行添加到该文件：

transferRootHLQ=prepend_value

但是，对于涉及 z/OS 系统上的 Connect:Direct® 节点的传输，数据集规范将解释为标准名称。 不会向数据集名称添加任何高级限定符。

代理规范的参数

-sa 源代理名称

必需。 从中传输源文件的代理程序的名称。

如果指定协议网桥代理作为源代理，那么您之后无法指定数据集作为源文件规范。

如果您指定 -td 参数并且传输定义文件（文件中包含要用于传输的源代理），那么请勿指定 -sa 参数。

-sm source_agent_qmgr_name

可选。 源代理连接到的队列管理器的名称。

如果未指定 -sm 参数，那么要使用的队列管理器将由使用的配置选项集确定（基于源代理名称）。 如果无法找到源代理程序的 agent.properties 文件，那么文件传输将失败。

-da 目标代理名称

必需。 要将文件传输到的代理程序的名称。

如果您指定 -td 参数并且传输定义文件（文件中包含要用于传输的目标代理），那么请勿指定 -da 参数。

-dm 目的地代理 QMgr_name

可选。 目标代理连接到的队列管理器的名称。

如果未指定 -dm 参数，那么要使用的队列管理器将由使用的配置选项集确定（基于目标代理名称）。 如果无法找到目标代理的 agent.properties 文件，那么文件传输将失败。

生成传输模板的参数

-gt transfer_template_file_path

可选。 生成传输模板 XML 消息并将该消息写入文件。 如果指定此参数，那么不会向 Managed File Transfer发送传输请求。 而是将传输请求消息的内容写入指定的 XML 文档。 然后，您可以使用此 XML 文档来定义用于资源监视的任务。 有关如何创建资源监控器的信息，请参阅fteCreateMonitor命令。 如果未指定该参数，那么缺省行为将发生并且将执行实际传输请求。

必须提供 XML 输出文件的完整路径和名称作为该参数的输入，例如，C:\templates\transfer_reports.xml

在 z/OS上，必须将传输模板文档存储在 z/OS UNIX System Services上的 UNIX 文件中。 您无法在 z/OS 顺序文件或 PDS 成员中存储传输模板文档。

在 IBM i上，必须将传输模板文档存储在集成文件系统中。

使用 -gt 参数创建的传输模板 XML 消息不同于使用 fteCreateTemplate 命令创建的传输，这意味着您无法交互使用两种不同类型的模板。

注: 如果要通过运行带有 -gt 参数的 fteCreateTransfer 命令来生成传输模板 XML 文档，然后使用 -td 参数提供该传输模板 XML 文档作为 fteCreateTransfer 命令的输入，那么必须确保生成了传输模板 XML 文档，并指定了与 -td 选项互斥的参数。

与 -td 选项互斥的参数包括:

• -dd 目标目录
• 源路径
• -df 目标文件
• -cs 校验和
• -de 目标文件行为
• -dq 目标队列
• -t 传输类型
• -sd source_file_处置

例如，无法在 fteCreateTransfer 命令上同时指定 -td 和 -t 参数 (指示传输是二进制传输还是文本传输)。 这意味着，如果要将传输模板 XML 文档传递到命令并指定该传输应该是文本传输，那么应通过指定 -gt 和 -t 文本参数来创建 XML 文档。

此参数在 REST API中不受支持。

调度传输的参数

-ss 计划开始时间

可选。 指定您希望调度的传输开始执行的时间和日期。 请使用以下某种格式来指定时间和日期。 使用 24 小时时钟指定时间：

yyyy-MM-ddThh:mm

hh:mm

如果不存在可能影响传输的问题，那么调度的文件传输将在调度开始时间后一分钟内开始。 例如，您的网络或代理可能存在阻止调度传输开始的问题。

-tb

可选。 指定想要用于已安排的文件传输的时基。 即，想要使用系统时间还是全球标准时间 (UTC)。 该参数只能与 -ss 参数一起使用。 指定以下某个选项：

admin

预定接送服务的开始和结束时间以发起接送服务的系统的时间和日期为准。 例如，这可能是通过 fteCreateTransfer 命令或 IBM MQ Explorer 启动传输的机器的时间和日期。

注意：当使用 REST API 发起转移时， 管理选项将映射到运行 IBM MQ Web Server 的机器的时间和日期。

源

用于调度的传输的开始时间和结束时间基于源代理所在系统的日期和时间。

UTC

用于调度的传输的开始时间和结束时间基于全球标准时间 (UTC)。

-oi

可选。 指定调度的传输出现的时间间隔。 该参数只能与 -ss 参数一起使用。 指定以下某个选项：

分钟

小时

days

weeks

months

years

-的发生频率

可选。 指定调度的传输出现的频率。 例如，每 5 周或每 2 个月。 该参数只能与 -oi 和 -ss 参数一起指定。 如果未指定该参数，那么将使用缺省值 1。

-oc 实例计数

可选。 指定您希望此调度的传输发生的次数。 达到发生计数之后，将删除调度的传输。

该参数只能与 -oi 和 -ss 参数一起指定。

如果指定 -oc 参数，那么不能指定 -es 参数，因为这些参数是互斥的。

您可以同时省略 -oc 和 -es 参数以创建无限重复的传输。

-es 计划结束时间

可选。 重复的调度传输结束的日期和时间。

该参数只能与 -oi 和 -ss 参数一起指定。

如果指定 -es 参数，那么不能指定 -oc 参数，因为这些参数是互斥的。

您可以同时省略 -es 和 -oc 参数以创建无限重复的传输。

使用以下某种格式来指定结束时间和日期。 使用 24 小时时钟指定时间：

yyyy-MM-ddThh:mm

hh:mm

触发传输的参数

-tr

可选。 指定为执行此文件传输所必须满足的条件。 如果不满足该条件，那么根据源代理，将废弃该文件传输，不会执行任何传输。 指定以下格式：

condition,namelist

其中条件是以下某个值：

file=exist

名称列表中至少有一个文件存在。 即，如果存在名称列表中的任何文件，那么就满足条件。

file!=exist

名称列表中至少有一个文件不存在。 即，如果名称列表中有任何文件不存在，那么满足条件。

filesize> =大小

至少存在名称列表中的一个文件，并且最小大小为 size 指定的大小。 size 是一个整数，可选大小单位为 KB、MB 或 GB。 例如，filesize">"=10KB。 如果未指定大小单位，大小将假定以字节为单位。 在所有操作系统上，您在命令行上指定 filesize 选项时必须将大于号 (>) 括在双引号内，如该示例中所示。

并且，其中 namelist 是源代理所在系统上的以逗号分隔的文件名列表。 根据操作系统，如果您要在名称列表中使用包含空格的路径名或文件名，可能必须将路径名和文件名括在双引号中。

您可以多次使用 -tr 参数来指定多个触发条件。 然而，在此情况下，必须满足每个单独的触发条件才能进行文件传输。

注: 要持续监视资源以使触发条件为 true ，强烈建议您使用 资源监视。 您可以使用 fteCreateMonitor 命令。

在以下示例中，文件 file1.doc 将从 AGENT1 传输到 AGENT2，条件是文件 A.txt 和/或文件 B.txt 位于 AGENT1 上，而且文件 A.txt 和/或文件 B.txt 不小于 1GB：

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 

您可以将触发参数与调度参数相结合。 如果同时指定这两种类型的参数，那么触发条件将应用于调度参数创建的文件传输。

-tr 参数在协议网桥代理或 CreateTransfer REST API中不受支持。

-tl

可选。 指定是否将触发器失败写入传输日志。 指定以下某个选项：

yes

针对失败的已触发传输创建传输日志条目。 这是缺省行为，即使未指定 -tl 参数。

False

不针对失败的已触发传输创建任何传输日志条目。

指定传输选项的参数

-jn 作业名

可选。 启动传输时添加到传输日志消息的用户定义的作业名称标识。

-md

可选。 指定将传递给代理程序运行的出口点的用户定义的元数据。 -md 参数可以采用以逗号分隔的一个或多个名称/值对。 每个名称对由 name=value 组成。 您可以在一个命令中多次使用 -md 参数。

当代理属性 enableUserMetadataOptions 设置为值 true时，某些用户定义的元数据键会为传输提供更多选项。 有关当前支持的用户定义元数据键的更多信息，请参阅 "enableUserMetadataOptions:支持 "MFT用户自定义元数据键。 当 enableUserMetadataOptions 属性设置为 true时，用户定义的使用不支持以 com.ibm.wmqfte. 开头的密钥名称。

fteCreateTransfer 命令上提供的任何用户元数据都可作为环境变量提供给通过 presrc， postsrc， predst和 postdst 参数调用的进程。

例如，以下传输会导致将名为 procname 的环境变量设置为 compress (procname=compress) 并可用于 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 校验和

可选。 指定是否针对文件传输数据运行校验和算法，以检查所传输文件的完整性。 指定以下某个选项：

MD5

计算数据的 MD5 校验和。 针对源和目标文件生成的校验和将写入传输日志以供验证之用。 缺省情况下， Managed File Transfer 计算所有文件传输的 MD5 校验和。

none

不会为文件传输数据计算 MD5 校验和。 传输日志记录校验和设置为 none，并且校验和值为空。 例如：

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

如果使用 none 选项，那么可能会提高文件传输性能，这取决于环境。 然而，选择该选项意味着不会验证源或目标文件。

如果指定 -cs 参数，那么不能指定 -td 参数，因为这些参数是互斥的。 但是，您可以在传输定义文件中指定校验和行为。

-pr transfer_priority

可选。 指定传输的优先级。 优先级为 0-9 之间的一个值，其中 0 为最低优先级。 缺省优先级是源代理的优先级。

此值与 IBM MQ的消息优先级值匹配，请参阅 从队列获取消息: 优先级 以获取更多信息。 文件传输数据的消息流量缺省为优先级级别 0 ，这允许您的 IBM MQ 消息流量具有优先级。

-qmp 布尔值

可选。 指定传输写入目标队列的第一条消息是否设置了 IBM MQ 消息属性。 有效选项如下：

true

在传输创建的第一条消息上设置消息属性。

false

不会在传输创建的第一条消息上设置消息属性。 这是缺省值。

只有在指定了 -dq 参数的情况下才可以指定 -qmp 参数。 如需了解更多信息，请参阅 MFT在写入目标队列的邮件上设置的 MQ 邮件属性

-qs 消息大小

可选。 指定是否将文件分割为多条固定长度的消息。 所有消息都具有相同的 IBM MQ 组标识; 该组中的最后一条消息设置了 IBM MQ LAST_MSG_IN_GROUP 标志。 消息的大小由 message_size 的值指定。 message_size 的格式是 长度单位，其中长度是正整数值，而单位是以下某个值：

B

字节。 允许的最小值为目标消息的代码页的最大“每个字符的字节数”值的两倍。

K

等于 1024 字节。

M

这等于 1048576 字节。

如果文件以文本方式传输，并且采用双字节字符集或者多字节字符集，那么该文件会拆分为字符边界最接近指定消息大小的消息。

只有在指定了 -dq 参数的情况下才可以指定 -qs 参数。 您只能指定 -qs、-dqdb 和 -dqdt 参数之一。

-qi

可选。 使用此选项包括用于将文件拆分为消息中的多条消息的定界符。 定界符包含在消息头或尾部，取决于 -dqdp 参数（指定前缀或后缀）。 缺省情况下，消息中不包含定界符。

只有在指定了 -dqdt 和 -dqdb 参数之一时，才可以指定 -qi 参数。

--p 配置选项

可选。 该参数确定用于创建文件传输的一组配置选项。 使用非缺省协调队列管理器的名称作为该参数的输入。 然后，命令使用与此非缺省协调队列管理器相关联的属性文件集。

如果您未指定该参数，那么会使用基于缺省协调队列管理器的配置选项集。

此参数在 REST API 接口中不受支持。

--w 超时

可选。 指定 -w 参数将导致 fteCreateTransfer 命令在返回前等待代理的响应。 如果不指定此参数，那么 fteCreateTransfer 命令最多等待 5 秒钟，以接收源代理针对传输所发送的关于已接收到传输请求的确认。 如果在等待的 5 秒时间内未收到确认，fteCreateTransfer 命令会返回以下警告消息：

BFGCL0253W: No acknowledgment to command from agent within timeout.

除非在命令行上使用了 -w 选项，否则返回码将为 0。

timeout 参数为可选。 如果指定 timeout，那么 fteCreateTransfer 命令等待最多 timeout 秒，以便代理响应。 如果在达到时间限制之前代理程序未响应，那么该命令将生成警告并以返回码 2 或 3结束。 如果未指定超时值，或指定的超时值为-1，则命令等待代理回应。

REST 服务没有为此参数提供等效选项，因为在 REST 服务实现中不建议使用理想的等待时间。

-rt 恢复超时

可选。 设置时间量（以秒为单位），在此期间，源代理会一直尝试恢复停止的文件传输。 指定以下某个选项：

-1

代理继续尝试恢复停止的传输，直至传输完成。 使用此选项相当于未设置属性时代理的缺省行为。

0

一旦进入恢复，代理将停止文件传输。

>0

在由指定正整数值设置的时间量（以秒为单位）内，代理继续尝试恢复停止的传输。 例如

-rt 21600

表示代理会在进入恢复后六小时内一直尝试恢复传输。 此参数的最大值为 999999999。

通过这种方式指定传输恢复超时值是在每个传输的基础上进行设置。 要为 Managed File Transfer 网络中的所有传输设置全局值，可以向 agent.properties 文件添加属性。

调用程序的参数

有关如何从 Managed File Transfer启动程序的更多信息，请参阅 指定要使用 MFT运行的程序。 有关使用此处描述的参数指定要调用的程序的示例，请参阅使用fteCreateTransfer启动程序的示例。

-presrc pre_source_call

可选。 指定在传输启动前要在源代理程序调用的程序。 请将以下格式用于 pre_source_call：

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

在此语法中，变量为：

类型

可选。 有效值为 executable、antscript 和 jcl。 缺省值为 executable。

jcl 值仅适用于在 环境中定位到代理的情况。 z/OS 在此情况下，该命令引用 ZFS 文件、QSAM 可读数据集或 PDS 成员。 内容应为可提交的 JCL。

commandspec

必需。 命令规范。 请使用以下格式之一：

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

  如果自变量包含变量替换 (例如 ${FilePath} 或 ${FileName}) ，这些替换仅在资源监视器启动替换时有效，那么这些变量将替换为传输请求中的第一项。

  例如，如果传输请求由文件 "reports01.csv， reports02.csv， reports03.csv" 组成，并且目标目录为 "/output" ，那么以下传输请求:

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

  替换为

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

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

其中：

命令

必需。 要调用的程序的名称。

仅当针对 z/OS 环境中的代理程序时， jcl 值才适用。

方括号 ([ ]) 中的参数是可选的，并且语法取决于命令类型。 括号，逗号 (，) 和反斜杠 (\) 是 MFT 命令中的特殊字符，必须使用反斜杠 (\) 字符进行转义。 在Windows系统中，文件路径可以用两个反斜杠（“/”）作为分隔符，也可以用单个正斜杠（“/”）作为分隔符。

retrycount

可选。 在程序未返回成功返回码时重试调用程序的次数。 缺省值为 0。

retrywait

可选。 重新尝试调用程序之前，要等待的秒数。 缺省值为 0（重试之间无等待）。

successrc

可选。 用于确定程序调用何时成功运行的表达式。 该表达式可由一个或多个表达式组成。 组合这些表达式，其中用竖线字符 (|) 表示布尔值 OR，或者用和符号 (&) 表示布尔值 AND。 每个表达式都采用以下格式：

[>|<|!]value

其中：

>

可选。 value 的大于测试。

<

可选。 value 的小于测试。

!

可选。 value的检验不相等。

值

必需。 有效整数。

如果未指定此参数，那么将使用缺省值 0 。

- pre_destination_call

可选。 指定在传输启动前要在目标代理程序调用的程序。 pre_destination_call 具有与 pre_source_call 相同的格式。

-postsrc post_source_call

可选。 指定在传输完成后要在源代理调用的程序。 post_source_call 具有与 pre_source_call 相同的格式。

-postdst post_destination_call

可选。 指定在传输完成后要在目标代理调用的程序。 post_destination_call 具有与 pre_source_call 相同的格式。

指定目标的参数

必须指定 -td、-df、-dd、-ds、-dq 和 -dp 参数之一。 您无法在一个传输请求中指定其中多个参数；这些参数互斥。

-td 转送定义文件

可选。 XML 文档的名称，该文档定义传输的一个或多个源和目标文件规范。 或者，包含受管传输请求的 XML 文档的名称（可能已由 -gt 参数生成）。 如果指定 -td 参数并同时在命令行上指定任何其他参数，那么这些其他参数将覆盖来自于传输定义文件中的相应值。

fteCreateTransfer 命令查找与您的当前目录相关的传输定义文件。 如果无法使用相对路径注释来指定传输定义文件的位置，请使用传输定义文件的标准路径和文件名代替。

在 z/OS 上，您必须将传输定义文件存储在 UNIX 文件中的 z/OS UNIX System Services 上。 您无法在 z/OS 顺序文件或 PDS 成员中存储传输定义文件。

在 IBM i 上，您必须将传输定义文件存储在集成的文件系统中。

有关更多信息，请参阅 使用传输定义文件。

-df 目标文件

可选。 目标文件的名称。

如果目标代理是 Connect:Direct 网桥代理，那么将以 connect_direct_node_name:file_path格式指定目标文件。 Connect:Direct 网桥代理仅接受以此格式指定的文件路径。 如果目的地代理是 Connect:Direct 桥接代理，且目的地是PDS成员，则您还必须指定 -de 参数，并指定覆盖值。

请注意以下信息：

• 如果目标代理是协议网桥代理，并且您想要为文件指定端点，那么请使用以下格式：

  protocol_server:file_path

  其中，protocol_server 是协议服务器（可选）的名称，file_path 是到协议服务器系统上的文件的路径。 如果未指定协议服务器，那么将使用缺省协议服务器。
• 如果要调用针对目标代理定义的任何 Managed File Transfer 传输 I/O 用户出口，可以在传输中使用 -df 参数。
• 当目标代理为 z/OS 时，如果指定的文件以 // 开头，则假定它是分区的 z/OS 数据集。

-dd 目标目录

可选。 要将文件传输到的目录的名称。 在运行目标代理程序的系统上指定一个有效目录名称。

如果目标代理是 Connect:Direct 网桥代理，那么将以 connect_direct_node_name:directory_path格式指定目标目录。 如果目标代理是 Connect:Direct 网桥代理，而目标是 PDS ，那么还必须使用覆盖值指定 -de 参数。

请注意以下信息：

• 如果目标代理是协议网桥代理，并且您想要在特定端点指定一个目录，请使用以下格式：

  protocol_server:directory_path

  其中，protocol_serve 是协议服务器（可选）的名称，而 directory_path 是到协议服务器系统上的目录的路径。 如果未指定协议服务器，那么将使用缺省协议服务器。

• 如果要调用针对目标代理定义的任何 Managed File Transfer 传输 I/O 用户出口，可以在传输中使用 -dd 参数。

• 当目标代理为 z/OS 时，如果指定的文件以 // 开头，则假定它是 z/OS 分区数据集。

- ds destination_sequential_data_set

仅适用于 z/OS。 可选。 要将文件传输到的顺序数据集或 PDS 成员的名称。 指定连续数据集名称或分区数据集成员。 有关数据集传输的信息，请参阅文件传输指南。

数据集名称的语法如下所示：

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

或

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

即，数据集名称说明符，以 // 为前缀，并（可选）后跟以分号分隔的若干属性。

例如：

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

如果数据集位于 Connect:Direct 节点上，那么必须以节点名作为数据集名称的前缀。 例如：

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

如果目标代理是 Connect:Direct 网桥代理，并且目标是 PDS 成员，那么还必须使用覆盖值指定 -de 参数。 有关数据集传输到或从 Connect:Direct 节点，参见 在 Connect:Direct 节点之间传输数据集。

对于仅涉及 Managed File Transfer 代理程序的传输，如果数据集名称部分由单引号字符括起，那么它将指定标准数据集名称。 如果未使用单引号字符将数据集名称引起来，那么系统针对目标代理程序添加缺省高级限定符（如果未设置 transferRootHLQ，那么这是 transferRootHLQ 代理程序属性的值或运行代理程序的用户标识）。

备注： 然而，对于涉及 Connect:Direct 系统上 z/OS 节点的传输，数据集规范被解释为完全限定名称。 不会向数据集名称添加任何高级限定符。 即使数据集名称由单引号字符括起，也是如此。

将文件或数据集传输到磁带时，磁带上的任何现有数据集都将被替换。 新数据集的属性将根据传输定义中传递的属性进行设置。 如果未指定 任何属性，那么新数据集的属性将设置为与源数据集相同，或者，如果 源数据集是文件，那么这些属性将设置为缺省值。 将忽略现有磁带数据集的属性。

数据集属性用于创建数据集或者确保现有数据集兼容。 数据集属性的规格以适合BPXWDYN的格式呈现（更多信息，请参阅 “请求动态分配” ）。 在代理将创建目标数据集时，将自动指定以下 BPXWDYN 属性：DSN(data_set_name) NEW CATALOG MSG(numeric_file_descriptor)。 numeric_file_descriptor 的值由 Managed File Transfer生成。 对于数据集之间的传输，将为新目标数据集选择来自源的属性：RECFM、LRECL 和 BLKSIZE。 Managed File Transfer 未设置新目标数据集的 SPACE 设置，将使用系统缺省值。 因此，建议您在将要创建新数据集时指定 SPACE 属性。 您可以使用 agent.properties 文件中的 bpxwdynAllocAdditionalProperties 属性来设置适用于所有传输的 BPXWDYN 选项。 有关更多信息，请参阅 MFT agent.properties 文件。

agent.properties 使用 fteCreateTemplate 命令、 fteCreateTransfer 命令或 bpxwdynAllocAdditionalProperties 属性时，不得指定某些BPXWDYN选项。 这些属性的列表，请参阅 BPXWDYN 属性，这些属性不能与 MFT 一起使用。

当目标代理为协议网桥代理时，不支持 -ds 参数。

如果要调用针对代理定义的任何 Managed File Transfer 传输 I/O 用户出口，请不要在传输中指定-ds 参数。 使用 -ds 参数可防止针对目标调用传输 I/O 用户出口，并表示改为使用标准 Managed File Transfer I/O。

- dp 目的地分区数据集

仅适用于 z/OS。 可选。 要将文件传输到的目标 PDS 的名称。 指定分区数据集名称。 如果创建 PDS 作为传输的结果，那么缺省情况下将创建该 PDS 作为 PDSE。 您可以通过指定 DSNTYPE=PDS 来覆盖缺省值。

PDS 数据集名称的语法如下所示：

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

数据集名称的语法与 -ds destination_sequential_data_set 参数描述的语法相同。 用于指定位于 Connect:Direct 节点上的数据集的所有语法详细信息也适用于 -dp 参数。 如果目标代理是 Connect:Direct 网桥代理，那么还必须指定值为 overwrite 的 -de 参数。

当目标代理为协议网桥代理时，不支持 -dp 参数。

如果要调用针对代理定义的任何 Managed File Transfer 传输 I/O 用户出口，请不要在传输中指定-dp 参数。 使用 -dp 参数可防止针对目标调用传输 I/O 用户出口，并表示改为使用标准 Managed File Transfer I/O。

-dq 目标队列

可选。 要将文件传输到的目标队列的名称。 您可以选择使用格式 QUEUE@QUEUEMANAGER 在此规范中包含一个队列管理器名称。 如果未指定队列管理器名称，那么将使用目标代理队列管理器名称。 必须指定队列管理器上已存在的有效队列名称。

当目标代理是协议网桥代理或 Connect:Direct 网桥代理时，或者当源规范是队列时，不支持 -dq 参数。

如果要调用针对代理定义的任何 Managed File Transfer 传输 I/O 用户出口，请不要在传输中指定-dq 参数。 使用 -dq 参数可防止针对目标调用传输 I/O 用户出口，并表示改为使用标准 Managed File Transfer I/O。

-dqp 持久

可选。 指定写入目标队列的消息是否持久。 有效选项如下：

true

将持久消息写入目标队列。 这是缺省值。

false

将非持久性消息写入目标队列。

qdef

持久性值将从目标队列的 DefPersistence 属性获取。

只有在指定了 -dq 参数的情况下才可以指定 -dqp 参数。

-dqdb 十六进制定界符

可选。 指定将二进制文件分割为多条消息时使用十六进制定界符。 所有消息都具有相同的 IBM MQ 组标识; 该组中的最后一条消息设置了 IBM MQ LAST_MSG_IN_GROUP 标志。 指定十六进制字节作为定界符的格式为 xNN，其中，N 是 0-9 或 a-f 范围内的一个字符。 您可以通过指定十六进制字节的逗号分隔列表（例如：x3e,x20,x20,xbf），将一系列十六进制字节指定为定界符。

只有在指定了 -dq 参数并且传输处于二进制方式时，才可以指定 -dqdb 参数。 您只能指定 -qs、-dqdb 和 -dqdt 参数之一。

-dqdt 模式

可选。 指定将文本文件分割为多条消息时使用 Java 正则表达式。 所有消息都具有相同的 IBM MQ 组标识; 该组中的最后一条消息设置了 IBM MQ LAST_MSG_IN_GROUP 标志。 指定正则表达式作为定界符的格式为以括号括起的正则表达式 (regular_expression)，或者以双引号括起的正则表达式 regular_expression。 更多信息，请参阅 MFT使用的正则表达式。

缺省情况下，目标代理将正则表达式可匹配的字符串的长度限制为 5 个字符。 您可以通过编辑 maxDelimiterMatchLength 代理属性来更改此行为。 有关更多信息，请参阅 高级代理程序属性。

只有在指定了 -dq 参数以及 -t 参数的 text 值时，您才可以指定 -dqdt 参数。 您只能指定 -qs、-dqdb 和 -dqdt 参数之一。

-dqdp 位置

可选。 指定在分割文件时目标文本和二进制定界符的预期位置。 只有在指定了 -dqdt 和 -dqdb 参数之一时，才可以指定 -dqdp 参数。

指定以下某个选项：

前缀

定界符原应位于每行的开头。

postfix

预期定界符在每行的末尾。 这是缺省选项。

-de 目的地文件行为

可选。 指定在目标系统上已存在目标文件时执行的操作。 有效选项如下：

错误

报告错误并且不传输文件。 这是缺省值。

overwrite

覆盖现有目标文件。

如果指定 -de 参数，那么不能指定 -td 参数，因为这些参数是互斥的。 然而，您可以在传输定义文件中指定目标文件存在行为。

--t 转接类型

可选。 指定文件传输的类型：二进制方式或文本方式。

二进制

文件中的数据将在不经任何转换的情况下进行传输。 这是缺省值。

文本

将转换文件的代码页和行尾字符。 您可以使用 -sce、-dce 或 -dle 参数指定用于转换的代码页和行尾。 如果未指定 -sce、-dce 或 -dle 参数，那么执行的精确转换取决于源代理程序和目标代理程序的操作系统。

例如，从 Windows 传输到 z/OS 的文件，其代码页从ASCII转换为EBCDIC。 在文件从 ASCII 转换为 EBCDIC 时，行尾字符将从 ASCII 回车符 (CR) 和换行 (LF) 字符对转换为 EBCDIC 换行 (NL) 字符。

有关 z/OS 数据集传输的更多信息，请参阅 《在 z/OS 和分布式系统之间传输文件和数据集 》和 《在 z/OS 上的数据集之间进行传输 》。

如果指定 -t 参数，那么不能指定 -td 参数，因为这些参数是互斥的。 然而，您可以在传输定义文件中指定传输方式行为。

-dce 目的地字符编码

可选。 指定用于在目标写入文件的字符编码。 该选项仅适用于文本文件，而且还必须指定 -t text。 适用于转换的代码页取决于目标代理程序的平台。 有关可用代码页的列表，请参阅 MFT 的可用代码页。

noswaplfnl

缺省情况下， Managed File Transfer 将 swaplfnl 与受支持的 EBCDIC 字符集配合使用。 使用 swaplfnl 可更改与 EBCIDIC LF 0x25 字符之间的字符集映射的行为。 但是，该操作有时候会产生不需要的映射。 使用 noswaplfnl 覆盖此行为。

-dle 目的地行结束

可选。 指定在目标编写文件时使用的行尾字符。 该选项仅适用于文本文件，因此还必须指定 -t text 参数。 有效选项为：

LF

换行。 它是下列平台的缺省值：

• AIX® and Linux® 平台
• z/OS UNIX System Services 文件

当您将 Managed File Transfer 随附的标准 EBCDIC 代码页用于 EBCDIC 文件时，行尾字符将映射到 NL 字符 (0x15) 而不是 LF 字符 (0x25)。

CRLF

后跟换行的回车符。 这是 Windows 的默认设置。

如果传输的目标是 z/OS 数据集，则忽略此选项。

-dtr

可选。 指定将截断长于 LRECL 数据集属性的目标记录。 如果未指定该参数，那么将合并记录。 该参数仅对目标是数据集的文本方式传输有效。

-dfa 属性

可选。 当传输到在 4690 上运行的 IBM MQ 8.0 Managed File Transfer 代理时，此参数用于指定与传输中的目标文件相关联的文件属性的分号分隔列表。 可以指定具有或没有值的 -dfa 参数。 例如，没有值：

-dfa ATTRIBUTE1;ATTRIBUTE2 

例如，具有值：

-dfa ATTRIBUTE1(VALUE);ATTRIBUTE2(VALUE)

例如，一个属性有值，而另一个没有值：

-dfa ATTRIBUTE1;ATTRIBUTE2(VALUE)

您可以在一条命令中多次使用 -dfa 参数。

有关 4690 上的文件属性的更多信息，请参阅 IBM MQ 8.0 文档中的 文件分发属性 。

安全性的参数

-mquserid 用户标识

可选。 指定要向命令队列管理器进行认证的用户标识。

-mqpassword 密码

可选。 指定通过协调队列管理器进行认证时所使用的密码。

指定 -mqpassword 参数时，还必须指定 -mquserid 参数。 如果指定 -mquserid，但未指定 -mqpassword，那么系统将提示您提供相关联的密码，不会显示此密码。

从 IBM MQ 9.3 开始，命令默认使用 MQCSP 身份验证，并将用户ID和密码以MQCSP结构发送给队列管理器进行身份验证。

-nolpw

可选。 如果命令连接到不支持长度超过 12 个字符的密码的队列管理器，请指定此参数。

指定 -nolpw 参数时，还必须指定 -mquserid 参数。 如果指定了 -mquserid 和 -nolpw，但未指定 -mqpassword，那么系统会提示您提供关联的密码，此密码将不会显示。

注: 如果指定 -nolpw 选项，并且密码长度超过 12 个字符，那么命令将失败并返回错误消息 BFGCL0829E。

指定源的参数

-sd source_file_处置

可选。 指定当源文件成功传输到其目标时，在文件到文件或文件到消息传输中对源文件执行的操作。 有效选项如下：

leave

源文件将保持不变。 这是缺省值。

delete

源文件传输成功后将从源系统中删除。

注: 对于 "消息到文件" 传输，源队列上的消息一旦成功传输，将始终被删除。 这意味着如果针对消息到文件传输将 -sd 参数设置为 leave ，那么将忽略该值。

在 z/OS 上，如果源文件是磁带数据集，并且您指定了删除选项 ，则磁带将被重新加载以删除数据集。 该行为是由于系统环境的行为。

如果源是队列，并且指定 leave 选项，那么命令返回一个错误且不请求传输。

如果源代理是 Connect:Direct 网桥代理，并且您指定了 delete 选项，那么行为与通常的源处置行为不同。 将出现以下某种情况：

• 如果 Connect:Direct 使用 Managed File Transfer 生成的进程从源中移动文件或数据集，那么指定 delete 选项会导致传输失败。 要指定删除源文件，必须提交用户定义的 Connect:Direct 进程。 有关更多信息，请参阅 从文件传输请求提交用户定义的 Connect:Direct 进程。
• 如果 Connect:Direct 使用用户定义的进程从源中移动文件或数据集，那么此参数将通过 %FTEFDISP 内部符号变量传递到该进程。 用户定义的进程确定是否删除源。 传输返回的结果取决于用户定义的进程返回的结果。

如果指定 -sd 参数，那么不能指定 -td 参数，因为这些参数是互斥的。 然而，您可以在传输定义文件中指定源处置行为。

-r

可选。 当 source_specification 包含通配符时，那么将以递归方式传输子目录中的文件。 当向 Managed File Transfer 提供通配符作为 source_specification时，仅当指定了 -r 参数时，才会传输与通配符匹配的任何子目录。 在 source_specification 与子目录匹配时，始终传输该目录及其子目录中的所有文件（包含隐藏的文件）。

如需了解 Managed File Transfer 如何处理通配符，请参阅在MFT中使用通配符

如果指定 -r 参数，那么不能指定 -td 参数，因为这些参数是互斥的。 然而，您可以在传输定义文件中指定递归行为。

-sce 源字符编码

可选。 指定用于在执行字符转换时读取源文件的字符编码。 该选项仅适用于文本文件，而且还必须指定 -t text。 适用于转换的代码页取决于目标代理程序的平台，因为转换在目标系统上执行。 可用代码页列表，请参阅 MFT的可用代码页。

noswaplfnl

缺省情况下， Managed File Transfer 将 swaplfnl 与受支持的 EBCDIC 字符集配合使用。 使用 swaplfnl 可更改与 EBCIDIC LF 0x25 字符之间的字符集映射的行为。 但是，该操作有时候会产生不需要的映射。 使用 noswaplfnl 覆盖此行为。

-skeep

可选。 指定在文本方式传输过程中保留从固定长度格式的面向记录的文件读取的源记录上的尾部空格（例如，z/OS 数据集）。 如果未指定该参数，将从源记录移除尾部空格。

- srdb 分隔符

可选。 对于面向记录的源文件（例如，z/OS 数据集），指定一个或多个字节值以在将记录追加到二进制文件时作为定界符插入。 必须将每个值指定为 00-FF 范围内的两个十六进制数字，前缀为 x。 使用逗号分隔多个字节。 例如：

 -srdb x0A 

或

 -srdb x0D,x0A

必须以二进制方式配置传输。

- 战略、风险和开发计划

可选。 指定要插入源记录定界符的位置。 只有在指定了 -srdb 参数的情况下才可以指定 -srdp 参数。

指定以下某个选项：

前缀

在每条记录的开头插入的定界符。

postfix

在每条记录的尾部插入的定界符。 这是缺省选项。

-sq

可选。 指定传输的源是队列。

如果要调用针对代理定义的任何 Managed File Transfer 传输 I/O 用户出口，请不要在传输中指定-sq 参数。 使用 -sq 参数可防止针对源调用传输 I/O 用户出口，并表示改为使用标准 Managed File Transfer I/O。

-sqgi

可选。 指定按 IBM MQ 组标识对消息进行分组。 第一个完整组将写入目标文件。 如果不指定此参数，那么源队列上的所有消息将写入目标文件。

只有在指定了 -sq 参数的情况下才可以指定 -sqgi 参数。

-sqdt 文本定界符

可选。 指定一个文本序列，以在将多条消息追加到文本文件时作为定界符插入。 可将字符串字面值的 Java 转义序列包含在定界符中。 例如，-sqdt \u007d\n。

使用传输的源编码将文本定界符编码为二进制格式。 将以二进制格式读取每条消息。 编码的定界符将以二进制格式附加到消息 (如 -sqdp 参数所指定) ，并且结果将以二进制格式传输到目标代理。 如果源代理代码页包含移入和移出状态，那么代理假定每条消息在消息结束时进入移出状态。 在目标代理上，以与文件相同的方式将二进制数据转换为文件文本传输。

只有在指定了 -sq 参数以及 -t 参数的 text 值时，您才可以指定 -sqdt 参数。

-sqdb 十六进制定界符

可选。 指定一个或多个字节的值，以在将多条消息追加到二进制文件时作为定界符插入。 每个值都必须指定为两个十六进制数字，范围为 00-FF，前缀为 x。 多个字节必须以逗号分隔。 例如，-sqdb x08,xA4。

只有在指定了 -sq 参数的情况下才可以指定 -sqdb 参数。 仅当同时为 -t 参数指定值 text 时，才能指定 -sqdb 参数。

-sqdp 位置

可选。 指定源文本和二进制定界符的插入位置。 只有在指定 -sqdt 和 -sqdb 参数之一时，才可以指定 -sqdp 参数。

指定以下某个选项：

前缀

在每条消息的开头插入定界符

postfix

在每条消息尾部插入定界符。 这是缺省选项。

-sqwt 等待时间

可选。 指定等待以下某个条件得以满足的时间（秒）：

• 对于要在队列上出现的新消息
• 如果指定了 -sqgi 参数，那么针对要在队列上显示的完整组

如果在等待时间指定的时间内，这两个条件均未满足，那么源代理将停止从队列读取并完成传输。 如果未指定 -sqwt 参数，那么在以下条件下源代理立即停止读取源队列：源队列为空、指定了 -sqgi 参数或者队列中无完整组。

有关使用 -sqwt 参数的信息，请参阅 “消息到文件传输的等待时间指定指南 ”。

只有在指定了 -sq 参数的情况下才可以指定 -sqwt 参数。

source_specification

确定文件传输源的一个或多个文件规范。

必需 (如果指定 -df， -dd， -dp， -dq或 -ds 参数之一)。 如果指定 -td 参数，请勿指定 source_specification。

• 如果尚未指定 -sq 参数，那么 source_specification 是用于确定文件传输的源的一个或多个文件规范。 文件规范可采用五种格式之一，并且可包含通配符。 有关通配符的更多信息，请参阅在 MFT 中使用通配符。 您可以在文件规范中使用两个星号字符 (**) 来转义属于文件规范的星号。

  您可以指定由空格字符分隔的多个源文件规范。 然而，如果针对 -df 或 -ds 参数指定多个源规范，并且还指定了 -de overwrite，那么目标将仅包含最后指定的源文件的数据。 如果未指定 -de overwrite，那么传输仅可能部分成功。 如果目标文件先前不存在，那么它将包含您首先指定的源文件的数据。

  要传输文件名中包含空格的文件，例如，a b.txt 到文件 c d.txt，请用双引号将包含空格的文件名引起来。 在 fteCreateTransfer 命令中指定以下文本：

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

  每个文件规范都必须为以下类别之一：

  文件名称

  针对运行源代理程序的系统以适当的表示法表示的文件名称。 将文件名指定为源文件规范时，将复制该文件的内容。

  目录

  针对运行源代理程序的系统以适当的表示法表示的目录的名称。 当目录指定为源文件规范时，将复制目录的内容。 更准确来说，将复制目录及其所有子目录中的所有文件，包括隐藏的文件。

  例如，要仅将 DIR1 的内容复制到 DIR2 ，请指定 fteCreateTransfer ... -dd DIR2 DIR1/*

  连续数据集

  顺序数据集或分区数据集成员的名称。 通过在数据集名称之前加上两个正斜杠字符 (//) 来表示数据集。

  如果指定协议网桥代理作为源代理，那么您之后无法指定数据集作为源文件规范。

  分区数据集

  分区数据集的名称。 通过在数据集名称之前加上两个正斜杠字符 (//) 来表示数据集名称。

  如果指定协议网桥代理作为源代理，那么您之后无法指定数据集作为源文件规范。

  Connect:Direct 节点上的文件名或目录

  (仅限Connect:Direct 网桥代理)。 Connect:Direct 节点的名称，冒号字符 (:) 以及托管 Connect:Direct 节点的系统上的文件或目录路径。 例如，connect_direct_node_name:file_path。

  如果源代理是 Connect:Direct 网桥代理，那么它将仅接受此格式的源规范。

  注: 当源代理是 Connect:Direct 网桥代理时，文件路径中不支持通配符。

  协议文件服务器上的文件名或目录

  协议文件服务器的名称、冒号 (:)，以及协议服务器系统上的文件或目录路径。 例如，protocol_server:file_path。

  如果未指定协议服务器，那么将使用缺省协议服务器。

• 如果指定了 -sq 参数，那么 source_specification 是源代理队列管理器上本地队列的名称。 您只能指定一个源队列。 采用以下格式指定源队列：

  QUEUE_NAME

  源队列规范中未包含队列管理器名称，因为队列管理器必须与源代理队列管理器相同。
• 如果源代理位于 z/OS ，则以 // 开头的源文件将被视为 z/OS 分区数据集。

其他参数

-或-h

可选。 显示命令语法。

返回码