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