Work area reference forms

A work area reference form is an absolute or relative path within the maintain work area of a project.

Rational® Synergy supports the following forms:

  1. path

    For example: C:\ccm_wa\mydb\myproject-1\myproject\example.txt

  2. path versionDelimiter version

    For example: C:\ccm_wa\mydb\myproject-1\myproject\example.txt-2

  3. path:version

    For example: C:\ccm_wa\mydb\myproject-1\myproject\example.txt:2

The first two forms can be ambiguous. For example, the specification "a-file-1" can mean a file named "a-file-1" with the version used in that project, or version "1" of a file named "a-file" in the current working directory, or version "file-1" (which would be invalid by default) of a file named "a" in the current working directory.

When referring to existing objects, if the third form is not specified, Rational Synergy first looks for an object whose name matches. In the previous example, it looks for an object named "a- file-1" in the project. If no such object is found, the rightmost version delimiter is used to separate the last part of the path into a name and version. In the above example, it looks for a file named "a-file" and version "1" of that object.

When creating new files and directories, the new name is always treated as a name including any version delimiter. For example, ccm create a-file always creates an object named "a-file". To create a file named "a" and version "file", use the ccm create a:file command or the ccm create a -v file command.


Feedback