TOC PREV NEXT INDEX DOC LIST MASTER INDEX




Version and Element Names

Note: The ClearCase related features described here are only available if the Apex/ClearCase Integration product has been installed and enabled.)

Many dialogs have fields which take controlled file objects as values. By default, these file objects must be identified by their filenames within some Apex view. Quite often, however, the controlled objects can also be identified by their full version names or by their element names. The form used is determined by a set of radio buttons.

Full Version Names

Fields that accept full version names are usually enabled by a radio button labeled "Versions". A full version name allows any version of an object to be referenced without the use of an Apex view. A full version name is a single line of the form

The items are separated by spaces. The <repository> is "ClearCase". It may be omitted to use the default repository for the subsystem or if the subsystem has only one repository. The <subsystem> is a pathname. The <element> is the relative pathname to the object (which is same for all views). The <history> is the name of the history (or ClearCase branch) containing the version. The <version> is the version number within the history (branch). In some dialogs, the <version> may be specified as "*" which is expanded to identify all versions of the element in the given history.

Element Names

In addition, some dialogs accept element names which are similar to full version names. Fields that accept an element name are usually enabled by a radio button labeled "Element". Element names are similar to full version names. An element specification consists of the following separate fields:

Subsystem


Repository and the pathname of the subsystem containing the element in the form:


Element


Relative path to any instance of the element, e.g., "utilities/sort_function.C".

(This path is the same for all Apex views)


History


Name of the history (or ClearCase branch) of interest.


Version


Version number in the history. In some cases, the version number field is not relevant and is omitted.



Rational Software Corporation 
http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX DOC LIST MASTER INDEX TECHNOTES APEX TIPS