PI62701: RCLEARTOOL REQUIRES THE WEBSPHERE APPLICATION SERVER COOKIE HAVING THE NAME "JSESSIONID"

Rational ClearCase Fix Pack 12 (8.0.1.12) for 8.0.1
Rational ClearCase Fix Pack 2 (9.0.0.2) for 9.0
Rational ClearCase Fix Pack 13 (8.0.1.13) for 8.0.1
Rational ClearCase Fix Pack 3 (9.0.0.3) for 9.0
Rational ClearCase Fix Pack 14 (8.0.1.14) for 8.0.1
Rational ClearCase Fix Pack 4 (9.0.0.4) for 9.0
Rational ClearCase Fix Pack 15 (8.0.1.15) for 8.0.1
Rational ClearCase Fix Pack 5 (9.0.0.5) for 9.0
Rational ClearCase Fix Pack 6 (9.0.0.6) for 9.0
Rational ClearCase Fix Pack 16 (8.0.1.16) for 8.0.1
Rational ClearCase Fix Pack 17 (8.0.1.17) for 8.0.1
Rational ClearCase Fix Pack 18 (8.0.1.18) for 8.0.1
Rational ClearCase Fix Pack 19 (8.0.1.19) for 8.0.1
Rational ClearCase Fix Pack 20 (8.0.1.20) for 8.0.1
Rational ClearCase Fix Pack 21 (8.0.1.21) for 8.0.1
Rational ClearCase Fix Pack 22 (8.0.1.22) for 8.0.1
Rational ClearCase Fix Pack 23 (8.0.1.23) for 8.0.1
Rational ClearCase Fix Pack 24 (8.0.1.24) for 8.0.1
Rational ClearCase Fix Pack 25 (8.0.1.25) for 8.0.1

APAR status

• Closed as program error.

Error description

• Changing the name of the the Websphere Application server cookie
  to anything other than "JSESSIONID" will cause CMAPI or
  rcleartool to throw this Java error and be unusable:
  
  Exception in thread "main" java.lang.NullPointerException
          at java.util.Hashtable.put(Hashtable.java:877)
          at java.util.Properties.setProperty(Properties.java:681)
          at
  com.ibm.rational.ccrc.cli.util.CliPreference.setValue(CliPrefere
  nce.java:521)
          at
  com.ibm.rational.ccrc.cli.authentication.SessionRegistry.registe
  rSession(SessionRegistry.java:105)
          at
  com.ibm.rational.ccrc.cli.authentication.CliAuthenticationCallba
  ck.notifyAuthenticated(CliAuthenticationCallback.java:227)
          at
  com.ibm.rational.stp.client.internal.cc.CcProviderImpl.doLogin(C
  cProviderImpl.java:1150)
          at
  com.ibm.rational.stp.client.internal.cc.CcNetworkProviderImpl.do
  Login(CcNetworkProviderImpl.java:275)
          at
  com.ibm.rational.stp.client.internal.cc.CcNetworkProviderImpl.at
  temptLogin(CcNetworkProviderImpl.java:400)
          at
  com.ibm.rational.stp.client.internal.cc.CcNetworkProviderImpl.do
  CreateCcrcSession(CcNetworkProviderImpl.java:268)
          at
  com.ibm.rational.ccrc.cli.authentication.CliWebProviderImpl.doCr
  eateCcrcSession(CliWebProviderImpl.java:118)
          at
  com.ibm.rational.stp.client.internal.cc.CcProviderImpl.getCcrcSe
  ssion(CcProviderImpl.java:1080)
          at
  com.ibm.rational.stp.client.internal.cc.CcResourceImpl.doReadPro
  pertiesRemote(CcResourceImpl.java:392)
          at
  com.ibm.rational.stp.client.internal.cc.CcResourceImpl.doReadPro
  perties(CcResourceImpl.java:421)
          at
  com.ibm.rational.stp.client.internal.cc.CcResourceImpl.doReadPro
  perties(CcResourceImpl.java:1096)
          at
  com.ibm.rational.stp.client.internal.cc.CcProviderImpl.doGetDefa
  ultCcRegistryRegion(CcProviderImpl.java:746)
          at
  com.ibm.rational.ccrc.cli.authentication.CliAuth.getCcProvider(C
  liAuth.java:361)
          at
  com.ibm.rational.ccrc.cli.command.Login.execute(Login.java:189)
          at
  com.ibm.rational.ccrc.cli.core.Command.run(Command.java:145)
          at
  com.ibm.rational.ccrc.cli.core.CommandProcessor.runCommand(Comma
  ndProcessor.java:199)
          at
  com.ibm.rational.ccrc.cli.core.CommandProcessor.runInInteractive
  Mode(CommandProcessor.java:163)
          at
  com.ibm.rational.ccrc.cli.core.CommandProcessor.processRCleartoo
  lArgs(CommandProcessor.java:82)
          at
  com.ibm.rational.ccrc.cli.core.CommandProcessor.processRCleartoo
  lArgs(CommandProcessor.java:38)
          at
  com.ibm.rational.ccrc.cli.RCleartool.main(RCleartool.java:46)
  
  
  This does not affect the CM API,  ClearTeam Explorer or
  ClearCase Remote
  Client GUIs.
  

Local fix

• In the Websphere application Server admin console, change the
  cookie to have the name "JSESSIONID"
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of rcleartool.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Changing the name of the the Websphere Application server    *
  * cookie to anything other than "JSESSIONID" will cause CMAPI  *
  * or rcleartool to throw a Java error and be unusable.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• A fix is available in ClearCase versions 8.0.1.12 and 9.0.0.2
  

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

  CLEARCASE WIN

• Fixed component ID

  5724G2900

Applicable component levels

• R801 PSY

     UP

• R900 PSY

     UP