Download StarTeam® - Borland Technical Publications

5 Click Next. This action displays the New Project Wizard: Working Folder dialog.
6 In the Default Working Folder text box, enter or browse for the path to the working
folder you want to use as the root working folder for your project.
7 In the Archive Root Folder text box, enter or browse for the root path to the archive
folders. In your PVCS .cfg file, this is usually the first path name in the VCSDIR
directive.
For example, on a Windows system, suppose that you want the working folder for
your project to be C:\work and that you have the following VCSDIR directive in your
.cfg file:
VCSDIR = "c:\archives"; "c:\archives\pc"; "c:\archives\mac"; "c:\archives\unix"
All of these paths have “c:\archives” in common and at the beginning of the path.
Therefore, that would be the only correct choice for the archive root folder.
Also, if your paths contain spaces, they must be in quotation marks in the VCSDIR
directive. Some directives use wildcards.
Suppose that you have the following VCSDIR directive in your .cfg file:
VCSDIR = "c:\archives"; "archives\pc"; "archives\mac"; "archives\unix"
No valid archive root folder is possible, so you must change this directive.
“c:\archives” would not work because it is not at the beginning of each path. You
could use it, if you add c:\ to the paths that do not have c:\. You could use “\archives”
if you removed the c: from the path that starts with those characters.
When StarTeam creates working folders for each archive folder, it replaces the
archive root folder in each path in the VCSDIR directive with the path to the root
working folder.
If you have the following VCSDIR directive in your .cfg file:
VCSDIR="c:\archives";"c:\archives\pc";"c:\archives\mac";"c:\archives\unix"
the result is the following working folders: C:\work, C:\work\pc, C:\work\mac, and C:\
work\unix.
For the archive root folder on a Solaris system, you must use forward slashes (/)
and remember that names are case sensitive. Working folders also require
forward slashes.
Note
8 Click Finish to open the project.
After the wrapping process is finished, the PVCS files display in the file list with
Unknown status. You must update the status of these files on your workstation.
If any problems occur with the wrapping process, an error message asks you to check
the pvcs-err.locale.log file. If the problems in the pvcs-err.locale.log file are severe, you
can delete the project and re-wrap the PVCS archives.
Security Issues
When you use the Windows client to open a project that wraps PVCS archives, you are
asked to log onto PVCS when you perform an operation that accesses an archive.
If you access a PVCS archive from the Cross-Platform client, you will see a message
indicating that a logon failure has occurred unless the PVCS password is either blank
or the same as your StarTeam password.
If you access a PVCS archive from the View Comparison utility, you will see a logon
failure message. To rectify this problem, ruse the Windows client, open the wrapped
project view, press F6 and log on. Then you can return to the View Comparison utility.
Ch a p t er 1 4 : U s i ng S t a r T e a m w it h P V CS
235