PI46832: CICS TG does not report an error when an invalid container name is specified.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The put function on ECIChannelRecord adds a container to a
  channel. The maximum length for container name is 16 characters,
  but if a container name longer than 16 characters is used no
  error is returned.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS TG channels and            *
  *                 containers.                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Unexpected behaviour of                 *
  *                      ECIChannelRecord functions.             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Validity checking on the ECIChannelRecord.put function did not
  identify invalid container names, nor unrecognised data object
  types. No errors were reported to the client program, but the
  request was not sent to CICS.
  

Problem conclusion

• CICS TG has been corrected to throw an IllegalArgumentException
  when the container name is invalid, an
  UnsupportedOperationException when the data object supplied is
  not of a recognised type, and a NullPointerException when the
  container name is null.
  CICS TG has also been changed so that when a specified
  container name already exists in the channel a put call will
  update the contents with the new data and return the original
  data object. CICS TG will also return null when a new container
  is being created. The remove method has been changed to return
  the container data rather than a com.ibm.ctg.client.Container
  object, when removing the container from the channel.
  

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:

  PI49423 UI31754

Modules/Macros

•    CTG00197 CTG00199 CTG00204 CTG00524 CTG00974
  

Fix information

• Fixed component name

  CTG V9 FOR Z/OS

• Fixed component ID

  5655Y2000

Applicable component levels

• R910 PSY UI31754

     UP15/10/13 P F510

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.