HP UX SoftBench Software manual Creating a Default Symbolic Name for Archive Files, 112

Using SoftBench Configuration Manager

Creating a Default Symbolic Name for Archive Files

Creating a Default Symbolic Name for Archive Files

The mapping between a local directory and an archive specifies which revision of files you use. The default setting retrieves the latest revision of each file from the archive during file check out. The default also sets each file as the new, latest revision during check in. However, you can edit these settings to work with other file revisions by specifying a symbolic name list for a mapping.

A symbolic name is a special user-defined string (containing no white space characters) assigned to a particular file revision. A symbolic name list is a comma separated list of symbolic names with a special default revision specifier at the end. The special default revision specifier can be a symbolic name or it can be either a dash (-) or an asterisk (*), optionally followed by a number. Below is an example of valid symbolic name list:

Revision1_1,*DemoVersion,Revision1_1,-

Understanding Symbolic Names

After defining the symbolic name list, the active revision within the archive files is determined by the revision associated with that symbolic name. The symbolic name list also determines how files are created and checked back into the archive.

During Check Out

•If the first entry in the symbolic name list exists for a file, SoftBench CM returns that revision of the file.

•If the first entry does not exist, and the next entry exists for the file, SoftBench CM returns that revision of the file.

•If SoftBench CM reaches the end of the symbolic name list before it checks out the file and you did not include a special default entry specifier, an error occurs. If you included an (*) as the special default entry specifier, SoftBench CM checks out the latest file revision (default). If you included a (-) as the special default entry specifier, SoftBench CM does not check out the file, and no error occurs.

112 Chapter 3