File Management - IBM

72 File Management V4R5
Table 9. Copy Operations (continued)
From-Files To-Files
:
1
2
3
4
5
If the from-file and the to-file are both diskette files, the to-file must be spooled.
If the to-file does not exist before the copy operation, the copy operation will create
a physical file as the to-file if you specified:
v CRTFILE(*YES) on the CPYF command and the from-file is a physical or logical
file.
v CRTFILE(*YES) on the CPYFRMQRYF command.
Open query files can only be copied by using the CPYFRMQRYF command.
CPYFRMQRYF is not allowed for open query files that use DDM files.
If TOFILE(*PRINT) is specified, the from-file records are copied to the
IBM-supplied printer device file QSYSPRT and formatted according to the
OUTFMT parameter.
An inline data file (which is handled like a device file) is included as part of a
batch job when the job is read by a reader program.
While copying records, some of the copy commands can perform the following
functions:
v Copy from or to the first file member, a particular file member, a generic set of
members, or all file members (FROMMBR and TOMBR parameters).
v Add a member to a physical to-file if the member does not exist.
v Add records to an existing file member, replace the contents of an existing
member (MBROPT parameter), or update duplicate key records in a to-file
member.
v Select certain records to copy by one of the following methods:
– Selecting records by record format name when a multi-format logical file is
copied (RCDFMT parameter).
– Specifying records by starting at a relative record number and ending at a
relative record number (FROMRCD and TORCD parameters).
– Specifying records by starting with a specific record key value and ending
with another specific record key value (FROMKEY and TOKEY parameters).
– Specifying the number of records that you want to copy (NBRRCDS
parameter).
– Selecting records by the contents of one or more character positions in the
record or in a field in the record (INCCHAR parameter).
– Selecting records according to the values that are contained in one or more
fields in the record (INCREL parameter).
– Disregard or include deleted records in the from-file during the copy if
processing the from-file in arrival sequence (COMPRESS parameter).
v Print copied records, excluded records, or error records (PRINT parameter) in a
specified format (OUTFMT parameter).
v Copy records whose from-file and to-file record formats are different (FMTOPT
parameter). When formats are different, you can perform any of the following
actions:
– Map fields whose names are the same in the from-file and to-file record
formats and whose field attributes are compatible (*MAP value).
– Drop fields in the from-file record format that do not exist in the to-file record
format (*DROP value).