CLI Reference > Workflows and Documents Commands > im viewsourcetraces
 
im viewsourcetraces
displays trace information for one or more source files
Synopsis
im viewsourcetraces [--devpath=path] [--fields=field[:width[:rich|plain]],field[:width[:rich|plain]],...] [--fieldsDelim=value] [--asOf=[<date>|label:<label>] [--height=value] [(-P project|--project=project)] [--projectRevision=value] [(-r rev|--revision=rev)] [--scmHost=value] [--scmPort=value] [--sortAscending] [--sortField=field] [--width=value] [-x value] [-y value] [(-?|--usage)] [(-F value|--selectionFile=value)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value] [--forceConfirm=[yes|no]] [--hostname=value] [--port=value] [--password=value] [--user=value] [(-g|--gui)] source file...
Description
im viewsourcetraces displays trace information for one or more source files.
For example,
im viewsourcetraces -g --devpath=SP1 -r 1.30.1.1 -p "/Release1/project.pj" dataStructure.txt
displays information for all traces for revision 1.30.1.1 of dataStructure.txt in the SP 1 variant of the Release 1 project.
Options
This command takes the universal options available to im and sicommands, as well as some general options. See the options reference page for descriptions.
--fields=field[:width[:rich|plain]],field[:width[:rich|plain]],...
specifies the issue fields, and their respective widths, to be displayed. Your administrator defines the fields in an issue type. Use commas to specify more than one field. The default fields displayed in the CLI are independent of the default fields (columns) specified in the GUI view.
--fieldsDelim=value
specifies the string to be used as a delimiter between the fields in the display.
--asOf=<date>|label:<label>
allows you to view source traces as of a specific date or label. This field is optional. If a value is not provided the source traces are viewed as of the current time.
--sortField=field
specifies the field to sort issues by, for example, ID.
By default, issues are sorted by ID.
--sortAscending
specifies whether to sort the specified fields in ascending order.
--scmHost=value
the host name of the configuration management server where the traced source files are stored.
--scmPort=value
the port number of the configuration management server where the traced source files are stored.
source file...
identifies a specific source file; use spaces to specify more than one source file.
See Also
Commands: im copyissue, im createissue, im viewissue, im editissue
Miscellaneous: options