PQ83770: FTP of an HFS in binary mode using //DD support fails

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When running FTP in batch or tso and using a DDNAME to
  allocate an HFS file, a put of that DDNAME fails with
  
  EZA2602E Error reading the file
  
  Following is sample FTP client trace depicting error
  
  PC0322 parseCmd: subcommand:  put
  PC0325 parseCmd: parameter 1: //DD:INDD
  PC0325 parseCmd: parameter 2: test2b.txt
  PC0560 fndCmd: entered with put
  PC0642 fndCmd: command found is put
  PC0334 parseCmd: fndCmd returned the cmdrecord for put
  SC3318 inSession: entered
  PC0458 parseCmd: using primary session
  CP0473 put: entered
  CP0474 put: F=1 p=FSI ARTWT=00001
  MD0654 diroutp: entered
  MD0657 diroutp: request for oper=W  dlip = 579432256, dest=M
         name=put.memory
  CC0127 setupXLMT: entered
  CC0135 setupXLMT: not proxy and local directory is not a load
  library
  MD0654 diroutp: entered
  MD0657 diroutp: request for oper=C  dlip = 579432256, dest=M
         name=put.memory
  CP0881 sndFile: entered with foreignFile=test2b.txt,
         localName=//DD:INDD
  CP3938 checkMB: entered
  GV0086 init_sfi: entered
  CP2366 mvs_sndFile: entered
  GV0339 seq_stat_file: entered
  GU1320 get_recfm_values: entered
  CP2061 setFileAccessStructF: entered
  CP2579 mvs_sndfile: using local file allocated by ddname INDD
  MF0525 seq_open_file: entered
  GU1320 get_recfm_values: entered
  MF0543 seq_open_file: recfm is NONE
  MF0861 seq_open_file: ISB  -> rb,recfm=*,NOSEEK for dd:INDD
  
  MF0980 seq_open_file: ddname INDD     has filename /etc/services
  
  MF0986 seq_open_file: (2) set DDNAME characteristics- recfm=C0,
  lrecl=0, blksize=0
  MF0992 seq_open_file: stream 22930864 has maxreclen 0
  GU1320 get_recfm_values: entered
  SC2397 sendCmd: entered
  EZA1701I >>> SITE VARrecfm LRECL=0 RECFM=U BLKSIZE=0
  SC2789 getReply: entered
  SC3527 getNextReply: entered
  200 SITE command was accepted
  SC1152 initDsConnection: entered
  SC2397 sendCmd: entered
  EZA1701I >>> PORT 9,37,254,4,10,85
  SC2789 getReply: entered
  200 Port request OK.
  SC2397 sendCmd: entered
  EZA1701I >>> STOR test2b.txt
  SC2789 getReply: entered
  125 Storing data set /tmp/test2b.txt
  SC3269 getLastReply: entered
  SC1568 accDsConnection: entered
  TO1405 read_image: entered
  TO1406 read_image: O=2 HGPES=00001 BCTE=0000 RLB=C0/0/0
  
  TO1417 read_image: entered with bad block size = 0
  
  MF0362 seq_close_file: entered
  MF0421 seq_close_file: file closed
  GV0125 releaseFile: entered
  GV0146 releaseFile: file allocated by the jobstep - no release
         necessary
  SC2274 dataClose: entered
  
  CP1066 sndfile: rc_read 1012 rc 0
  
  EZA2602E Error reading the file
  

Local fix

• Instead of using //DD to FTP the file,
  use the data set name.
  ex. put /etc/services /tmp/test2b.txt
  instead of
      put //dd:ddname where ddname is JCL pointing to the same
  data set
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release 4 and             *
  *                 z/OS Version 1 Release 5 IP: FTP             *
  ****************************************************************
  * PROBLEM DESCRIPTION: When running FTP in batch or tso and    *
  *                      using a DDNAME to allocate an HFS       *
  *                      file, a put of that DDNAME using binary *
  *                      fails with:                             *
  *                      EZA2602E Error reading the file         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  EZAFTPCP was calling read_image() for the HFS file, although
  read_image() can only process MVS files.  The code needs to be
  changed to not call read_image() for an HFS file, but instead
  call read_stream() to process the file.
  +-------------------------------------------------------------+
  + 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

• EZAFTPCP has been changed to correctly invoke read_stream()
  for an HFS DDNAME file.
  
  * Cross Reference between External and Internal Names
  PREFTPCX (EZAFTPCX)  PREFTPLD (EZAFTPLD)  PREFTPLS (EZAFTPLS)
  

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:

  UQ85942 UQ85943 PQ92771

Modules/Macros

• EZAFTPCP EZAFTPCX EZAFTPGV EZAFTPLD EZAFTPLS
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R140 PSY UQ85942

     UP04/04/08 P F404

• R150 PSY UQ85943

     UP04/04/08 P F404

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.