Problem:

How can I add a view using the command line?

Resolution:

• Product Name: StarTeam
• Product Version: 2005, 2005 Rel2, 2006
• Product Component: Client, Command Line
• Platform/OS Version: All

Question:

How can I add a view using the command line?

Answer:

First, make sure the command line function can be run from the system path. Open a Windows command line: Start --> Run --> CMD Type stcmd and hit enter. If a message is returned that it cannot find this command, then navigate within the command line window to the StarTeam client installation folder (normally, C:\Program files\Borland\StarTeam Cross Patform Client 2006) and enter stcmd. If this does not work, then please contact Technical Support.

After you have verified that you can use STCMD, you can add a file using the following method:

Use stcmd add-view to add a view to a StarTeam server configuration from the command line. When the view is created, its parent view is the view specified with the -p option and its root folder is the folder specified with the -p option. In this command, the -rp option specifies the working folder for the root folder. Use the following options to create the following types of views:

• Use -dr to create a read/write reference view.
• Use -dr -ro to create a read-only reference view.
• Use -dr -ba to create a branching view in which the behavior of existing items is set to branch on change.
• Use -dr -bn to create a branching view in which the behavior of existing items is not set to branch on change.
• If you do not use -dr, a blank view is created.

The syntax for this command is as follows:

stcmd add-view -p "projectSpecifier" [-pwdfile "filePath"] [-cmp] [-encrypt encryptionType] [-q] [-x] [-stop] -name "viewName" [-rp "folderPath"] [-d "description"] [-dr [-ro | -ba | -bn [-cfgl "labelName" | -cfgp "stateName" | -cfgd "asOfDate"]]]

Author: Donnie Nix