CLI Reference > Workflows and Documents Commands > im propagatetraces
  
im propagatetraces
allows you to copy selected trace relationships to a branched document
Synopsis
im propagatetraces ][--[no]subSegment] [--[no]batch] [--copyFromEnd=value] [--copyFromStart=value] [--copyToEnd=value] [--traces=field,field,...] [--hostname=value] [--port=value] [--password=value] [--height=value] [--width=value] [-x value] [-y value] [--user=value] [(-g|--gui)] [(-?|--usage)] [(-F value|--selectionFile=value)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] [(-N|--no)] [(-Y|--yes)] [--cwd=value] [--forceConfirm=[yes|no]] segment id...
Description
The im propagatetraces command enables you to copy selected trace relationships to a branched document.
For example,
im propagatetraces --copyFromStart=801456 --copyFromEnd=801789 --copyToEnd=801112 --fields=Tests 801123
copies the Tests trace relationships that exists between document 801456 and document 801789 to create new Tests trace relationships between document 801123 and 801112.
When you use the -g or --gui option, Windchill RV&S displays the Finder dialog box. If you browse for issues from the issue selection dialog box, any changes you make to the columns in the Issues View will not be applied to that view when it is accessed through the Windchill RV&S Client GUI.
Options
This command takes the universal options available to im commands, as well as some general options. See the options reference page for descriptions.
--[no]subSegments
specifies whether to follow document node references to subsegments if applicable.
--traces=field,field,...
trace relationship fields to copy to the branched document. If no fields are specified, all trace relationships found in the source documents are copied.
--copyFromStart=value
specifies the ID of the document you want to copy trace relationships from
--copyFromEnd=value
specifies the ID of the document that has trace relationships with the document identified in --copyFromStart.
--copyToEnd=value
specifies the document that you want to create the trace relationships for.
segment id...
specifies the ID of the document that you want to copy trace relationships to.
See Also
Commands: im branchsegment, im viewsegment, im createsegment
Miscellaneous: options