FCOPY Reference Manual (32212-90008)

Chapter 5 87
FCOPY Functions
NEW
NEW
Creates a new permanent disk file as the tofile.
Syntax
;NEW
Operation
The new file is created in the account and group specified at the start of your job or session
(unless otherwise specified). Its name is the name specified with the TO parameter.
File Characteristics
The default characteristics of the new disk file are summarized in appendix B. If you want
to predefine the characteristics of a new file, use the MPE FILE command to define them
and then backreference that file in the FCOPY command.
Terminating or Interrupting an Operation
If the FCOPY operation containing the NEW function terminates because of an error,
FCOPY discards the new file. If you interrupt the operation by pressing CTRL Y, FCOPY
saves the new file.
Restrictions
You cannot combine NEW with CHAR, CLEAR, KANA, OCTAL, HEX, or HEXO.
Examples
In the following example, FCOPY creates a new disk file named NEWFILE in the user's
account and group, and then copies the disk file OLDFILE into NEWFILE.
>FROM=OLDFILE;TO=NEWFILE;NEW