Delta_SS

Delta_SS.exe extracts files from Microsoft Delta libraries and converts them to VSS internal format.

If you have projects saved in Delta, you can convert them to VSS. The Delta files themselves are not changed. You can convert entire Delta projects or individual Delta files. After the conversion, all of the files reside in a VSS project of the same name.

If you want to convert one or only a few files from Delta to VSS, you must run the Delta_SS.exe utility for each file. You can also use wildcard characters to match multiple files in a single project.

The file to be converted must not be locked or have "broken" status. To prevent inconsistent versions of files when multiple files are being converted, make sure the project is not in active use. You can use the Lock Project command in Delta to deactivate the project while you are converting it.

Delta_SS.exe requires the current version of VSS and installation of the Delta version 1.0 command-line tools. It also requires sufficient free disk space on the VSS destination drive to accommodate the new files: Approximately two times the disk space used by your Delta log files is required for working space and for the new files.

Note Before using Delta_SS.exe, back up your Delta project files and your VSS database.

To convert a single file or folder:

On the command-line, type Delta_SS -V -D [Delta project location] -P [Delta project name] -S [VSS location] -U [VSS password] [file | folder] [VSS project name].
For example:
```
Delta_SS -v -d c:\Delta -p ToolVer1 -s c:\SS -u drowssap File1.txt
```
This provides a verbose report of the conversion of File1.txt from Delta to VSS. Because no VSS project was specified, the converted file is placed in a project with the same name as the Delta project.

To convert an entire project:

On the command-line, type Delta_SS -V -R -D [Delta project location] -P [Delta project name] -S [VSS Project] -U [VSS password] [file | folder] [VSS project name].
For example:
```
Delta_SS –v -r -d c:\Delta -p ToolVer1 -s c:\SS -u drowssap
```
This converts the ToolVer1 project (and recursively, all of its subprojects) from Delta to VSS. This conversion includes complete history for each file.

Remarks

Only the VSS administrator can run the Delta_SS.exe. The -U option is used to specify the VSS administrator password, if one exists.

If you don't supply the VSS database location on the command line with the -S option, Delta_SS.exe determines the VSS location as follows:

If the SSDIR environment (operating system) variable is defined, then the specified location is used.
If the parent folder to the folder containing Delta_SS.exe contains SRCSAFE.INI, then that folder is used.
If the current folder contains SRCSAFE.INI, then the current folder is used.
If none of the above is found, Delta_SS.exe terminates with an error message.

The -R option converts all projects under the specified Delta project recursively.

The -P option specifying the VSS project name is not required. If it is not specified, Delta_SS.exe uses the Delta project name as the default. (The Delta project name must be specified with the -D option.)

Either -? or -H (from a Windows command line) can be used to get a listing of the Delta_SS.exe syntax.

After a successful conversion, the file(s) are placed into the named VSS project. If the destination project does not exist, it is created during the conversion. A log file (called Delta_SS.log) describing the conversion is created and placed in the folder in which VSS is installed.

Delta_SS.exe saves the entire history of each selected file by default. If you want to convert only the latest version, you can retrieve that version from Delta and add it to VSS manually using VSS's Add Files command.

Note You must specify the location of the source Delta master project folder. Delta_SS.exe does not operate on checked out Delta files in your working folder.