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

'trace'ing a link/relationship between starteam artifact instances

'trace'ing a link/relationship between starteam artifact instances

A trace is a link between any two StarTeam items. It expresses a join relationship. Use the trace
command to create or to find and update a trace in a project/view described by the -p parameter (or
preceding connect/set commands). A trace will only be created if its endpoints are guaranteed to exist.

Syntax
The syntax for this command is:
trace [-id traceID]
[-sourceType sourceTypeName -sourceID sourceItemID
[-sourceView sourceViewName]]
[-targetType targetTypeName -targetID targetItemID
[-targetView targetViewName]]
[-pinSource] [-pinTarget] [-suspect]
[-p "user:password@host:port/project/view"] [ -epwdfile "pathToFile"]

Parameter Description


-id traceID Optional. If specified, an existing trace (identified by traceID) is updated,
otherwise, a new trace is created.

[-sourceType sourceTypeName -sourceID sourceItemID [-sourceView sourceViewName]]
Optional. If specified, the source endpoint is set to the item which is
identified by sourceItemID, sourceTypeName (e.g. changerequest,
task, story, sprint, etc) and source view name.
Source view name is optional. If not specified, the source item must resolve
to an item in the same view as the trace.


[-targetType targetTypeName -targetID targetItemID [-targetView targetViewName]]
Optional. If specified, the target endpoint is set to the item which is
identified by targetItemID, targetTypeName (e.g. changerequest,
task, story, sprint, etc) and target view name.
Target view name itself is optional. If not specified, the target item must
resolve to an item in the same view as the trace.


[-pinSource] Optional. The default behavior is for the trace to float at the source end. If
specified, the trace is pinned to the source tip.


[-pinTarget] Optional. The default behavior is for the trace to float at the target end. If
specified, the trace is pinned to the target tip.


[-suspect] Optional. The default behavior is for a trace not to be marked suspect. If
specified, the trace is marked as suspect (it's suspect flag is set to true).

Example
The following will create a trace in the bar view, source endpoint ChangeRequest (ID 1234) also from
the bar view, target endpoint Story (ID 5678) from the foo view, source floating, target pinned:
stcmd trace -sourceType changerequest -sourceID  1234 -targetType story -targetID 5678 -targetView "foo" -pinTarget -p "user:pwd@host:port/project/bar"

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 15:58
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.