A fix is available
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 number
PI46832
Reported component name
CTG V9 FOR Z/OS
Reported component ID
5655Y2000
Reported release
910
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-08-13
Closed date
2015-10-09
Last modified date
2015-11-03
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.1","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMJ2","label":"CICS Transaction Gateway"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
10 August 2024