PH54169: CPSM API PROGRAM UNDER VERSION 5.6 MAY RECEIVE INCORRECT VERSION OF TCPIPS BASE TABLE

APAR status

• Closed as program error.

Error description

• You have a CPSM API program that retrieves the TCPIPS table.
  Your program is running in a CPSM 5.6 environment (with the 5.6
  SEYUAUTH dataset in STEPLIB) but has an EXEC CPSM CONNECT call
  with VERSION('xxxx') that is lower than 5.6.
  
  
  When you FETCH records from your result set you are using
  LENGTH(624) which is correct for a TCPIPS table version lower
  than 5.6. The FETCH fails with RESPONSE 1028 ( INVALIDPARM ) and
  REASON 1285 ( LENGTH ). If you change that length to 632, the
  FETCH is successful, but CPSM returns the incorrect version of
  the TCPIPS table with the additional field OPTIONSPGM at the
  end. This field was added at version 5.6.
  

Local fix

• Update the program to connect at CPSM version 5.6 and use the
  5.6 layout for the TCPIPS table.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM Users.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: A CPSM FETCH of a TCPIPS resource table *
  *                      record, when using a lower CONNECT      *
  *                      version level specifying the correct    *
  *                      LENGTH fails returning a LENGTH (1285)  *
  *                      reason code.                            *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick    *
  *                 up the new code.  These regions do not       *
  *                 need to be brought down and restarted at     *
  *                 the same time or in any specific order.      *
  ****************************************************************
  When performing a FETCH for a TCPIPS object, specifying
  VERSION(0550) or earlier, with the correct LENGTH specified
  for that version, the FETCH fails. Response INVALIDPARM (1028)
  Reason LENGTH (1285) is returned on this failure.
  
  The failure occurs because new attribute OPTIONSPGM is
  included in the resource table record. This attribute was
  added at CICSPlex SM V5.6 and should not have been included
  when using an earlier connect version.
  
  A similar failure occurs when a program executes in a CICSPlex
  SM V6.1 environment.When specifying a connection level of
  VERSION(0560) the ATTLS attribute, added in V6.1, is included.
  When specifying a connection level of VERSION(0550) or earlier
  the ATTLS attribute and OPTIONSPGM attribute are both included.
  

Problem conclusion

• TCPIPS resource table has been corrected, to correct the
  declaration of the new attributes in the table.
  

Temporary fix

Comments

APAR Information

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

  PH53673

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

  UI91681

Modules/Macros

• EYUA0103 EYUC0103 EYUE0103 EYUL0103 EYUP0103 EYUT0103 EYUY0103
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R40M PSY UI91681

     UP23/05/06 P F305