Share this page
Share: share
Use share to share any StarTeam artifact from one view to another view, from a folder to another folder in the same view, and etc.
The share command returns the item ID of the newly created share.
Syntax
The syntax for this command is:
share –p “user:pwd@host:port/project/view” [ -epwdile “pathToPasswordFile” ] [-csf] [-ctfp] –type “typeName” –id itemID [–tv “targetViewName”] [-tfp “target folder path”] [-boc true|false] [-vctip | -vclbl labelid | -vcps promotionstateid | -vcdttm “datetimestring” –pattern “datetimepattern” ]
Parameters
For information about the command parameters, refer to Operation Parameters.
In addition:
| Parameter | Description |
|---|---|
| -tv | Describes an optional specific target view into which to share. If not specified (and -tp is not specified, then the item will be shared into the source view described by -p. |
| -tfp | Describes the folder path to which to share. 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. |
| -tp | Describes and optional specific target project into which to share. If not specified, then the item will be shared into the source view described by
-tv, assuming that is specified. If neither is specified, then the share will occur into the original view as specified by
-p.
If -tp is specified, and -tv is not, then the share will occur into the default (root) view of the project described by -tp. |
The remaining parameters are optional. If not specified, they default to the view level behavior:
| Parameter | Description |
|---|---|
| -boc | Set to
true for branch 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. A label is identified by either the unique integer ID or the label name. |
| -vcps | Specifies that the new share is pinned to the specified promotion state. A promotion state is identified by either the unique integer promotion state ID or the promotion state name. |
| -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 like in other commands.
|
| -ctfp |
Available in versions: 17.1 and higher Creates the target folder path prior to the share, if it does not already exist. |
