'move'ing artifacts inside the StarTeam repository, across projects, views or folders
Use the move command to move StarTeam items. You can use this command to move all item types:
Folder, File, Change request, Task, Topic, Requirement, Sprint, Story, Concept, WhiteBoard, and custom
The syntax for this command is:
move –p “user:pwd@host:port/project/view” [ -epwdile “pathToPasswordFile” ] [ -csf ] –type “typeName” –id itemID
[ -tp targetProjectName ] [ –tv “targetViewName” ] [ -tfp “target folder path” ]
-csf if specified, turns on case sensitive checking of folder names. If not specified, then the platform default behavior applies.
-type describes the type name of the item to be shared. May be one of the stock type names, e,g,
file, folder , changerequest, task, topic, requirement, sprint, story, plan or any custom type name
-id can be either the unique item (view member) id of the item. View Member IDs are found by looking in the property lists of the cpc or can be queried using the select command, OR, the primary descriptor of the item; e.g. file name, folder name, changerequest number.
-tp describes an optional specific target project to move into. If not specified, then the item will be moved into the source view described by –tv, assuming that is specified. If neither is specified, then the move will occur into the original view as specified by –p.
If –tp is specified, and –tv is not, then the move will occur into the default (root) view of the project described by –tp.
-tv describes an optional specific target view to share into. If not specified (and –tp not specified), then the item will be moved into the source view described by –p.
-tfp describes the folder path to share to. If a folder name is specified, then this name must be unique across the folder tree. Otherwise, a fully qualified folder path is required, starting from the root folder of the view down to the leaf folder into which the share must be created.
If –tfp is not specified, then the share will be created in the root folder of the target view –tv.
Note also that if a share of the item already exists in the target folder, then the move will not occur. An error will be returned.
Note that either one of –tp, -tv or –tfp must be specified.