Set Project and View: set

After connecting to the server using the connect command, use the set command to designate the project and view.

Note: This command is part of the stateful model and only works with stcmd, not stcmdEx.

Syntax

The syntax for this command is:

stcmd set project=projectName 
[view=viewName | viewHierarchy=viewName:viewName:…] 
[folderHierarchy=folderName/folderName/....]
[-cfgl "label" | -cfgp "promotion state" | -cfgd "date"]
[-pattern "date-pattern"]
Parameter
Description
project
Specifies the project name.
view
Specifies the view name.
viewHierarchy
Specifies the view hierarchy. Use ":" to separate view name within hierarchy.
folderHierarchy
Specifies the folder hierarchy. Use "/" to separate each folder name within the hierarchy. Start with the root folder and end with the branch folder.
-cfgl
Configures the view using the specified label. Without -cfgl, -cfgp, or -cfgd, the view’s current configuration is used.
-cfgp
Configures the view using the specified promotion state.
-cfgd
Configures the view as of the specified date/time. Examples include:

"12/29/13 10:52 AM"

"December 29, 2013 10:52:00 AM PST"

"Monday, December 29, 2013 10:52:00 AM PST"

-pattern
Qualifies the datetime. It can be specified wherever a date-time is specified, such as -cfgd, -vd, etc. The pattern must match any valid pattern supported by the java JDK in java.text.SimpleDateFormat.applyLocalizedPattern(String). The pattern may be localized.
For every command that takes a -pattern parameter, a -locale parameter is optionally available. This is the "two character country code".

Example

The following example connects to the server using the connect command and designates the project of StarDraw and the view of StarDraw using the set command. After connecting and designating project and view, execute all command for that project and view without reconnecting each time. When command are complete, use the disconnect command to disconnect from the project, view, and server. Alternatively, use the set command to switch to a different project/view without disconnecting. You can then execute all command in the new project/view context.

stcmd connect "JMarsh:password@Orion:1024" 
stcmd set project = 'StarDraw' view ='StarDraw'