PI37464: CICS TS 5.2 - ABEND AJ05 - A JAVA.LANG.RUNTIMEEXCEPTION MAY OCCUR WHEN USING CHANNELS AND CONTAINERS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After upgrading to CICS TS 5.2, a java application fails with
  an AJ05 abend.  This abend occurs as a result of the exception:
  .
   java.lang.RuntimeException:  Name contains a NUL character
  .
  which may occur when getting a container.  The RuntimeException
  occurs when the application trys to get a Container whose name
  contains a null character.  A sample stack trace will show as
  follows:
  .
  java.lang.RuntimeException: Name contains a NUL character
    at com.ibm.cics.server.ChannelFactory.padName
    at com.ibm.cics.server.Channel.findContainer(Channel.java:146)
    at com.ibm.cics.server.Channel.getContainer(Channel.java:272)
    ....
    at com.ibm.cics.server.Wrapper.call_main(Wrapper.java:810)
    at com.ibm.cics.server.Wrapper.callOSGiClass
    at com.ibm.cics.server.Wrapper.invokeJvmServerOSGiClass
    at com.ibm.cics.server.Wrapper.jvmServerOSGiEntry
    at com.ibm.cics.osgi.impl.Controller.runService
    at com.ibm.cics.osgi.impl.Controller.acceptRequest
    at sun.reflect.GeneratedMethodAccessor4.invoke(Unknown Source)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke
    at java.lang.reflect.Method.invoke(Method.java:619)
    at com.ibm.cics.router.Router.route(Router.java:1067)
  .
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVCTC
  

Local fix

• Remove null characters from container name
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A java.lang.RuntimeException occurs     *
  *                      during JCICS Channel and Container      *
  *                      method calls.                           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In the reported case, a JCICS getContainer call is made with a
  containerName value that includes null characters.  CICS detects
  that this is invalid input and a RuntimeException with message
  "Name contains a NUL character" is thrown.  The transaction
  subsequently abends AJ05.
  Additional keywords: abendsAJ05 abendAJ05
  

Problem conclusion

• CICS has been updated so that the JCICS Channel and Container
  method calls throw a ChannelErrorException or
  ContainerErrorException if a channel or container name
  that includes embedded null characters is provided.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI29661

Modules/Macros

• DFJ@H356
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R90D PSY UI29661

     UP15/07/31 P F507

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.