PM22621: ChannelNameException thrown by Gateway daemon when a zero lengthchannel or container name is used

CICS Transaction Gateway Desktop Edition V8.0 Fix Pack 6
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - AIX
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - Linux on zSeries
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - Solaris
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - HP-UX on Itanium
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - Windows
CICS Transaction Gateway for Multiplatforms V8.0 Fix Pack 6

APAR status

• Closed as program error.

Error description

• The ECIv2 functions ECI_createChannel and ECI_createContainer
  allow a channel or container name to be zero length (""). When
  such a channel or container is sent to the Gateway, it
  generates an exception in the Gateway and a
  CTG_ERR_GATEWAY_EXCEPTION error is returned to the application.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the CICS Transaction Gateway    *
  *                 using ECI v2.                                *
  ****************************************************************
  * PROBLEM DESCRIPTION: The ECI v2 API allows zero length       *
  *                      channel or container names to be used,  *
  *                      which results in an exception being     *
  *                      thrown in the Gateway daemon. This      *
  *                      causes the CTG_ERR_GATEWAY_EXCEPTION    *
  *                      return code to be returned to the       *
  *                      application.                            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Channel or container names must not be zero length and this is
  checked in the Gateway daemon. It should also be checked in the
  ECI v2 API so that a useful error can be returned to the
  application.
  

Problem conclusion

• CICS Transaction Gateway has been changed so that if a zero
  length channel or container name is specified, an
  ECI_ERR_INVALID_NAME error is returned to the application.
  

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

• CTGV8DUM
  

Fix information

• Fixed component name

  CICS TRNS GATE

• Fixed component ID

  5724I8102

Applicable component levels

• R800 PSY

     UP