PK02769: FTP RETURNS COND CODE 0 WHEN SUBCOMMAND ACTUALLY FAILED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer has CLIENTERRCODES TRUE coded in their ftp data file.
  The execute the FTP client with EXIT coded.
  A put command fails and subsequent ftp subcommands are not
  processed. The exit return code (condition code) should be set
  between 1 and 16 for a failing condition.
  
  
  15 //TRUE   EXEC PGM=FTP,PARM='MVS056.TCP.RALEIGH.IBM.COM (EXIT'
  16 //SYSOUT   DD DUMMY
  17 //SYSUDUMP DD SYSOUT=*
  18 //SYSPRINT DD SYSOUT=*
  19 //SYSFTPD  DD DSN=USER35.CLIST(FTPDATA),DISP=SHR
  20 //         DD *
     //* RUNNING WITH CLIENTERRCODES TRUE
     //* PUT fails and condition code should be in range 1 to 16
  21 //INPUT    DD *
  ICH70001I USER35   LAST ACCESS AT 10:47:58 ON TUESDAY, MARCH 15,
  2005
  IEF236I ALLOC. FOR USER35T SUCCESS
  IEF237I DMY  ALLOCATED TO SYSOUT
  IEF237I JESE ALLOCATED TO SYSUDUMP
  IEF237I JESE ALLOCATED TO SYSPRINT
  IEF237I 04FF ALLOCATED TO SYSFTPD
  IEF237I JESE ALLOCATED TO INPUT
  IEF237I 04FF ALLOCATED TO SYS00003
  IEF285I   SYS1.TCPPARMS                                KEPT
  IEF285I   VOL SER NOS= CPDLB1.
  IEF237I 04FE ALLOCATED TO SYS00004
  IEF285I   USER35.STANDARD.TCPXLBIN                     KEPT
  IEF285I   VOL SER NOS= CPDLB0.
  IEF237I 04FE ALLOCATED TO SYS00005
  IEF285I   USER35.STANDARD.TCPXLBIN                     KEPT
  IEF285I   VOL SER NOS= CPDLB0.
  IEF237I 04FE ALLOCATED TO SYS00006
  IEF285I   TCPCS.STANDARD.TCPXLBIN                      KEPT
  IEF285I   VOL SER NOS= CPDLB0.
  
  ======> The put in this step failed and should not have returned
  a cond code 0
  IEF142I USER35T SUCCESS - STEP WAS EXECUTED - COND CODE 0000
  
  
  EZA1736I put nonexist.file junk.file
  PC0323 parseCmd: subcommand:  put
  PC0326 parseCmd: parameter 1: nonexist.file
  PC0326 parseCmd: parameter 2: junk.file
  PC0562 fndCmd: entered with put
  PC0644 fndCmd: command found is put
  PC0335 parseCmd: fndCmd returned the cmdrecord for put
  SC3388 inSession: entered
  PC0459 parseCmd: using primary session
  CP0481 put: entered
  CP0482 put: F=1 p=FSA ARTWT=00001
  MD0656 diroutp: entered
  CC0129 setupXLMT: entered
  MD0656 diroutp: entered
  CP0889 sndFile: entered with foreignFile=junk.file,
  localName=nonexist.file
  CP3999 checkMB: entered
  GV0087 init_sfi: entered
  MR1272 set_filename: entered with pathname nonexist.file
  CP2405 mvs_sndFile: entered
  CP0636 file_check: entered
  GV0340 seq_stat_file: entered
  GV0449 seq_stat_file: lrecl=0 recfm=0 blksize=0 mode=2
  
  ======> Put for non-existent file failes
  
  EZA1684W Local file not found
  SC3339 getLastReply: entered
  CX0279 main: RC=-0001 cmd_in_progress=00027
  CX0282 main: last_reply=     err=00000
  
  ======> Return code being set to 0
  
  EZA1735I FTP Return Code = 27000, Error Code = 00000
  CZ0964 ftpQuit: entered
  CZ1009 ftpClose: entered
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release 4 IP: FTP Client  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Customer has CLIENTERRCODES TRUE coded  *
  *                      in their FTP.DATA file.  They execute   *
  *                      the FTP client with EXIT coded.         *
  *                      A put command fails and subsequent FTP  *
  *                      subcommands are not processed. The exit *
  *                      return code (condition code) should be  *
  *                      set to nonzero for a failing condition. *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The FTP client will set the error code to nonzero when the
  file can't be accessed.
  +-------------------------------------------------------------+
  + 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

• The FTP client has been corrected.
  
  * 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:

  UK02890

Modules/Macros

• EZAFTPCE EZAFTPCP EZAFTPCX
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R140 PSY UK02890

     UP05/05/24 P F505

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.