CLI Reference > Workflows and Documents Commands > tm testcases
 
tm testcases
displays test cases for a test session
Synopsis
tm testcases [--fields=field1[:width1],field2[:width2]...][--fieldsDelim=value] [--[no]substituteParams][--queryDefinition=query] [--height=value] [--width=value] [--x=value][--y=value] [--hostname=value] [--port=value] [--password=value][--user=value] [(-?|--usage)] [(-g|--gui)] [(-F value|--selectionFile=value)][--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]][(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value][--forceConfirm=[yes|no]] caseID|sessionID:caseID...
Description
This command allows you to view the test cases for one or more test sessions. Test cases are displayed in the order they appear in the test document(s) referenced by the test session. Attachments and related items display as a comma separated list of attachment names and related item IDs.
* 
The test cases that display for test documents are based on the date in the test session’s Tests As Of Date field. Test cases added to test suites after this date are not displayed.
Options
This command takes the universal options available to Integrity Lifecycle Manager commands, as well as some general options. See the options reference page for descriptions.
--fields=field1[:width1],field2[:width2]...
the test case fields, and their respective widths, to be displayed. Use commas to specify more than one field.
--fieldsDelim=value
the string to be used as a delimiter between the fields in the display.
--[no]substituteParams
specifies whether to replace parameter references in text fields with a parameter value. For more information on how parameter values are determined, see the Integrity Lifecycle Manager Help Center.
--queryDefinition=query
defines the query that determines what test cases display. For details of the query format, see the im createquery reference page.
* 
Do not use complex query definitions. For example, any form of query that uses a short or long text field.
sessionID...
specifies one or more test sessions that you want to view test cases for.
See Also
Commands: tm createresult, tm editresult, tm viewresult, tm extractattachments, tm stepresults, tm resulteditor, tm deleteresult, tm editresult, tm results, tm setresults, tm viewuntested
Miscellaneous: options