CPYF

复制文件 - 帮助

“复制文件” (CPYF) 命令从数据库或外部设备将全部或部分文件复制到数据库或外部设备。它能够：

o 在数据库文件之间复制数据和源文件。记录可以 从 物理或逻辑文件复制。然而，记录只能 复制到 物理文件， 而不能 复制到逻辑文件。

o 从外部设备如软盘和磁带将数据和源文件复制到数据库。

o 将数据和源文件由数据库复制到外部设备。

o 将数据和源文件由外部设备复制到其他外部设备。

o 将数据和源文件由直接插入数据文件复制到数据库或外部设备。

限制：

1. 在运行 CPYF 请求时，可以锁定在 TOFILE 参数上命名的文件（类似于没有超时的 *EXCL 锁定）以使访问不可能。

2. 当指定 CRTFILE(*YES) 参数时且复制的文件（ FROMFILE 参数）有相关的触发器时，创建的文件（ TOFILE 参数）没有相关的触发器。“添加物理文件触发器”

(ADDPFTRG) 命令必须用于添加一个触发器到文件。

3. 在多线程作业中，若复制自或至多个数据库文件成员、设备文件（SPOOL(*YES)

打印文件除外）、分布式文件或类型为 SNA 的 DDM 文件，则此命令不是线程安全的。对于使用类型为 *SNA 的关系数据库的分布式文件和类型为 *SNA 的 DDM 文件，此命令失败。仅当复制自或至单数据库文件成员（本地或类型为 *IP 的 DDM ）或

SPOOL(*YES)打印文件时，它才是线程安全的。

Note: 除非该项是显示带有星号（在屏幕上或帮助信息中）的“特殊值”，否则不要在项前加星号。

下列命令的错误消息： CPYF

*ESCAPE 消息

CPF2807 接收到消息 &7 的取消回答。

CPF2816 因为发生错误，所以不复制 &2 的文件 &1 。

CPF2817 因为发生错误，所以结束复制命令。

CPF2818 在 TOMBR 不允许使用 *FROMMBR 值。

CPF2835 INCCHAR 起始位置及长度太长。

CPF2857 多个成员或标号的复制不允许用于覆盖。

CPF2858 打印输出的文件属性不正确。

CPF2859 不允许共享打开数据路径。

CPF2864 未获权限使用库 &2 中的文件 &1 。

CPF2875 打开了错误的文件成员或标号。

CPF2883 创建库 &2 中的文件 &1 时，发生错误。

CPF2888 因为发生错误，所以未将成员 &3 添加至文件。

CPF2904 对于多个标号复制，软盘标号无效。

CPF2906 值对于 INCREL 字段无效。

CPF2909 清除 &2 文件 &1 中的成员 &3 时，发生错误。

CPF2949 结束 &2 中文件 &1 的成员 &3 时，发生错误。

CPF2952 打开库 &2 中的文件 &1 时，发生错误。

CPF2968 复制 &2 内的文件 &1 时发生位置错误。

CPF2971 读取文件 &1 中的成员 &3 时，发生错误。

CPF2972 写入文件 &1 的成员 &3 时，发生错误。 CPF2975 从键控文件中阅读时，发生错误。

CPF2976 错误的数目大于 ERRLVL 值。

CPF3140 成员 &2 的初始化或复制已取消。

CPF3143 成员 &2 不允许增量。

CPF3148 成员 &2 的新记录需要太多空间。

CPF3150 成员 &2 的数据库复制失败。

CPF9212 无法装入或卸出 &3 中的 DDM 文件 &2 。

自文件 (FROMFILE)

指定包含正被复制的记录的数据库文件或设备文件的名称和库。数据库文件可以是物理文件或逻辑文件。设备文件可以是软盘文件或磁带文件。

可能的库值是：

*LIBL

搜索作业的库列表的用户和系统部分中所有库，直到找到第一个匹配的库。

*CURLIB

作业的当前库用于定位数据库文件或设备文件。若未指定库作为作业的当

前库，则使用 QGPL 库。

库名

指定要显示的库名。

文件名称

指定包含已复制记录的数据库或设备文件的名称。

目标文件 (TOFILE)

指定接收复制记录的文件的限定名。

Note: 设备文件可以是软盘文件、磁带文件或打印机文件。但是：

(1) 若源文件和目标文件均为软盘文件，则必须假脱机目标文件（SPOOL(*YES)

必须在“创建软盘文件” (CRTDKTF) 、“更改软盘文件” (CHGDKTF) 或“覆盖软盘文件” (OVRDKTF) 命令上指定）。

(2) 不能指定外部描述的打印机文件。

若设备文件是打印文件，或者指定 TOFILE(*PRINT), 则在图形数据周围不添加移出和移入 (SO-SI) 字符。可指定 OUTFMT(*HEX) 以便以十六进制格式打印数据。

*PRINT

数据被复制到系统打印机设备文件 (QSYSPRT) ，并根据在 打印格式提示（ OUTFMT 参数）中指定的值被格式化。

可能的库值是：

*LIBL

搜索作业的库列表的用户和系统部分中所有库，直到找到第一个匹配的库。

*CURLIB

作业的当前库用于定位物理文件或设备文件。若没有指定当前库，则使用QGPL 。

库名

指定要显示的库名。

文件名称

指定接收复制记录的物理文件或设备文件的限定名。

起始成员 (FROMMBR)

指定要复制的源文件中的数据库文件成员名或软盘文件标号，磁带文件标号。

可能的值是：

*FIRST 复制数据库源文件中的第一个成员。对软盘而言，必须在用 " 软盘文件覆盖

(OVRDKTF)" 命令上或在设备文件中指定标号标识符。若源文件是直接文件，则只允许

*FIRST 值。

*ALL

复制数据库源文件的全部成员或软盘源文件的全部文件标号标识符。

*ALL 对磁带文件或直接文件无效。

成员名

指定正被复制的文件成员的数据库源文件成员和软盘源文件标号或磁带源文件标号的名称。