IBM Support

PERL5LIB or PERLLIB can cause scripts to fail

Troubleshooting


Problem

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.

Symptom

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.

Cause

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.

WORKAROUNDS:

  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.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Environment Variables","Platform":[{"code":"PF033","label":"Windows"}],"Version":"2003.06.00;7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Environment Variables","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
29 September 2018

UID

swg21119507