PH32184: CICS: Liberty JVM server not disabling; DFHSJ0007 occurs

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When disabling a Liberty JVMSERVER that uses the cicsts:link-1.0
  feature it may never complete disabling.  It may remain in the
  disabling state.  Reviewing the messages the CICS region issues:
  
  DFHSJ0007 applid Unexpected signal received by JVMSERVER:
  jvmserver
  
  You may also see:
  
   - A CEE3250C reporting a U501 abend.
   - gpfs (general protection faults) occur in the JVM.
  
  This problem occurs when Liberty notifies CICS that a link to
  Liberty application has been removed late in JVM server disable
  processing.  At this time it is not possible to make a CICS
  domain call as the "CICS Framework stop" thread does not have
  access to CICS services.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Liberty JVMSERVER using the             *
  *                      cicsts:link-1.0 feature hangs when      *
  *                      disabled.                               *
  ****************************************************************
  A Liberty JVMSERVER is configured to use the cicsts:link-1.0
  feature.  When the JVMSERVER is disabled CICS tells Liberty to
  shutdown.  Liberty removes the cicsts:link-1.0 feature and
  informs CICS that the PROGRAM(s) available via EXEC CICS LINK
  have been removed.  Depending on workload and timing this may
  occur when no CICS-enabled threads are available.  If this
  occurs the JVMSERVER will hang in a disabling state and a
  DFHSJ0007 message may be issued.  A CEE3250C reporting a U501
  abend and gpfs (general protection faults) in the JVM may also
  be reported.
  

Problem conclusion

• CICS has been updated so that if no CICS-enabled threads are
  available when notified to remove a PROGRAM that an Exception
  is reported, no abends occur and the JVMSERVER completes
  disabling successfully.  As a result a PROGRAM definition may
  remain which will be removed when CICS is next restarted.
  

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:

  UI74589 UI74590 UI74591 UI74592

Modules/Macros

• DFHCDJNI DFHCDK64 DFHMSG64 DFJ@H356 DFJ@H360 DFJ@H467 DFJ@H468
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI74591

     UP21/03/25 P F103

• R10D PSY UI74592

     UP21/03/25 P F103

• R200 PSY UI74590

     UP21/03/25 P F103

• R300 PSY UI74589

     UP21/03/25 P F103

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.