rends

Purpose

Use the rends command to rename a dataset file or directory. For example, the following command renames old_file to new_file and moves it from old_dir to new_dir:

ob> rends old_dir/old_file new_dir/new_file

The following command creates new_file in the current directory:

ob> rends old_dir/old_file new_file

See Also:

"Dataset Commands" for related commands

Prerequisites

You must have the modify administrative domain's configuration right to use the rends command.

Syntax

rends::=

rends [ --nq ] { old-dataset-name new-dataset-name }...

Semantics

--nq: Does not display a confirmation message. If you do not specify this option, then the command displays a confirmation message. The message is described in "Command Execution in Interactive Mode".
old-dataset-name ...: Specifies the name of the existing dataset file or directory that you want to rename. Refer to "dataset-name" for a descriptions of the dataset-name placeholder.
new-dataset-name ...: Specifies a new name for the dataset file or directory. Note that you can use new-dataset-name to specify a new dataset path. Refer to "dataset-name" for a descriptions of the dataset-name placeholder.

Example

Example 2-109 renames dataset datadir.ds in the top-level directory to tbrset/ddir.ds.

Example 2-109 Renaming a Dataset

ob> lsds
Top level dataset directory:
tbrset/
datadir.ds
ob> rends --nq datadir.ds tbrset/ddir.ds
ob> cdds tbrset
ob> lsds
Dataset directory tbrset:
ddir.ds
entire_backup
tiny_backup