PH53635: JAVAINTEROP: THROW JAVA EXCEPTION FOR LENGTH MISMATCH BETWEEN JAVA ARRAY AND COBOL DATA ITEM FOR AMODE64

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Throw a Java exception (instead of stopping the run unit as
  currently occurs) when there is a length mismatch between the
  Java array and the corresponding COBOL data item for AMODE64.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Enterprise COBOL 6.4 running AMODE  *
  *                 64 programs that use non-OO COBOL/Java       *
  *                 interoperability support and there is an     *
  *                 array length mismatch between a Java array   *
  *                 argument or return value and the             *
  *                 corresponding COBOL parameter or receiver.   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Failure to catch the error at runtime,  *
  *                      leading to unpredictable runtime        *
  *                      results.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the IBM-provided PTF.                  *
  ****************************************************************
  Array length mismatches between COBOL and Java arguments or
  return values was being handled through error codes passed
  between the COBOL program and the COBOL runtime, but that scheme
  was not sufficient in some scenarios, including a scenario where
  the new ON EXCEPTION phrase of a CALL statement for a call to a
  static Java method is used.
  

Problem conclusion

• The runtime was updated so that when a mismatch between the
  length of a Java array argument or return value and the
  corresponding COBOL table parameter or receiver occurs, an
  exception of class java.lang.IllegalArgumentException is thrown,
  which can be caught and handled in COBOL via the ON EXCEPTION
  phrase of a CALL statement for a CALL to a static Java method,
  or can be handled in Java code using try/catch.
  
  Note that a program must be compiled with an Enterprise COBOL
  6.4 compiler with the PTF(s) for APAR PH53631 installed in order
  to use the ON EXCEPTION phrase of a CALL statement targeting a
  Java method in order to catch and process Java exceptions.
  

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:

  UI91395 UI91399

Modules/Macros

• CELQSG04 CELQV004 IGZQAPI  IGZQCA64 IGZQCDA  IGZQINPL IGZQJNI2
  

Fix information

• Fixed component name

  LE ENT COBOL LI

• Fixed component ID

  568819812

Applicable component levels

• R7C0 PSY UI91395

     UP23/04/26 P F304  

• R7D0 PSY UI91399

     UP23/04/26 P F304  

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.