PI18495: LONG LICENSE ENVIRONMENT VARIABLE CAUSES IBM RATIONAL PRODUCT TO CRASH

Rational License Key Server Fix Pack 3 (8.1.4.3) for 8.1.4
Rational License Key Server Fix Pack 4 (8.1.4.4) for 8.1.4
Rational License Key Server Fix Pack 5 (8.1.4.5) for 8.1.4
Rational License Key Server Fix Pack 6 (8.1.4.6) for 8.1.4
Rational License Key Server Fix Pack 7 (8.1.4.7) for 8.1.4
Rational License Key Server Fix Pack 8 (8.1.4.8) for 8.1.4
Rational License Key Server Interim Fix 1 for 8.1.4.8
Rational License Key Server Administration and Reporting Tool Fix Pack 9 (8.1.4.9) for 8.1.4

APAR status

• Closed as program error.

Error description

• Attempts to run an IBM Rational Product with a long License
  Variable results "program termination" by the Operating System.
  
  
  ADDITONAL DESCRIPTION
  
  
  This can affect any IBM Rational Product. So far, this has been
  reported to affect the following:
  IBM Rational Rhapsody
  IBM Rational Publishing Engine
  
  
  
  SYMPTOM
  
  
  When you attempt to run the IBM Ratioanl Product, the program
  crashes with the error message '... application has stopped
  responding'.
  
  
  Results:
  
  
  The IBM Rational Product crashes before loading because
  Microsoft Windows Terminates the applliction.
  
  
  
  Steps to Reproduce:
  
  
  1. Install the Rational Product
  
  
  2. Set the Environment Variable (depending on Prodcut or
  Operating System this will be eihter LM_LICENSE_FILE or
  TELELOGIC_LICENSE_FILE) to the path of your license, and add
  additional paths until the length of the Value string is
  greater then 500 characters.
  
  
  3. Run the IBM Rational Product.
  
  
  CAUSE
  
  When the IBM Rational Product is waiting on the IBM Rational
  License Key Server to respond. The license variable is too long
  (greater than 500 characters) for IBM Ratioanl License Key
  Server.
  
  
  WORKAROUND
  
  
  Reduce the number of characters to be less than 500 in your
  Environment Variable (LM_LICENSE_FILE / TELELOGIC_LICENSE_FILE).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of Rational products that use environment variable     *
  * like TELELOGIC_LICENSE_FILE to point to the license server.  *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * If the value of environment variable TELELOGIC_LICENSE_FILE  *
  * is longer than 500 characters, then the application using    *
  * this environment variable may crash.                         *
  *                                                              *
  *                                                              *
  * As a workaround, customer can use the value of the           *
  * environment variable to shorter than 500 characters.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• RLKS 8.1.4.3 client library has the fix for this. Customer can
  now have environment variables with values of any length even
  larger than 500. To avail this fix, the Rational product needs
  to take the 8.1.4.3 licensing library.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  RATIONAL LICENS

• Fixed component ID

  5648LIC00

Applicable component levels

• R814 PSY

     UP