Troubleshooting
Problem
This technote identifies an issue that can occur where an attempt to run a dbcheck on IBM Rational ClearCase (CC) version 7.1 fails with an unhandled exception.
Symptom
An attempt to run Dbcheck on ClearCase version 7.1 crashes with an Unhandled exception.
This issue occurs on all Windows architectures (32 and 64 bit).
Cause
This issue has been identified as a product defect under APAR PK78046.
Resolving The Problem
Defect APAR PK78046 has been resolved in ClearCase version 7.1.1.
WORKAROUND
Either of the following procedures can be used to workaround this issue.
Note: If you do not have access to a host running ClearCase 7.0.1 from which to copy the files referenced below, contact IBM Rational Client Support referencing this technote for further assistance.
- Copy the db directory of the .vbs (example: c:\vobstore\myvob.vbs\db) to a machine with a version of ClearCase prior to version 7.1 and run dbcheck there.
- dbcheck.exe relies on libatriant.dll, so if you take a copy of dbcheck.exe and libatriant.dll from a ClearCase 7.0.1.x machine placing them in a temporary directory, you are able to run dbcheck as seen in the example below.
Important Note: For this workaround to work correctly you must copy the 7.0.1.x dbcheck.exe and libatriant.dll files into a temporary directory that is NOT associated with the ClearCase install directory and then you need to issue the dbcheck command from within that temporary directory. This is necessary so that dbcheck uses these temporary files and doesn't try to call the 7.1 installed versions.
Example:
C:\temp\vdir_vob.vbs\db>ls -al v:\temp\701_dbcheck
total 185
drwxr-xr-x 1 vdir mkgroup_ 0 Jan 17 16:13 .
drwxr-xr-x 1 vdir mkgroup_ 0 Jan 17 16:06 ..
-rwxr-xr-x 1 vdir mkgroup_ 78926 Dec 12 2007 dbcheck.exe
-rwxr-xr-x 1 vdir mkgroup_ 109116 Dec 12 2007 libatriant.dll
C:\temp\vdir_vob.vbs\db>v:\temp\701_dbcheck\dbcheck.exe -a -k -p8096 vob_db
db_VISTA Version 3.20
Database Consistency Check Utility
Copyright (C) 1985-1990 Raima Corporation, All Rights Reserved
------------------------------------------------------------------------
Processing key file: vob_db.k01(1), total of 3 nodes
------------------------------------------------------------------------
Processing key file: vob_db.k02(2), total of 3 nodes
------------------------------------------------------------------------
Processing key file: vob_db.k03(5), total of 1 node
------------------------------------------------------------------------
Processing key file: vob_db.k04(6), total of 1 node
------------------------------------------------------------------------
Processing data file: vob_db.d01(0), total of 151 records
------------------------------------------------------------------------
Processing data file: vob_db.d02(3), total of 132 records
------------------------------------------------------------------------
Processing data file: vob_db.d03(4), total of 1 record
Database consistency check completed
0 errors were encountered in 0 records/nodes
Refer to the following technotes for further information about the dbcheck utility:
Technote 1203130 About the ClearCase database utility dbcheck
Technote 1122748 Running the ClearCase dbcheck utility
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21363980