PH24570: EXEC CICS EXTRACT-ATTRIBUTES FAILING WITH INVREQ BUT HAS NO EIBRESP2 VALUE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When running a Java program message DFHCZ0296 is issued and a
  system dump is taken.
  
  CZ0296: A JNI call, GetFieldID() for principalFacility, in code
  written to support Java native methods used by the JCICS Java
  class library has failed.
  
  Transaction is initiated by an external partner via an APPC
  interface in CICS
  
  The CICS message associated is:
  
  DFHCZ0296 date time applid userid termid tranid program_name JNI
   call 'GetFieldID()' in module failed
  
  CICS trace shows a EXEC CICS EXTRACT-ATTRIBUTES failing with
  INVREQ but has no EIBRESP2 value.
  

Local fix

• No Local Fix.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHCZ0296 GetField() error when         *
  *                      attempting to start a Java transaction  *
  *                      that is using a Remote APPC session as  *
  *                      a terminal principle facility.          *
  ****************************************************************
  A CICS transaction which has a remote APPC session as its
  terminal principle facility attempts to start a Java program.
  During the initialisation of the Java Task Object a call to
  obtain APPC information is done using EXEC CICS EXTRACT PROCESS
  this returns an INVREQ for this session.
  
  A Java exception is created within the JNI layer which is
  returned to the application as an InvalidRequestException and
  the program does not execute.  The message DFHCZ0296 is
  produced like:
  
  DFHCZ0296 date time applid userid termid tranid program_name JNI
   call 'GetFieldID()' in module failed
  
  Additional Keywords: msgDFHCZ0296  CZ0296
  

Problem conclusion

• DTCSupport.c has been updated to handle the failure of EXEC CICS
  EXTRACT PROCESS and EXEC CICS EXTRACT ATTRIBUTES.  The principle
  facility will be returned as null in these cases.
  

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:

  UI71275 UI71278 UI71279

Modules/Macros

• DFJ@H356 DFJ@H468 DFJDTCOE
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R10D PSY UI71275

     UP20/08/28 P F008

• R200 PSY UI71278

     UP20/08/28 P F008

• R300 PSY UI71279

     UP20/09/03 P F009

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.