PH61662: 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 DIAGNOSTICS 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:

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

  PH64102 UO05729

Modules/Macros

• DFHSJJS  DFJ@H589 DFJ@H681
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UO05729

     UP25/11/12 P F511

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.