PM05880: IN A CINET ENVIRONMENT WITH MULTIPLE STACKS SETUP TO USE SYSTCPSM NMI, FTP SMF 119 TERM RECORDS GO TO WRONG STACK

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• SMF 119 INIT & TERM records are going to different TCPIP
  address spaces in a CINET environment. Where multiple
  TCPIP address spaces are using the NMI SYSTCPSM to process
  SMF records.
  

Local fix

• verification steps:
  
  The SYSTCPSM NMI is being used to gather FTP statistics in a
  CINET environment where FTPD is bound to all active TCPIP
  stacks.
  
  multiple TCPIP stacks are defined and active and each opens a
  socket and connects to it's own defined NMI AF_UNIX socket
  /var/sock/SYSTCPSM.tcpipx.
  
  The NMI application has separate subtasks doing each
  connect to one of the stacks defined NMI AF_UNIX
  sockets.
  
  FTP to the FTPD on TCPIP1s IP address interface the task with a
  connection to TCPIP1 NMI, gets a FTP server session init record.
  The actual SMF record shows the stack is TCPIP1 in the
  SMF TCPIP IDENT record.
  
  Close the FTP client session for the FTP on stack TCPIP1 and
  the FTP server session term record is processed, in the task
  connected to stack TCPIP2 NMI interface.  The SMF record that
  is processed by this task sees the stack is TCPIP1 is in the
  SMF TCPIP IDENT record.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release(s) 9, 10, and     *
  *                 11 IP: FTP server                            *
  ****************************************************************
  * PROBLEM DESCRIPTION: In a CINET environment with multiple    *
  *                      stacks setup to use the SYSTCPSM NMI,   *
  *                      the FTP SMF 119 TERM records were       *
  *                      sometimes sent to the wrong stack.      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In a CINET environment with multiple stacks using the
  SYSTCPSM NMI, the FTP SMF 119 TERM records were sometimes
  sent to the wrong stack. The information in the FTP SMF
  119 TERM record was correct and has the correct stack
  name in the IDENT section of the record. The algorithm used
  to select the appropriate stack is different for CINET
  environment and that information was not saved in the
  session control block.
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

• FTP server code has been modified to select the correct stack in
  a CINET environment.
  
  * Cross Reference between External and Internal Names
  

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:

  UK54517 UK54518 UK54519

Modules/Macros

• EZAFTPRE EZAFTPRU EZAFTPSI
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1A0 PSY UK54517

     UP10/03/30 P F003

• R1B0 PSY UK54518

     UP10/03/30 P F003

• R190 PSY UK54519

     UP10/03/30 P F003

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.