REName subcommand

Purpose

Use the REName subcommand to rename a file, data set, or z/OS® UNIX named pipe on the remote host.

Format


>>-REName--original_name--new_name-----------------------------><

Parameters

original_name: Specifies the current name of the file.
new_name: Specifies the new name of the file.

Results:

For MVS™ data sets, if the data set that is specified by the new_name value already exists, the server rejects the rename request.
For z/OS UNIX files and named pipes, if the file that is specified by the new_name value already exists, the existing file is replaced.

Restriction: When you use the FTP RENAME subcommand with a generation data group (GDG), for example, RENAME SOURCE.FILE MY.GDG(+1), serialization of the GDG data set is not assured. To avoid this, instead use the FTP PUT subcommand. For more information about GDG processing, see Information APAR II08285.