PK02245: FTP NOT SELECTING USERID/PASSWORD FROM NETRC FILE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the TCPIP stack is started with a fully qualified name
  specified with the HOST keyword, in searching the NETRC file,
  FTP does not suffix the supplied name with the local domain.
  
  If the FTP then specifies a non-qualified host name that is
  able to be resolved thru a DNS search,
  a subsequent search of the NETRC file will not find a match.
  
  This worked in release 10.
  
  Sample:
  
  TCPIP.DATA file on TCPIP starup.
  HOST eu.ca-investorservices.com
  
  NETRC file
  machine STARTNETRC login anyid    password xxxxxxxx
  machine GPD-QAS1   login userid2  password xxxxxxxx
  machine ENDNETRC   login anyid    password xxxxxxxx
  
  DNS response to GPD-QAS1
  EZA1554I Connecting to: lucaiqu505.prod.lux.ca-indosuez.com
  
  FTP command:
  FTP GPD-QAS1
  
  A connection is established to
  lucaiqu505.prod.lux.ca-indosuez.com
  but GPD-QAS1 is not matched in the netrc file.
  
  With internal debugging active and a netrc file pointed
  to by a //NETRC ddname the trace will show
  
  active CZ1215 rnetrc: Check the Host name using GPD-QAS1
  CZ1225 rnetrc: host is already a name.
  CZ1234 rnetrc: gethostname() returned with
  eu.ca-investorservices.com
  CZ1284 rnetrc: Check the Host name using STARTNETRC
  CZ1292 rnetrc: host is already a name.
  CZ1284 rnetrc: Check the Host name using GPD-QAS1
  CZ1292 rnetrc: host is already a name.
  CZ1284 rnetrc: Check the Host name using ENDNETRC
  CZ1292 rnetrc: host is already a name.
  CZ1215 rnetrc: Check the Host name using
  lucaiqu505.prod.lux.ca-indosuez.com
  CZ1225 rnetrc: host is already a name.
  CZ1234 rnetrc: gethostname() returned with
  eu.ca-investorservices.com
  CZ1284 rnetrc: Check the Host name using STARTNETRC
  CZ1292 rnetrc: host is already a name.
  CZ1284 rnetrc: Check the Host name using GPD-QAS1
  CZ1292 rnetrc: host is already a name.
  CZ1284 rnetrc: Check the Host name using ENDNETRC
  CZ1292 rnetrc: host is already a name.
  
  where the entire netrc file is read (ie. ENDNETRC is last
  machine statement in file) and no match is found.
  

Local fix

• When TCPIP is activated. The TCPIP.DATA file should not use a
  fully qualified name for the HOST
  OR add fully qualified HOSTNAME to the NETRC so they both
  match.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the Communications Server for   *
  *                 z/OS Version 1 Release 4, 5 and 6 IP: FTP    *
  ****************************************************************
  * PROBLEM DESCRIPTION: FTP using NETRC does not find the       *
  *                      correct entry causing a logon failure.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When the find is done for the userid and password, the hostname
  without the domain is used incorrectly. This causes the entry
  with the correct userid and password to not be found.
  +-------------------------------------------------------------+
  + 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 has been updated to properly append the domain name
  to the host name when searching the NETRC file so the
  correct userid and password is found.
  
  * Cross Reference between External and Internal Names
  PREFTPCX (EZAFTPCX)
  

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:

  UK01719 UK01720 UK01721 PK05994

Modules/Macros

• EZAFTPCX EZAFTPCZ
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R140 PSY UK01719

     UP05/04/27 P F504

• R150 PSY UK01720

     UP05/04/27 P F504

• R160 PSY UK01721

     UP05/04/27 P F504

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.