PH64673: LIBERTY SERVERDUMP COMMAND NOT WORKING BECAUSE LIBERTY DOESN'T SUPPORT THE SYMLINKS/SYMBOLS BEING SET BY THE WLPENV SCRIPT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• LIBERTY SERVERDUMP command not working because Liberty doesn't
  support the symlinks/symbols being set by the wlpenv script
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: wlpenv fails with an "Unable to access  *
  *                      jarfile" error and return code 1.       *
  ****************************************************************
  A Liberty JVM server is enabled within CICS.  The JVM server's
  JVM profile contains WLP_INSTALL_DIR, WLP_OUTPUT_DIR and/or
  WLP_USER_DIR paths that use z/OS system symbols.
  
  As the JVMSERVER is enabled, the wlpenv script is created within
  the JVM server's WORK_DIR.  wlpenv contains the paths from the
  JVM profile.
  
  Later wlpenv is run from a terminal.  Liberty does not support
  z/OS system symbols so the symlinks within the path(s) are not
  resolved correctly which causes the command to fail.
  
  wlpenv is called when the PERFORM JVMSERVER LIBERTY SERVERDUMP
  command is run, so the same problem could occur in that
  scenario.  This would result in DFHSJ1604E being issued.
  

Problem conclusion

• CICS has been updated to call realpath() on the WLP_INSTALL_DIR,
  WLP_OUTPUT_DIR and WLP_USER_DIR values when populating wlpenv to
  resolve the paths.
  

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:

  UO03838 UO03839

Modules/Macros

• DFHSJSC  DFJ@H467 DFJ@H609
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO03839

     UP25/07/02 P F506

• R500 PSY UO03838

     UP25/06/27 P F506

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.