Diagnosing FTP client user exit problems

This section lists and describes possible problems when you install and use the FTP client security user exits.

Message EZA1555I is displayed

The FTP client displays the EZA1555I CSVDYNEX request failed for user exit exitname, RETURN CODE: x'rc REASON CODE x'rsncode' message. This occurs when a DES (Dynamic Exits Services) CSVDYNEX request for the FTP client security exits fails. For more information about the return and reason codes for CSVDYNEX macro, see Return and reason codes in z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN.

Message EZA1548I is displayed

The FTP client displays the EZA1548I User exit exitname module modname abended with abend code x'rc' and abend reason code x'rsncode' message. This occurs when an FTP client user exit ends abnormally. The MVS™ console or the system log has the information about the abend code and abend reason code. See z/OS MVS System Codes for an explanation and programmer response.

Message EZA1545I is displayed

The FTP client displays the EZA1545I Return code rc from user exit exitname module modname is ignored message in the following situations:

When the user exit routine is to modify the arguments of commands such as AUTH, EPRT, EPSV, MODE, PBSZ, PORT, PROT, REST, SITE, STRU, TYPE and XLM. Modifying these command arguments leads to unexpected failures because of desynchronization between the FTP client and server, so the modified arguments of these commands are ignored. Correct the user exit routine so that it does not modify the arguments of these commands.
When the user exit routine is to reject the QUIT command. Correct the exit routine to accept the QUIT command.
When the user exit routine is to end the FTP client when the QUIT command is from the QUIT subcommand. The FTP client ends as part of QUIT subcommand processing, and it must send QUIT to the server before the client ends. Correct the exit routine to accept the QUIT command. The exit routine does not need to end the FTP client in this circumstance.
When the user exit routine is to modify the arguments of RETR or STOR during a load module transfer. Changing the arguments of RETR or STOR during a load module transfer leads to unpredictable results. Correct the exit routine so that it does not modify the arguments of these commands when transferring a load module.
When the user exit routine is to end the FTP client and the reply is 221 Quit command received, it is from the QUIT subcommand. The FTP client always ends when it completes QUIT subcommand processing. The exit routine does not need to end the FTP client in this circumstance.
When the user exit routine is to end the FTP client and the reply starts with reply code in the range 100 - 199. It leads to unpredictable results. Correct the exit routine to accept replies with reply codes in the range 100 - 199.

The FTP client exits unexpectedly, without the user issuing a QUIT subcommand

Message EZA1546I appears: The FTP client displays the EZA1546I User exit exitname module modname ended the FTP client – exit reason code x'hexadecimal-rsncode' (decimal-rsncode) message. Inspect the optional EZA1556I and EZA1546I messages that are displayed by the FTP client to determine why the user exit routine ended the FTP client. No further action is needed if the explanation is satisfactory, and it is appropriate for the exit routine to end the FTP client. Otherwise, correct the user exit routine. See FTP client user exits in z/OS Communications Server: IP Configuration Reference for more information.
Message EZA1549I appears: The FTP client displays the EZA1549I User exit exitname module modname returned an invalid return code rc message. This occurs when the FTP EZAFCCMD client user exit returns a value in register 15 that is not 0, 4, 8 or 12, or when the FTP EZAFCREP client user exit returns a value in register 15 that is not 0 or 12. The systems programmer needs to inspect the messages displayed by the FTP client and correct the user exit routine.

The user exit routine that is installed cannot be called

The FTP client displays the EZA1555I CSVDYNEX CALL failed for user exit exitname, RETURN CODE: x'04' REASON CODE: x'00000406' message. This occurs when no active exit routine is associated with the user exit. This can happen when the exit routine ends abnormally, or is deleted by the operator while an FTP client is logged in to an FTP server. If the exit routine ends abnormally, EZA1548I provides information about the abend code and abend reason code. See Message EZA1548I is displayed for an explanation and response. Otherwise, see Return and reason codes in z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN for more information.

The FTP subcommand failed

Message EZA1532I appears: The FTP client displays the EZA1532I User exit exitname module modname modified the FTP command arguments message when the FTP EZAFCCMD client user exit modified the command arguments. If the command arguments are modified to an invalid value, the subcommand might fail. You might need to correct the user exit routine modname.
Message EZA1533I appears: The FTP client displays the EZA1533I User exit exitname module modname prevented user userid from sending command command – exit reason code x'hexadecimal-rsncode' (decimal-rsncode) message. Inspect the optional EZA1556I and EZA1533I messages that are displayed by the FTP client to determine why the user exit routine rejected the FTP command. If it is appropriate for the exit routine to reject the FTP command, no further action is needed; otherwise, correct the user exit routine modname.