PK14303: AFTER MAINTENANCE UPGRADE THAT INCLUDED PK05511 OR PK05514 SETUPCMDLINE.SH WAS CORRUPTED.

 A fix is available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
After maintenance upgrade that included 
PK05511 (W502032) or

PK05514 (W510215), setupCmdLine.sh was corrupted during
applyPTF.sh execution.  This resulted in applyPTF.sh failure.
The above apars modified setupCmdLine.sh.  If customers
hand-edited setupCmdLine.sh before maintenance, this problem
may surface.  In this situation, the customer had the following
lines as comments in setupCmdLine.sh:

 #STEPLIB='SYS2.WEBS.WAS.W502008.SBBOLD2':$STEPLIB
 #STEPLIB='SYS2.WEBS.WAS.W502008.SBBOLOAD':$STEPLIB
 #STEPLIB='SYS2.WEBS.WAS.W502008.SBBOLPA':$STEPLIB
 #export STEPLIB

The script for updating setupCmdLine.sh was not designed to
handle commented out STEPLIB statements.  This lead to file
corruption.

This apar is opened in order to change how customers can update
setupCmdLine.sh to avoid future problems similar to this one.
Local fix
If the STEPLIB entries in this file are no longer needed, they
should be deleted, not commented out.
The structure of this file should not be changed.  Note, the
file is first generated during WAS customization through ISPF
panels.  At that time, there is an option to specify where WAS
modules will be located and setupCmdLine.sh is updated
automatically at that time.  If dataset names change after
upgrade, only dataset names should be modified in this file.

Note, doc apar 
PK14154 will correct InfoCenter and add more
details on when and how to update setupCmdLine.sh.

If you notice setupCmdLine.sh is corrupted, contact WebSphere
support and send corrupted file.
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V5.0 for z/OS                                *
****************************************************************
* PROBLEM DESCRIPTION: After maintenance upgrade that          *
*                      included 
PK05511 (W502032) or           *
*                      
PK05514 (W510215), setupCmdLine.sh may  *
*                      contain syntax errors after the Post    *
*                      Installer execution.                    *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
If the user hand-edited the setupCmdLine.sh and commented out
the first occurence of STEPLIB, the Post Installer will not
correctly apply the action for 
PK05511.  If startServer.sh
is run after that, they will get an error similar to the
following:
  ./startServer.sh 55: FSUM7332 syntax error: got fi,
   expecting Newline
Problem conclusion
Update setupCmdLine.sh to include a warning that hand editing
it may prohibit the Post Installer from being able to properly
update it when applying Post Install service.

APAR PK14303 is currently targeted for inclusion in SERVICE
LEVEL W502039 of WebSphere Application Server V5.0 for z/OS.
Temporary fix Comments
APAR information
APAR number PK14303
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-10-31
Closed date 2006-02-12
Last modified date 2006-04-05

APAR is sysrouted FROM one or more of the following:

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

Modules/Macros
BBOUBINF          

Publications Referenced

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

Applicable component levels
R500 PSY UK12774    UP06/03/24 P F603

  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: swg1PK14303.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 #: PK14303
IBM Group: Software Group
Modified date: Apr 5, 2006