PH63024: JAVAINTEROP: CJBUILD & JAVA-SHAREABLE FIXES + JAVA 17/21 SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• - support for Java 17
  - support for Java 21
  - JAVA-SHAREABLE - make sign and truncation behaviour in Java
  put() methods for COMP/COMP-4/COMP-5 items match COBOL move
  semantics more closely
  - JAVA-SHAREBALE - fix problem with unreferenced shared item
  being removed when STGOPT is in effect
  - provide a new -k/--cleanscript option for cjbuild, to provide
  a script that can be run to clean up all artifacts produced by
  cjbuild
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Enterprise COBOL 6.4 building and   *
  *                 running non-OO COBOL/Java interoperable      *
  *                 applications who:                            *
  *                                                              *
  *                 1. Would like to build and run non-OO        *
  *                 COBOL/Java interoperable applications with   *
  *                 Java 17 or Java 21.                          *
  *                                                              *
  *                 2. Would like cjbuild to be able to generate *
  *                 a script that can be run to clean artifact   *
  *                 files generated by cjbuild in the current    *
  *                 directory.                                   *
  *                                                              *
  *                 3. Want improved COBOL compatibility for     *
  *                 put() methods in Java accessor classes for   *
  *                 COMP-4 data items that are under the scope   *
  *                 of a JAVA-SHAREABLE directive.               *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function: 1. Issues that were       *
  *                      preventing the non-OO COBOL/Java        *
  *                      interoperability framework from working *
  *                      with Java 17 and Java 21 have been      *
  *                      addressed.                              *
  *                                                              *
  *                      2. A new option '-k/--cleanscript       *
  *                      <cleanup-script-name>' has been added   *
  *                      to cjbuild to generate a script with a  *
  *                      specified name to clean artifact files  *
  *                      generated by cjbuild in the current     *
  *                      directory.                              *
  *                                                              *
  *                      Improvements: 3. The semantics of       *
  *                      updating COBOL COMP-4 items when done   *
  *                      through the put() method of generated   *
  *                      Java accessor classes now matches       *
  *                      COMP-4 update semantics from native     *
  *                      COBOL.                                  *
  ****************************************************************
  * RECOMMENDATION: Apply the IBM-provided PTF                   *
  ****************************************************************
  1. Users wanted to be able to use Java 17 and Java 21 with the
  new non-OO COBOL/Java interoperability framework.
  
  2. Users wanted a way to clean up artifact files generated by
  cjbuild.
  
  3. Users wanted to ensure that updates to COMP-4 data items made
  from Java via generated Java accessor classes for JAVA-SHAREABLE
  items follows COBOL truncation semantics.
  

Problem conclusion

• The compiler was updated as follows: 1. Support was added for
  Java 17 and Java 21 to the non-OO COBOL/Java interoperability
  framework.
  
  2. A new option -k/--cleanscript <cleanup-script-name> option
  has been added to cjbuild.
  
  3. put() methods in Java accessor classes for COMP-4 data items
  under the scope of a JAVA-SHAREABLE directive have been improved
  to support COBOL decimal truncation semantics for COMP-4 items.
  

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:

Modules/Macros

• IGY8RWTU IGYCASMB IGYCCBE  IGYCCCRT IGYCCICS IGYCCSRV IGYCDGEN
  IGYCDIAG IGYCDMAP IGYCEN$0 IGYCEN$1 IGYCEN$2 IGYCEN$3 IGYCEN$4
  IGYCEN$5 IGYCEN$8 IGYCEN$D IGYCEN$R IGYCFGEN IGYCFREE IGYCINIT
  IGYCJA$0 IGYCJA$1 IGYCJA$2 IGYCJA$3 IGYCJA$4 IGYCJA$5 IGYCJA$8
  IGYCJA$D IGYCJA$R IGYCJBLD IGYCJGEN IGYCLIBR IGYCLSTR IGYCLVL0
  IGYCLVL1 IGYCLVL2 IGYCLVL3 IGYCLVL8 IGYCMALL IGYCOSCN IGYCPGEN
  IGYCRCTL IGYCRDPR IGYCRDSC IGYCREAL IGYCRWT  IGYCSCAN IGYCSIMD
  IGYCUE$0 IGYCUE$1 IGYCUE$2 IGYCUE$3 IGYCUE$4 IGYCUE$5 IGYCUE$8
  IGYCUE$D IGYCUE$R IGYCXREF IGYDRV   IGYEQCWI IGYMSGE  IGYMSGK
  IGYMSGT  IGYQCBE  IGYQSPLT IGYZQEN6 IGYZQENU IGYZQJP6 IGYZQJPN
  

Fix information

• Fixed component name

  ENT COBOL FOR Z

• Fixed component ID

  5655EC600

Applicable component levels

• R640 PSY UI98832

     UP24/10/31 P F410

• R641 PSY UI98833

     UP24/10/31 P F410

• R642 PSY UI98834

     UP24/10/31 P F410

• R64H PSY UI98835

     UP24/10/31 P F410

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.