z/OS Communications Server: IP Messages Volume 4 (EZZ, SNM)
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


EZZ9830I

z/OS Communications Server: IP Messages Volume 4 (EZZ, SNM)
SC27-3657-01

EZZ9830I
asname FTP failed - Cmd = cmd_code(cmd_name) Reply = reply_code exit_used rc_ type RC = computed_rc

Explanation

This message reports a failure in the FTP client. If the FTP client is running interactively, the message is displayed to the end user interface. Otherwise, the message is written to the system log and the batch job log.

In the message text:
asname
The name of the address space of the FTP client.
cmd_code
The 2-digit subcommand code of the failing subcommand; cmd_name is the name of the failing subcommand. For example:
Cmd = 16(get)
See z/OS Communications Server: IP User's Guide and Commands for information about subcommand codes.
reply_code
The last reply code received from the FTP server. If a subcommand failed before a reply was received from the server, reply_code is n/a.
exit_used
Indicates whether the client exited as a result of this error. Values are:
EX
The FTP client was configured to exit on error, and the client exited because of this error.
NX
The FTP client was not configured to exit on error, and the client did not exit because of this error.

Tip: The FTP client is configured to exit on error if you code the CLIENTEXIT TRUE statement in the FTP.DATA file, or if you specify the EXIT or EXIT=nn parameter on the FTP command when you start the FTP client.

rc_type
The type of return code displayed in computed_rc. It is one of the following:
STD
standard return code
FIX
fixed return code
CEC
client error code
CEE
client error code extended
computed_rc

The computed value used to determine the return code. In cases where no EXIT parameter was specified when starting the FTP client and the CLIENTEXIT FALSE statement was specified or defaulted to in the FTP.DATA file, this value might not match the return code observed in the FTP client. This is because the FTP client might not end when the error is reported. Also, the computed_rc reflects the return code value prior to any conversion to a value modulo 4096 in a batch job.

The computed_rc value depends on the FTP command parameters and configuration options as follows:
  • If EXIT=nn was specified as a start option on the FTP command, computed_rc is the fixed return code nn.
  • Otherwise, computed_rc is one of the following:
    • A client error code, if CLIENTERRCODES TRUE was coded in FTP.DATA. See z/OS Communications Server: IP User's Guide and Commands for a list of the client error codes.
    • A client error code concatenated with the subcommand code, if CLIENTERRCODES EXTENDED was coded in FTP.DATA.
    • A standard return code (formed by concatenating cmd_code with reply_code), if CLIENTERRCODES FALSE is specified or defaulted in FTP.DATA. In batch, this value will be converted modulo 4096 to produce the return code observed in the batch job step and recorded in the SMF TYPE 30 record.

System action

If the FTP client is configured to exit on error, the client ends. Otherwise, the client continues. The FTP client is configured to exit on error if you code the CLIENTEXIT TRUE statement in the FTP.DATA file, or if you specify the EXIT or EXIT=nn parameter on the FTP command when you start the FTP client.

Operator response

The message indicates that the FTP client program experienced an error and reports the subcommand, the error reply, and the return code related to the error. See z/OS Communications Server: IP User's Guide and Commands for information about FTP subcommands and error return codes. If you cannot correct the error, contact the system programmer.

System programmer response

See z/OS Communications Server: IP User's Guide and Commands for information about the FTP subcommand that failed. If you cannot resolve the problem, contact the IBM® software support center.

Module

EZAFTPCX

Procedure name

main

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014