Having problems with your account or logging in?
A lot of changes are happening in the community right now. Some may affect you. READ MORE HERE

'share'ing a StarTeam artifact across projects, views or folders

'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
components.

Syntax
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] ]

Parameter Description

-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.

DISCLAIMER:

Some content on Community Tips & Information pages is not officially supported by Micro Focus. Please refer to our Terms of Use for more detail.
Version history
Revision #:
1 of 1
Last update:
‎2016-11-07 16:16
Updated by:
 
The opinions expressed above are the personal opinions of the authors, not of Micro Focus. By using this site, you accept the Terms of Use and Rules of Participation. Certain versions of content ("Material") accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners.