IJ56482: FAILURE TO CREATE THE SHARED CLASSES CACHE DIRECTORY IN CERTAIN CIRCUMSTANCES

APAR status

• Closed as program error.

Error description

• Error Message: JVMSHRC559E Failed to create a directory
  "/u/username/.classCache/" for the shared class cache
  JVMSHRC840E Failed to start up the shared cache.
  .
  Stack Trace: N/A
  .
  The JVM may fail to create the shared classes cache directory if
  a directory in the specified path exists but has restricted
  permissions.
  

Local fix

Problem summary

• The problem was originally observed on a z/OS system that used
  the Broadcom ACF2 product to control file system access
  permissions. However, similar situations may arise in other ways
  
  
  and on other platforms.
  The original situation reported to IBM was a Java application
  running in an environment that used ACF2. This application
  specified a custom location for the shared classes cache using a
  
  
  Java command line option like this:
  -Xshareclasses:cacheDirPerm=1000,cacheDir=/u/username/.classCach
  
  
  e/
  In this situation, ADD access had been removed for the top level
  
  
  /u directory, and the directory /u/username/ already existed.
  Therefore the JVM needed to create /u/username/.classCache/ and
  the javasharedresources directory inside that. The corresponding
  
  
  mkdir() call failed when ACF2 unexpectedly returned a permission
  
  
  denied error for /u, even though this directory already exists.
  

Problem conclusion

• OpenJ9 has been updated to check whether each directory in the
  specified path exists before attempting to create it, rather
  than relying on specific errors returned from mkdir().
  More information can be found in the following OpenJ9 pull
  request:
  https://github.com/eclipse-openj9/openj9/pull/22622
  .
  This APAR will be fixed in the following Releases:
  .
  IBM Semeru Runtimes
   25              25.0.1.0
   21              21.0.10.0
   17              17.0.18.0
   11              11.0.30.0
  IBM SDK, Java Technology Edition
   8    SR8 FP60   8.0.8.60
  .
  Downloads and supplementary documentation can be found at the
  following locations:
  - For non z/OS operating systems:
  - IBM Semeru Runtimes, Version 11 and later
    https://www.ibm.com/semeru-runtimes/downloads/
  - IBM SDK, Java Technology Edition, Version 8
    https://www.ibm.com/support/pages/java-sdk-downloads/
  - For the z/OS operating system:
  - Java SDK Products on z/OS
    https://www.ibm.com/support/pages/java-sdk-products-zos
  

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

  J9 COMMON CODE

• Fixed component ID

  620700127

Applicable component levels