DOCUMENT:Q153872 04-MAY-2001 [ssafe] TITLE :INFO: DDConv Messages of Visual SourceSafe 4.0 PRODUCT :Microsoft SourceSafe PROD/VER: OPER/SYS: KEYWORDS:kbsetup kbSSafe400 kbSSafe500 kbSSafe600 ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft Visual SourceSafe for Windows, versions 4.0a, 5.0, 6.0 - Microsoft Visual SourceSafe, 16-bit, for Windows, version 4.0 - Microsoft Visual SourceSafe, 32-bit, for Windows 4.0 - Microsoft Visual SourceSafe for Macintosh, versions 4.0a, 5.0 ------------------------------------------------------------------------------- SUMMARY ======= Ddconv.exe is the utility that converts a SourceSafe 3.x database to 4.0, 4.0a, or 5.0 format. The setup process automatically runs it when you upgrade. When run, it puts a log file called ddcerr.log in the DATA subdirectory. This file lets the user know what has happened during the conversion. MORE INFORMATION ================ The ideal ddcerr.log file has only the following ten lines in it: DDCONV initializing Creating subfolders Moving files Creating rights DB Building project list Creating names DB Converting log files Adding project rights Converting users DDCONV finished The following conventions are used in the messages below: is the file in the DATA directory without an extension, such as BKAAAAAA. is the file in the DATA directory with an extension of .A or .B, such as BKAAAAAA.a. is the name of the project in the Visual SourceSafe interface, such as $/MyProject/Sub-Project. is the name of the file in the Visual SourceSafe interface,such as MyFile.txt # is a number, such as 1. How To Identify a File from its Physical Log File Name ------------------------------------------------------ You can open the physical log file in a text editor and look at the non- garbage characters. On the first line, the name of the file/project is written. Later in the file you might see a reference to a project that this file or project is in. Don't write anything to this file!! The following four messages may appear in the file and can be considered harmless: parent project not found, skipping parent record. Parent count in old DB #, correcting to actual count #. Project entry count in old DB #, correcting to actual count #. Format record, invalid, correcting. If the following messages appear in the file, the conversion process did not successfully convert every file in the DATA directory: Error converting header in logfile . This file was not able to be converted because of corruption in the header of the file. If the file is needed, recover the 3.1 database, then fix it and retry the conversion. Be sure you have run the 3.1 analyze on the 3.1 database. If the file is not needed, move the log file and the data file (BKAAAAAA and BKAAAAAA.a) out of the DATA directory, and run the new analyze with the -F switch to clean up the links to the file. This may take more than one run of analyze -F . For more information, please see the following article in the Microsoft Knowledge Base: Q190881 SAMPLE: Analyze6.exe Utility for Visual SourceSafe Unable to open project . Unable to open file . The file was locked when the conversion process was running. Unlock the file at the operating system level and re-run ddconv on the half-converted database. You don't have to recover the 3.1 data. File not found. File not found. The file mentioned is not found in the data subdirectory. You need to determine what file this is referring to and decide whether you need it or not. If you need it, and it is a physical log file, you have to go to backups. If it is the physical data file name of a project, you can run the new analyze -F on it. This may take more than one run of analyze -F . If it is the physical data file of a file, then you need to recover from backups or someone's working directory. However, it should be noted that there is no guarantee that the recovered copy is the correct one. Having the incorrect one would mean that all previous versions of the file would be retrieved incorrectly. Error converting project entry records in file . Run the new analyze -F to clean up. You may need to run it several times. Eliminating duplicate name in child list. This message occurs when there is an active file/project with the same name as a deleted file. Ideally, the 3.1 database would be recovered, and then either the deleted file would be purged or the active file would be renamed. And then ddconv would be run on the 3.1 data again. Otherwise, the new analyze can be run with the -F switch on the database which may be able to re-establish the links, but it might have to be run several times. Cannot find physical project file for . This message occurs when there is an active project with the same name as a deleted project. Ideally, the 3.1 database would be recovered, and then either the deleted project would be purged or the active project would be renamed. And then ddconv would be run on the data again. Otherwise the new analyze can be run with the -F switch on the database which may be able to re-establish the links, but it might have to be run several times. Error writing to file. This message occurs because ddconv could not upgrade the file. Frequent reasons for this are: There is an operating system lock on the file. Remove it and re-run ddconv on the half converted database. The file is zero byte count. Recover from backup. Or if it is both the log file and the data file (BKAAAAAA and BKAAAAAA.a) are zero byte count, move the files out of the DATA directory, and then run the new analyze with the -F switch to remove the links. Analyze -F might have to be run several times to clear up the links. Too Many File Handles open. Another process in memory is affected the conversion process. Remove the TSR from memory or close the application. Additional query words: ====================================================================== Keywords : kbsetup kbSSafe400 kbSSafe500 kbSSafe600 Technology : kbHWMAC kbOSMAC kbSSafeSearch kbAudDeveloper kbSSafe600 kbSSafe400 kbSSafe400a kbSSafe500 kbSSafe16bitSearch kbSSafe32bitSearch Issue type : kbinfo ============================================================================= THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY. Copyright Microsoft Corporation 2001.