C and C++ SoftBench User's Guide

Using SoftBench Configuration Manager
Creating a Default Symbolic Name for Archive Files
Chapter 3112
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.