where 

Use

Lists the workspaces in which a certain version or one of its successors has been integrated. One example to motivate this command: you are developing a project inside multiple code lines and the code lines are maintained on multiple Design Time Repository (DTR) servers. You perform a bug fix on a file in a certain code line. Therefore you create version 3 of the file and changed line 10. Some months later, you added a new feature in the same code line by creating version 4 of the same file and adding lines 95-100. The bug fix and the feature are transported to multiple code lines/DTR servers through forward and backward transports. To some code lines only version 3 is transported, to other code lines only version 4. Other code lines receive both or none of these versions. Now comes the important question: which code lines contain the initial bug fix? It is not sufficient to search the code lines in which version 3 was integrated. Even code lines which received only version 4 contain the bug fix.

The WHERE command answers this question by allowing you to search in multiple DTR-servers (sessions) for workspaces containing a certain version or any of its successors.

Syntax

Syntax	where [-version|v ...] [-vcr ...] [-sessions|s ...]
Options
-version|-v	The path to the version which should be inspected.
-vcr	The path to the VCR which currently checked-in version should be inspected.
-sessions|-s	The sessions which should be searched for successors.
Description	Lists the workspaces in which a certain version or one of its successors has been integrated.

Example

To search for all workspaces in dtr1, dtr2 and dtr3 containing at least the version of Test.java which can be found in /ws/test.

where -sessions dtr1,dtr2,dtr3 -vcr /ws/test/.../Test.java