Use this panel to customize settings related to FTP client return codes.
An FTP client enters the FTP environment by issuing the ftp command. If you issue the ftp command with the option ( EXIT, ( EXIT=nn, or, if executing from UNIX System Services, the -e option, you enable the FTP client return code function. This results in closing the FTP environment for certain FTP errors, and setting return codes for the client.
If you do not specify the ( EXIT, ( EXIT=nn, and -e options on the ftp command line, the client's FTP environment will not end if an error occurs, and the client's return code will always be set to 0.
The format of the return code and how the return code is seen by the client depend both on the customization settings from this panel and the client's execution environment.
For clients running interactively from TSO or the z/OS UNIX System Services shell, the client sees message EZA1735I when an error occurs. EZA1735I shows a 2 digit client error code, the failing FTP subcommand, and a 3 digit reply code. The 2 digit client error codes and FTP subcommands are described in z/OS Communications Server IP User's Guide and Commands (SC31-8780). The 2 digit client error codes are in section 'FTP client error codes' and the FTP subcommands are in section 'FTP subcommand codes'. The 3 digit reply codes are described in z/OS Communications Server IP and SNA Codes (SC31-8791) in the section 'FTPD reply codes'.
For clients running in batch mode, as TSO clists, or from REXX applications, the return codes are passed back to the client, in addition to being posted in message EZA1735I. The return codes may also be logged in SMF type 30, Step Termination, records. The format of the return codes passed to the client depends on the settings you choose in the Converting return codes (CLIENTERRCODES) section. However, the format of the return code shown in message EZA1735I is fixed and cannot be customized.
It is possible to see client return codes regardless of whether or not the ftp command option ( EXIT, ( EXIT=nn, or -e is specified. Checking the box "Report errors with message EZZ9830I" allows you to see the return codes logged in message EZZ9830I.
Steps
You have completed this panel after selecting the return code format and indicated whether you want to log return codes using message EZZ9830I.
You can find more detailed help on the following elements of this window:
Push buttons
Click OK to complete the specification.
Click Cancel to negate any entries you have made on this page.
Click Help to understand more about this panel.