Show TOC

MOVELocate this document in the navigation structure

Use

Moves a checked-out resource from its activity to another activity. Both the source activity (the activity from which the resource is moved) and the target activity (the activity to which the resource is moved) can be specified by either their names or their display names.

Syntax

Syntax

MOVE <folderItemPath> [-a sourceActivityName] <-a targetActivityName> [-dn]

Arguments

<folderItemPath>

The path to the item to be moved.

[-a sourceActivityName]

To specify the source activity where the file or folder(s) is checked out and the target activity to which they have to be moved. If the source activity is not specified and the folder item is not checked out or is checked out in more than one activity, then nothing is done. If the source activity is specified but the folder item is not checked out in the given activity then:

If the folder item is checked out in only one activity, then that is used as the source.

If the folder item is not checked out or is checked out in more than one activity then nothing is done. If the target activity does not exist, it is created.

<-a targetActivityName>

Name of the target activity.

[-dn]

Specifies if the name of the activity is the display name and not the actual name.

Description

Moves a file or folder checked out in a source activity to the target activity. Takes the path (local or remote) as an argument. Wild characters are accepted.

Example

Moving a File Into an Activity

To move file a.java (which is checked out in the activity named a1 ) into activity a2 , execute:

move a.java -a a2

Since one user can check out a file in only one activity, there is no need to specify the activity to which the resource is currently checked out.

Moving a Checked-Out Version into Another Activity

The current folder is checked out into activity a1 . To move the checked-out version of the folder from activity a1 to activity a3 , execute:

move . -a a1 -a a3