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
Module