PK14179: CICS AUTOINSTALL ISSUE USING DFHTCUDS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• DFHTCUDS is used in CICS autoinstall. Customer is mapping out
  all the IP information for the application. The IP address
  returned is wrong.
  The problem is DFHTCUDS macro does not match SNA format
  control vector x'64' subtype x'81'.
  DFHTCUDS shows the following,
  TP_VERSION     DS    X       x'04' = IP version 4
  TP_ADDRESS     DS    XL4     xx xx xx xx binary ip address
  However, the SNA format book (GA27-3136-20) in URL
  http://publibfi.boulder.ibm.com/cgi-bin/bookmgr/BOOKS/d50a5007
  /9.3.2.94?DT=20040213113031 shows that under CV x'64', subfield
  x'81', there is an extra 1 byte between IP version and IP
  address.
  

Local fix

• Adding an extra 1 byte between IP version and IP address correct
  the problem.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Terminal autoinstall exit locates       *
  *                      incorrect Telnet 3270 IP address due to *
  *                      error in DFHTCUDS.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A terminal autoinstall exit is used to locate the Telnet 3270 IP
  address from the CINIT. Sample assembler programs DFHZATDX and
  DFHZATDY contain inactive code to locate the start of the IP
  address by using data structures in copybook DFHTCUDS.
  The calculated IP start address is 1 byte short of the actual IP
  address in the CINIT due to an error in the way that DFHTCUDS
  describes the X'81' IP address subvector.
  
  ADDITIONAL KEYWORDS :- TNADDR TP_ADDRESS TCP/IP Information
                         (X'64') Control Vector
  

Problem conclusion

• Copybook DFHTCUDS has been changed to correctly describe the
  X'81' IP address subvector.
  

Temporary fix

• CICS AR400
  ++ APAR (AK14179).
  ++ VER (C150) FMID(HCI6400).
  ++ MACUPD (DFHTCUDS) DISTLIB(ADFHMAC) SYSLIB(SDFHMAC)
     /* MODULE: DFHTCUDS --- TYPE: COPY */.
  ./ CHANGE NAME=DFHTCUDS,SEQFLD=738
  TP_FLAGS       DS    X       Flag byte     @BA14179 99989700
  ./ ENDUP
  

Comments

APAR Information

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

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

  UK11296

Modules/Macros

•    DFHTCUDS DFHZATDX DFHZATDY
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK11296

     UP06/02/02 P F602

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.