Convert SourceSafe files to ClearCase/ClearCase LT elements
Product | Command Type |
---|---|
ClearCase | command |
ClearCase LT | command |
Platform |
---|
Windows |
clearexport_ssafe and clearimport allow you to copy SourceSafe files to a VOB. You can copy a single file, multiple files, or an entire project tree.
NOTE: Before using clearexport_ssafe, run analyze.exe. Resolve any problems detected by analyze.exe before proceeding with the export operation.
During the export stage, you invoke clearexport_ssafe while connected to any SourceSafe project. clearexport_ssafe creates a datafile (by default, cvt_data), and places in it the descriptions of elements and versions.
In the import stage, you invoke clearimport on the datafile. clearimport reads the descriptions in the datafile and imports the information into the VOB.
clearexport_ssafe converts each SourceSafe label into a ClearCase or ClearCase LT version label. clearexport_ssafe creates separate elements for each SourceSafe file. You can specify a translation file to control naming of labels, enforcing consistency over multiple invocations of the command. You can use the -V option to preserve SourceSafe version numbers as attributes of the corresponding ClearCase/ClearCase LT versions.
NOTE: clearexport_ssafe and clearimport use magic files to determine which element type should be used for each element clearimport creates. For more information on magic files and file typing, see the cc.magic reference page.
NOTE: clearexport_ssafe uses the value of the TMP environment variable as the directory for temporary files.
clearexport_ssafe issues warning messages when it encounters checked-out SourceSafe files, but still processes the files.
For clearexport_ssafe to work, the SourceSafe command-line executable, ss.exe, must be in your PATH environment variable. ss.exe must work without prompting you for a user name and password. To prevent prompting, you might need to use a SourceSafe user name that matches your domain login user name, or you might need to set the SSUSER environment variable and set the corresponding password to blank, or no password.
During import, clearimport invokes a shell to extract data from the datafile. clearimport can handle some, but not all, characters that are special to shells. The import fails for any filename that includes any of these characters:
` ' " <Tab> [ ] ? * %
Succeeds | Fails |
---|---|
foo&bar |
foo?bar |
$MY_LIB |
yellow`sunset |
Before running clearexport_ssafe, rename any filename that contains these characters.
Renaming of SourceSafe labels can introduce inconsistencies over multiple runs of clearexport_ssafe. The same label might be renamed during processing of some SourceSafe files, but remain unchanged during processing of other files. You can enforce consistency by using the same translation file in multiple invocations of clearexport_ssafe. If you name such a file (using the -T option), clearexport_ssafe uses it to:
Look up each SourceSafe label to determine how to translate it to a ClearCase/ClearCase LT label type. If a match is found, clearexport_ssafe translates the label the same way.
Record each translation of a new SourceSafe label for use in future lookups.
The first time you use clearexport_ssafe, use -T to create a new translation file. On subsequent invocations of clearexport_ssafe, use -T again and specify the same translation file, for consistent name translation.
The translation file consists of one or more lines in the following form:
label old-name new-name
For example, to rename the label BL1.7 to IMPORT_BASE and the label BL2 to IMPORT_BASE2, the translation file would be:
label BL1.7 IMPORT_BASE
label BL2 IMPORT_BASE2
No blank lines are allowed in the file.
clearexport_ssafe does not preserve shares as hard links during conversion. Instead, shares become separate elements.
clearexport_ssafe converts a SourceSafe label into a ClearCase/ClearCase LT label with the same name.
NOTE: Labels on SourceSafe directories are not exported.
clearexport_ssafe does not convert SourceSafe branches to ClearCase/ClearCase LT branches. Instead, clearexport_ssafe creates separate elements.
clearexport_ssafe translates SourceSafe pins to ClearCase/ClearCase LT version labels named PINNED.
SourceSafe lets you assign the NO DELTAS attribute to elements, which directs SourceSafe to keep only the current version of the element. SourceSafe keeps a history of all versions, but the contents of only the current version. clearexport_ssafe creates an empty version for each of the previous versions of the element, and a version with contents for the current version. Because ClearCase and ClearCase LT do not include a feature comparable to NODELTAS, when you create new versions of the element, the previous versions and their contents are stored. You can, however, use the rmver -data command to remove a version's contents.
When clearexport_ssafe encounters a file or directory that cannot be exported (for example, a file with format problems, or a broken symbolic link), it prints an error and continues. After creating the data file, the command prints a summary of the files and directories that could not be exported.
HANDLING OF DIRECTORY ARGUMENTS. clearexport_ssafe processes the files in your SourceSafe current project. You cannot specify a pathname with the source-name argument.
SELECTIVE CONVERSION OF FILES. Default: clearexport_ssafe processes all files it encounters.
|
|
|
|
-I now. The time is specified in one of the following formats:date | := | day-of-week | long-date |
time | := | h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ] |
day-of-week | := | today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat |
long-date | := | d[d]-month[-[yy]yy] |
month | := | January |... |December |Jan |... |Dec |
00:00:00
. If you omit the date, it defaults to today. If you omit the century, year, or a specific date, the most recent one is used. Specify UTC if you want to resolve the time to the same moment in time regardless of time zone. Use the plus (+) or minus (-) operator to specify a positive or negative offset to the UTC time. If you specify UTC without hour or minute offsets, it defaults to Greenwich Mean Time (GMT). (Dates before January 1, 1970 Universal Coordinated Time (UTC) are invalid.) PRESERVATION OF SOURCESAFE INFORMATION AS ATTRIBUTES. Default: clearexport_ssafe does not attach attributes to versions exported from SourceSafe versions.
CREATING NEW VERSIONS ON A BRANCH. Default: clearimport creates new versions of a file or directory element on the element's main branch.
TRANSLATION OF LABELS. Default: clearexport_ssafe may automatically rename a label type to avoid naming conflicts.
STORAGE LOCATION OF DATAFILE. Default: clearexport_ssafe creates the datafile cvt_data in the current working directory.
SPECIFYING FILES TO BE EXPORTED. Default: The SourceSafe current project (equivalent to specifying "."as the source-name argument). clearexport_ssafe processes each SourceSafe file in the current project, and creates a directory element for each subproject of the current project.
|
---|
|
Create entries in the datafile for the elements in the current project, processing important versions created before 1999 and all versions created since the beginning of 1999.
c:\>
clearexport_ssafe -r -I 1-Jan-1999
Create entries in the datafile for the elements in the current project, but not in any subprojects; store the datafile in a file named newcvt.
c:\>
clearexport_ssafe -o newcvt .
In SourceSafe, display your SourceSafe current project.
c:\>
ss cp
In SourceSafe, list the contents of your SourceSafe current project.
c:\>
ss dir
clearexport_*, clearimport, events_ccase, relocate
Feedback on the documentation in this site? We welcome any comments!
Copyright © 2001 by Rational Software Corporation. All rights reserved. |