vspacer
 
vspacer
 

ssxco

 

Purpose The program is useful for cleanup when users leave with files left checked out and for chasing up anti-social users who have had files checked out for ever.

The program lists all files currently checked out, and who has them checked out. Files checked out to users who are not in the user table are highlighted. A summary is printed of these users.

The 'x' version now runs directly against the SourceSafe database (the previous 'ssco' utility was a wrapper around the ss status command). The 'x' version eliminates name truncation problems inherent in the wrapper approach. File names are now reported in full.

SS Tested with SourceSafe V5.0 V6.0.
OS Windows NT/2K/XP Command line utility.
Usage ssxco [Path_To_Vss_Data] {options for ss undocheckout}
Outputs #1 This report is displayed and written to ssxco.txt :
ssxco v2.08    SourceSafe Checked Out Files list          Sun Jun 12 18:04:53 2005
[N] indicates user is not in the current user list [N] User Logon Date D Project/File Name
Jembry 9/11/00 $/Admin/PR/printmedia/080200.doc [N] Achase 1/05/00 $/Engineering/Drafts/kth_proposal.dsc [N] Achase 1/11/00 $/Engineering/Specs/Formats/logic.xls Sjones 3/20/00 $/Production/MultiSlide/Job484_settings.cad Sjones 3/20/00 $/Production/Multislide/Job865.ce [N] Stolbert 4/07/99 $/Reports/Plans/Daily/040499.doc Sjones 6/08/00 $/Reports/Production/042000_tracking.doc Hkutznitov 3/01/00 $/Stats/Projects/Operations.xls
Users not in the user list with files checked out! [N] Achase 2 [N] Stolbert 1
#2 The program also writes a batch file unco.bat.

rem  ssxco v2.08    SourceSafe Undocheckout batch file          Sun Jun 12 18:04:53 2005
rem  Database : C:\Applications\Visual SourceSafe 5.0\data
ss undocheckout "$/Engineering/Drafts/kth_proposal.dsc" -YAchase,temp ss undocheckout "$/Engineering/Specs/Formats/logic.xls" -YAchase,temp ss undocheckout "$/Reports/Plans/Daily/040499.doc" -YStolbert,temp
To use it, use the ssadmin tool to (temporarily) reinstate the user account, set the password to 'temp', and give the user rights to the directories.

 
Notes 1. The program now allows you to specify a string e.g : "-I-Y -G-". If you supply it, it will be written to the unco.bat file.
For example:
ss undocheckout "$/Altlasten HBU DBU STA3/drbohms.xls" -I-Y -G- -YKrausep,temp
This will allow you to handle situations where sourcesafe requires a prompt such as : 'drbohms.xls has changed. Undo check out and lose changes?(Y/N)

The program will identify (with a 'D') duplicate files in the same project (yes, it can happen). If this situation occurs only the first file will be unchecked out. You will have to hand process the rest.

Percent (%) signs in file names are output to the batch file doubled to ensure proper processing. Reference Microsoft article 75634.

I recommend that administrators set guidelines for users that disallow the use of percent (%) signs in file names. Certain characters interfere with DOS operations. The most likely ones to cause problems are the dollar sign, percent sign, at sign, and the tilde. (See also ssxphysical note).

2. If no checked out files are found, this message is displayed:
'No checked out files were found.
 This could be the case if the database has had no activity.
 It could also be the case that :
 - Data_Path in srcsafe.ini in the SourceSafe installation ..vss\data tree
   does not point to the sourcesafe database :
   e.g Data_Path = j:\test\databases\minibase\data
 OR
 - You are running InterDev and Data_Path in the SrcSafe.ini in the
   Web Server does not point to the SourceSafe database
Credits 1. Thanks to Joerg Brandes of de.transport.bombardier.com, Berlin, for suggesting this feature and for providing extensive beta site testing and helpful feedback during the development of the 'x' version.

2. Thanks to Mauro Ciaccio of mpt-ltd.com for suggesting this update.
Installation Copy the program into the directory where you want to run it. It's stand-alone and requires no configuration or support.
Download ssxco 2.08 (41 KB)

   


Back to top | ZDS Home | This article updated June 12, 2005.