PJ40513: INSTALLING PUT-9 APAR PJ39617 CAN CAUSE AOA PROBLEMS 12/12/20 PTF PECHANGE

APAR status

• Closed as program error.

Error description

• See Problem Summary.
  

Local fix

• na
  

Problem summary

• APAR NUMBER:  PJ40513
  PRODUCT:  z/TPF
  FUNCTIONAL AREA:  TCP/IP NATIVE STACK
  SHIPPED IN PUT:  9
  
  ABSTRACT:
  With APARs PJ39358 and PJ39617 applied, sockaddr information
  passed to activate_on_accept() server program is corrupted.
  
  PACKAGE CONTENTS:
  Source Segments:
  (C) base/rt/ctsg.asm
  
  Object Only Binaries:
  None.
  
  Configuration Independent Binaries:
  (C) base/obj/ctsg.o
  (C) base/load/CTSG.so
  
  Support Files:
  base/lst/ctsg.lst
  base/lst/CTSG.map
  
  OTHER BINARIES TO BUILD: NO
  None.
  
  COMMENTS:
  APAR PJ39358 addressed a problem with activate_on_accept()
  processing in ctsg.asm. This processing was passing incorrect
  client connection information to the socket accept user exit,
  UACC. PJ39358 changed CTSG processing to save client connection
  sockaddr information on the ECB stack. The address of this area
  is passed to the UACC user exit and to the target
  activate_on_accept() server program.
  
  CTSG invokes z/TPF debugger segment CDB1 (which in turn calls
  the target server program) using the ENTNC macro. This use of
  the ENTNC macro allows CDB1 to reuse CTSG's ECB stack storage.
  Prior to PJ39617, no code in CDB1 used the ECB stack storage
  holding the sockaddr information. Because of this the target
  activate_on_accept() server program would still be passed the
  correct sockaddr information.
  
  PJ39617 changed CDB1 processing, adding a CALLC macro that uses
  the ECB stack storage holding the sockaddr information. This
  results in corrupted sockaddr information for the target
  activate_on_accept() server program.
  

Problem conclusion

• SOLUTION:
  CTSG now issues ENTRC PROGRAM=CDB1 (followed by an EXITC macro
  in case of return). The ENTRC macro preserves CTSG's ECB stack
  storage and avoids the corruption of the client connection
  sockaddr information passed to the target activate_on_accept()
  server program.
  
  COREQS: NO
  None.
  
  MIGRATION CONSIDERATIONS: NO
  None.
  
  BUILD COMMANDS AND INSTRUCTIONS: YES
  #maketpf commands for linux
  maketpf -f CTSG ctsg.o
  maketpf CTSG link
  
  UPDATED INFORMATION UNITS: NO
  None.
  
  See your IBM representative if you need additional information.
  
  DOWNLOAD INSTRUCTIONS:
  http://www.ibm.com/software/htp/tpf/maint/maintztpf.html
  
  APAR URL:
  http://www.ibm.com/software/htp/tpf/ztpfmaint/put9/PJ40513.htm
  

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:

Fix information

• Fixed component name

  Z/TPF

• Fixed component ID

  5748T1501

Applicable component levels

• R110 PSY

     UP