IBM Support

PERL5LIB or PERLLIB can cause scripts to fail

Technote (troubleshooting)


Setting the PERL5LIB or PERLLIB environment variables before executing any of the IBM® Rational® ClearCase® or ClearCase MultiSite® perl scripts may cause the script to fail.


Setting the environment variables PERL5LIB or PERLLIB in the environment from which ClearCase processes are run, may result in run-time errors having to do with the ClearCase Perl interpreter finding the wrong versions of Perl modules.

Example from From the Windows Application Event Viewer log:

Application popup: ratlperl.exe - Unable To Locate Component : This
application has failed to start because perl58.dll was not found.  
Re-installing the application may fix this problem.


This conflict can be introduced by any application or database that sets the PERL5LIB or PERLLIB environment variables (such as Oracle 10g).

This is being investigated as defect APAR IC39617.

Resolving the problem

The decision was made by Product Management to exclude the resolution of this defect from future upgrades and releases due to the significant architectural changes required to implement the solution.


  1. Un-set the environment variables before running any Rational ClearCase or MultiSite scripts.

  2. Add "C:\Program Files\Rational\Common" to the PERL5LIB environment variable.

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearCase Environment Variables

Document information

More support for: Rational ClearCase
Environment Variables

Software version: 7.0, 2003.06.00

Operating system(s): Windows

Reference #: 1119507

Modified date: 09 January 2008