IBM Support

Dbcheck crashes with Unhandled exception in ClearCase 7.1



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.


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).


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.


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.

    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

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Utilities and Tools","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1;;","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018