PK77758: UPDATE CUSTOMIZATION DIALOGUE INSTRUCTIONS TO INDICATE REGION CONSTRAINTS CAN LIMIT REGION SIZE OF CUSTOMIZATION SCRIPTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Add information to customization dialogue instructions regarding
  region constraints that may limit successful execution of
  shell scripts that are created by the generated jobs.
  

Local fix

• If a region constraint is limiting a script from completing
  successfully. Identify hich region constraint is limiting the
  region.
  
  Some examples are:
  MAXASSIZE, ASSIZEMAX for user, IEFUSI/JES2/JES3 exit)
  
  Increase the region constraint to allow script to run.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of WebSphere Application Server   *
  *                  V7.0 for z/OS                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: The instructions generated by the zPMT  *
  *                      within within the WebSphere             *
  *                      Customization Tool (WCT) need to be     *
  *                      updated with information on how system  *
  *                      exits or region size constraints can    *
  *                      potentially impact the successful       *
  *                      installation of WebSphere for z/OS.     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Installation constraints that limit the region size, or system
  exits that restrict the region a job is running in, may cause
  the jobs generated by the zPMT to fail.  However, there is
  nothing in the generated instructions that indicates this.
  

Problem conclusion

• The instructions generated by the zPMT have been updated to
  indicate that system exits and region size restrictions may
  prevent successful installation of WebSphere
  
  The following text has been added to the generated instructions:
  
  By default, the customization jobs below are generated with
  REGION=0M.  If this is not an allowable value on your target
  system, you may need to modify this value for your
  environment.  Your system must allow a private region of
  sufficient size to allow the running of a Java Virtual Machine
  Region with a maximum heap specification of 256 Megabytes
  (i.e., -Xmx256m).  Installation constraints that limit the
  region size, or system exits that restrict the region a job is
  running in, may cause the customization jobs to fail due to a
  JVM error.  In the event of an Out of Memory (OOM) failure due
  to inadequate native storage, you must remove this constraint in
  order to successfully install WebSphere for z/OS.
  
  APAR PK77758 is currently targeted for inclusion in WebSphere
  Customization Tools 7.0.0.5.  When available, WebSphere
  Customization Tools 7.0.0.5 may be downloaded from
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg24020368
  

Temporary fix

Comments

APAR Information

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

  PK70886

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

Fix information

• Fixed component name

  WEBSPHERE FOR Z

• Fixed component ID

  5655I3500

Applicable component levels

• R700 PSY UK48200

     UP09/07/27 P F907

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.