PH34012: JCICS container.get() call can throw undeclared LengthErrorException

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• JCICS container.get() call can throw undeclared
  LengthErrorException.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: The JCICS API does not declare that     *
  *                      some Container calls can cause a        *
  *                      LengthErrorException.                   *
  ****************************************************************
  A JCICS application is developed which uses one of the following
  JCICS Container API methods:
  
  - getString()
  - get()
  - get(String intoCodePage)
  - get(String intoCodePage, int sourceOffset, int length)
  - getNoConvert()
  - getNoConvert(int offset, int length)
  - get(byte[] destination, int sourceOffset, int length)
  - get(byte[] destination, int destinationOffset,
        int sourceOffset, int length)
  - getNoConvert(byte[] destination, int destinationOffset,
                 int sourceOffset, int length)
  - getNoConvert(byte[] destination, int sourceOffset, int length)
  - get(int sourceOffset, int length)
  
  A com.ibm.cics.server.LengthErrorException can occur at runtime
  when such a call is made, however this exception is not
  declared on the methods' signatures.
  
  Additional keywords: AEIV AJ04 AJ05 JCICSX
  

Problem conclusion

• The JCICS Container methods listed above have been updated to
  add com.ibm.cics.server.LengthErrorException as a checked
  exception.  As a result applications may need updating when
  recompiled.
  
  The Javadoc for the affected methods will be updated to add
  LengthErrorException to the list of thrown exceptions.
  
  The OSGi micro version of com.ibm.cics.server has been
  incremented to 1.800.1.
  
  The runtime behaviour of CICS has not changed.
  

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:

  UI75446

Modules/Macros

• DFJ@H223 DFJ@H239 DFJ@H356 DFJ@H361 DFJ@H581 DFJ@H595 DFJ@H596
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI75446

     UP21/05/19 P F105

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.