PH43131: JCICS ISCICS.GETAPISTATUS() THROWS JAVA.LANG.NOCLASSDEFFOUNDERROR WHEN CALLED OUTSIDE OF A CICS JVMSERVER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• IsCICS.getApiStatus() can be used to determine the status of the
  current execution environment.
  
  However when called outside of a CICS JVMSERVER the following
  exception can occur:
  
  Exception in thread "main" java.lang.NoClassDefFoundError:
    com/ibm/cics/common/LibertyConstants
      at com.ibm.cics.server.IsCICS.getApiStatus(IsCICS.java:175)
      at com.ibm.cics.server.IsCICS.getApiStatus(IsCICS.java:143)
      at examples.hello.HelloWorld.main(HelloWorld.java:27)
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: java.lang.NoClassDefFoundError when     *
  *                      IsCICS.getApiStatus() is called outside *
  *                      of CICS.                                *
  ****************************************************************
  A Java program makes an IsCICS.getApiStatus() JCICS API call to
  determine if it is running within a CICS JVMSERVER and whether
  CICS API calls can be made.  When not running within CICS the
  API call incorrectly causes a java.lang.NoClassDefFoundError
  exception.
  

Problem conclusion

• JCICS has been updated so that when IsCICS.getApiStatus() is
  called outside of CICS the correct value of NOT_CICS_REGION is
  returned.
  

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:

  UI80052 UI80053 UI80054

Modules/Macros

• DFJ@H356 DFJ@H468
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R10D PSY UI80054

     UP22/04/08 P F204

• R200 PSY UI80053

     UP22/04/08 P F204

• R300 PSY UI80052

     UP22/04/22 P F204

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.