PM86333: SERVER.ENV DOESN'T OVERRIDE SYSTEM.ENV IF IT CONTAINS AN UNCOMME NTED STRING IN FIRST LINE (LIBERTY.ENV)

APAR status

• Closed as program error.

Error description

• configure Server Proc with a STDENV like so:
  //STDENV  ? ? DD
  PATH='/WebSphere_LP/usr/system.env',PATHOPTS=(ORDONLY)
  system.env contains:
  liberty.env
  #--------------------------------------
  #JAVA_HOME=...java6...
  JAVA_HOME=..java8...
  
  and create a server.env at  /WebSphere_LP/usr/servers/jld1
  which contains
  liberty.env
  #--------------------------------------
  JAVA_HOME=...java6...
  #JAVA_HOME=..java8...
  
  note the first line is just an uncommented string
  Note that system env is at Java 7 and server.env is at Java 6
  
  Information Center says:
  
  ? ?  ? ? The environment is determined by the following logic:
  - If the STDENV DD is defined, it's read by LE as the initial
  environment
  - If $WLP_INSTALL_DIR/etc/server.env exists and is readable,
  its key=value ? ?
  ? ?contents are read and set into the environment. The file
  can be in ASCII or EBCDIC. ? ?
  ? ?Comments start with a '#' and go to the end of the line.
  Values that contain white ? ?
  ? ?space can be placed in double quotes. Any environment
  entries specified in this ? ?
  ? ?file will override entries from the initial environment
  - If $WLP_USER_DIR/servers/{serverName}/server.env exists and
  is readable, ? ?
  ? ?its key=value contents are read and set into the
  environment. This file ? ?
  ? ?can also be in ASCII or EBCDIC and supports comments. Any
  entries specified ? ?
  ? ?here will override entries from the initial environment an
  the etc/server.env.
  
  In this config the server.env should override the system.env
  so the server reports a Java 6 environment
  
  At startup the server reports a Java 7 environment
  Launching jld1
  (wlp-1.0.1.cl0220130209-0716/websphere-kernel_1.0.1) on IBM J9
  VM,
  version pmz6470sr4-20130113_01 (SR4) (en_US)
  No errors are produced regarding the uncommented string in the
  env files and the override does not occur
  
  When the uncommented string is removed from both env files the
  server starts and reports a Java 6 environment as it should
  demonstrating the override has occurred.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server                                      *
  *                  Liberty Profile                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: The  z/OS native server launcher        *
  *                      fails to parse an uncommented line in   *
  *                      the server.env which is not a           *
  *                      name-value pair.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The z/OS native server launcher script did not parse the line
  in server.env, which is not a name-value pair. This caused the
  variables specified in the server.env following the unparsed
  line not to be set in the environment.
  The z/OS native server launcher script also failed to create
  directories specified by environment variable WLP_OUTPUT_DIR,
  if they are not already existing. This caused the server to
  throw an error message "CWWKB0227E Real path of the server
  output directory could not be resolved ‚   : EDC5000I No error
  occurred. (errno2=0x115C006C)".
  

Problem conclusion

• The z/OS native server launcher script is updated to handle
  the strings that are not name-value pairs.
  The z/OS native server launcher creates non-existing sub
  directories specified by the environment variable
  WLP_OUTPUT_DIR.
  
  The fix for this APAR is currently targeted for inclusion in
  fix pack 8.5.5. Please refer to the Recommended Updates page
  for delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

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

  LIBERTY PROFILE

• Fixed component ID

  5724J0814

Applicable component levels

• R850 PSY

     UP