PRB: ANALYZE Error "Unable To Create the Filemapping..."

Article ID: Q159283
Creation Date: 12-NOV-1996
Revision Date: 14-NOV-1996

The information in this article applies to:

Microsoft Visual SourceSafe, 32-bit, for Windows, versions 4.0, 4.0a, 5.0 on the following platform: x86

SYMPTOMS

When you run ANALYZE on a database, you receive the following error message in the ANALYZE window:

   Unable to create the filemapping for the database <data_path>

CAUSE

During the first pass, ANALYZE creates a project map and a file map. ANALYZE finds the largest file number in the database and maps enough memory for each possible file in the database. ANALYZE does not check the actual number of files that exist, instead it assumes that there is a file in every location.

For example, if there are two files in the database ($/ and $/Project1) where $/ = file number 0 and $/Project1 = file number 999, ANALYZE will map enough memory for 1000 possible files (counting from the base index of 0).

SourceSafe is confused by files that break the internal SourceSafe file limit (for example, Tempmail). SourceSafe can store about four billion files. However, because of SourceSafe's file numbering scheme, the above Tempmail file exceeds that limit. As a result, ANALYZE tries to allocate the amount of memory needed (number of files * 4 bytes), or about 4GB to 5GB of RAM, to process the file list. At this point ANALYZE fails and the error "Unable to create the filemapping for the database <data_path>" appears.

RESOLUTION

The SSARC and SSRESTOR utilities that are included with Visual SourceSafe 5.0 resolve the problem. The process of archiving and restoring projects causes SourceSafe to re-create the physical file names in the database sequentially, starting with the lowest available number, so that any files that have exceeeded the limit will be renamed.

STATUS

This behavior is by design.

KBCategory: kbprg kbprb
KBSubcategory: ssdb
Additional reference words: 4.00 4.00a 5.00 kbdss

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.