The COPY-FILE command may be used to rename and/or move files to a new dictionary. Only File Definition items may be operated on by COPY-FILE. After executing COPY-FILE, the original file is deleted.
Format
|
COPY-FILE [DICT] dict-name data-name |
Parameter(s)
|
DICT |
Specifies the file dictionary. |
|
dict-name |
Specifies the name of the dictionary. |
|
data-name |
Specifies the name of the data file. |
Description
COPY-FILE may only move File Definition items to dictionaries which are at the same level as the source dictionary. For example, the File Definition item in the Master Dictionary may not be copied to the SYSTEM dictionary or to a file dictionary; however, it may be copied to another account’s Master Dictionary.
The following is an example of the file TEST (existing at both the dictionary and data level) being copied to NEWFILE:
|
>COPY-FILE MD TEST TO: NEWFILE |
The result of the above example is a file with a dictionary named NEWFILE and a data file named TEST. To rename the data file named TEST, it must be referenced directly. For example:
|
>COPY-FILE DICT NEWFILE TEST TO: NEWFILE |
Renaming an account is the most powerful feature of COPY-FILE. The following is an example of an account being renamed:
|
>COPY-FILE SYSTEM ACCOUNT.PAY TO: ACCOUNT.REC |
Where SYSTEM is the system dictionary, ACCOUNT.PAY is the account to be renamed, and ACCOUNT.REC is the new account name.