PH64102: GATHER DIAGNOSTICS fails, incorrectly saying there are no .properties files

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• PERFORM JVMSERVER JVM GATHER DIAGNOSTICS fails:
  
  DFHSJ0937 Failed to gather diagnostics information for JVM
  server JVMNAME.  For more information see the trace file at
  /tmp/diagnostics-trace-yyyy-mm-dd-hh-mm-ss.txt.
  
  The trace file shows:
  
  Directory "/workdir/diagnostics/APPLID/JVMNAME/properties" does
  not contain any .property files to use. This may indicate the
  JVM server has never been enabled.
  
  However there are properties files.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The JVMSERVER GATHER DIAGNOSTICS SPI    *
  *                      incorrectly reports there are no        *
  *                      .property files.                        *
  ****************************************************************
  A JVMSERVER is installed and enabled in a region.  Later, the
  GATHER DIAGNOSTICS command is used to collect all the output
  from the JVM server into a single archive file for sharing with
  IBM Support.  The command fails with the following message
  written to the joblog:
  
  DFHSJ0937 Failed to gather diagnostics information for JVM
  server JVMNAME.  For more information see the trace file at
  /tmp/diagnostics-trace-yyyy-mm-dd-hh-mm-ss.txt.
  
  The trace file shows:
  
  Directory "/workdir/diagnostics/APPLID/JVMNAME/properties" does
  not contain any .property files to use. This may indicate the
  JVM server has never been enabled.
  
  However there are properties files.
  

Problem conclusion

• The GATHER DIAGBOSTICS command has been updated so that the
  script invoked drives a Java program to reduce the usage of
  shell commands.  The GATHER DIAGNOSTICS command will now produce
  a .zip archive rather than a .tar archive.
  

Temporary fix

Comments

APAR Information

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

  PH61662

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

  PH68089 UO04924 UO04925

Modules/Macros

• DFHSJPE  DFJ@H589 DFJ@H681
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO04925

     UP25/09/19 P F509

• R500 PSY UO04924

     UP25/09/17 P F509

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.