Terminology


Configuration Record (CR)

A ClearCase concept, documented in the clearmake and config_record man pages.

It is in short a "software bill-of-materials" that fully documents a build and supports re-buildability.
It lists the versions of every configuration item used, as well as the textual rule which was run to produce the derived object(s), to which it is attached.
Note that it requires a DO to be attached to: otherwise, the CR is lost.


Derived Object (DO)

A ClearCase concept, documented among other in the derived_object man page.

In short, it is a file built by clearmake or clearaudit, with an associated configuration record.

A DO can only exist within a VOB (whether the data is stored in a VOB's pool or in some view).

DOs produced by clearmake may be winked-in, instead of being reproduced, under certain circumstances, and as the result of a configuration lookup.

DOs may be checked-in themselves. This relates to several issues, e.g. concerning possible interferences with the configuration lookup.


Parallel and Distributed Building

This is described in the man page for clearmake. It covers in short: the execution of several build scripts concurrently and the use of one or more remote hosts to execute build scripts.


Pseudo-target

This term is used in [CCUM, 10.1, p 150; CCUM3, 17.2, p 259].
It is however used there in an ambiguous case, related to recursive invocation of clearmake, and thus to the distinct concept of remote target.

A pseudo-target is a target which is not associated with a DO, therefore has no CR, and is always built. Targets depending on it are thus always built as well.

Trivial and common examples of pseudo-targets are the customary all and clean targets.


Staging VOB

This is a concept used in ClearCase documentation (So was I told, but I couldn't find any mention myself in [CC-UM]. At least, there is none in the electronic documentation).

An other slightly conflicting use is made in a paper mentioned in the clearcase mailing list, of which we have a local copy.

We understand by staging VOB a VOB where to produce DOs, without checking them in there (this is the main difference with the acception in the above mentioned paper).


SCM96 tasks, installation, makefile, [CCUM2] ClearCase User's Manual Rel 2, [CCUM3] ClearCase User's Manual Rel 3
Marc Girod
Last modified: Thu May 13 12:17:06 EEST 2004