PK05511: REPEATED CALLS TO SETUPCMDLINE.SH RESULTED IN A LARGE STEPLIB ENVVAR THAT CONTAINED THE SAME LOAD DATASETS, MULTIPLE TIMES.

 A fix is available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
During the upgrade and when the STEPLIB was needed, the script
setupCmdLine.sh could be invoked several times by the applyPTF
script and other tasks (backoutPTF, individual fixes) . However,
each time a same set of STEPLIB datasets was added to the
STEPLIB environment variable; e.g.,
  STEPLIB='SYMPL.WAS##SS1.SBBOLD2':$STEPLIB
  STEPLIB='SYMPP.WAS##SS1.SBBOLOAD':$STEPLIB
  STEPLIB='SYMPP.WAS##SS1.SBBOLPA':$STEPLIB
  export STEPLIB

At the time of error (dll not found), the STEPLIB envvar was
seen to contain:
  SYMPP.WAS##SS1.SBBOLPA:SYMPP.WAS##SS1.SBBOLOAD:SYMPL.WAS##SS1.
  SBBOLD2:SYMPP.WAS##SS1.SBBOLPA:SYMPP.WAS##SS1.SBBOLOAD:SYMPL.W
  AS##SS1.SBBOLD2:SYMPP.WAS##SS1.SBBOLPA:SYMPP.WAS##SS1.SBBOLOAD
  :SYMPL.WAS##SS1.SBBOLD2:SYMPP.WAS##SS1.SBBOLPA:SYMPP.WAS##SS1.
  SBBOLOAD:SYMPL.WAS##SS1.SBBOLD2:
This made the STEPLIB variable too large ( > 256 chars; allowed
by APAR 
OA09774) to be propagated correctly;  Although 
OA09774
will allow a STEPLIB envvar again to be larger than 256
characters, a possibility still remains that the repeated calls
to setupCmdLine.sh by multiple tasks will expand the STEPLIB
envvar beyond yet another length limit.

The customization wizard should add a check in setupCmdLine.sh
so that STEPLIB is only updated once for WebSphere.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V5.0 for z/OS                                *
****************************************************************
* PROBLEM DESCRIPTION: The setupCmdLine.sh could be invoked    *
*                      several times by shell scripts. On      *
*                      each invocation, the STEPLIB variable   *
*                      gets appended with the same             *
*                      information.  Eventually, the STEPLIB   *
*                      variable grows bigger than 256          *
*                      characters and caused                   *
*                      'could not load dll' errors because     *
*                      the data set is no longer visible on    *
*                      the STEPLIB.                            *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
When the STEPLIB variable grows bigger than 256 characters,
it could cause errors like the following:

Could not load dll :
/data/WebSphere/wxvcell/config.dm/DeploymentManager/lib
   /libbboorb.so
:EDC5157I An internal error has occurred.
Could not load dll :
/data/WebSphere/wxvcell/config.dm/DeploymentManager/lib
  /libbboorb.so
:EDC5157I An internal error has occurred.
...
Problem conclusion
setupCmdLine.sh will be updated so that STEPLIB will not be
included multiple times even when it is invoked multiple times.

APAR PK05511 is associated with SERVICE LEVEL W502032 of
WebSphere Application Server V5.0 for z/OS.
Temporary fix Comments
APAR information
APAR number PK05511
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 500
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2005-05-09
Closed date 2005-07-25
Last modified date 2006-02-28

APAR is sysrouted FROM one or more of the following:

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

Modules/Macros
BBOUBINF          

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSY UK05697    UP05/07/29 P F507

  Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.


Document Information


Current web document: swg1PK05511.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 500
Software edition:
Reference #: PK05511
IBM Group: Software Group
Modified date: Feb 28, 2006