For File Transfer Protocol (FTP), if any of the returned output parameters are not valid, the FTP server will not allow the operation. In this case, the FTP server issues the message Data from exit program for exit point &1 is missing or not valid to the job log.
For FTP, if you encounter any exception when you call the exit program, the FTP server issues this message: Exception encountered for FTP exit program &1 in library &2 for exit point &3
This table summarizes what the FTP sever will do, depending on the value of the return code (parameter 8) that is returned to the FTP server by the exit program.
| Return code | User profile (9) | Password (10) | Initial lib (11) |
|---|---|---|---|
| 0 | Ignored | Ignored | Ignored |
| 1 | (User identifier, parameter 2) | (Password, parameter 4) | (From user profile) |
| 2 | (User identifier, parameter 2) | (Password, parameter 4) | Return value |
| 3 | Return value | Return value | (From user profile) |
| 4 | Return value | Return value | Return value |
| 5 | Return value | Ignored | (From user profile) |
| 6 | Return value | Ignored | Return value |
In the table above, the values in parentheses indicate what the TCP/IP application uses for information when it ignores the output value. The entry Ignored means that it used no value; therefore return nothing for that return code value.
For the FTP server (exit point QIBM_QTMF_SVR_LOGON, application identifier 1): when the user identifier is ANONYMOUS and this exit point adds the exit program, the server issues this special reply when requesting the password: 331 Guest logon in process, send complete e-mail address as password. The application issues this message before calling the exit program.
After the application accepts the server logon, the FTP server issues this reply: 230 Guest logon accepted, access restrictions apply