'share'ing a StarTeam artifact across projects, views or folders
Use the share command to share StarTeam items. You can use this command to share all item types:
Folder, File, Change request, Task, Topic, Requirement, Sprint, Story, Concept, WhiteBoard, and custom
The syntax for this command is:
share -p "username[:password]@host:port/projectName/viewName/
folderHiedrarchy" -epwdfile "passwordfilepath" -csf -type typeName
-id viewMemberID -tp targetProjectName -tv targetViewName -tfp "/folderHierarchy/"
[-boc true|false] [ -vctip | -vclbl labelid | -vcps promotionStateID | -vcdttm datetime [-pattern datetimepattern] ]
-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 is the unique item (view member) id of the item to be shared. ViewMemberIDs are found by looking in the property lists of the cpc or can be queried using the select command.
-tp describes an optional target project to share into. If not specified, then the share will be created in the source project described by –p
-tv describes an optional target view to share into. If not specified, then the share will be created in 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 already exists in the target folder, then a new share will not be created. An error will be returned.
Note that either one of –tfp or –tv must be specified.
The remaining parameters are all optional. If not specified, then they default to the view level behavior.
-boc is set to true for brach on change ON, false for branch on change OFF.
-vctip specifies that the new share floats
-vclabel specifies that the new share is pinned to the specified label
-vcps specifies that the new share is pinned to the specified promotion state
-vcdttm specifies that the new share is pinned to the specified point in time.
(an optional –pattern describes the syntax of the date time string, just as in other commands)
The share command returns the item id of the newly created share.