Job Management Partner 1/File Transmission Server/FTP Description, Reference and Operator's Guide

fts_ftp_event_ex() - obtain the transmission-end results

Format

#include <apihead.h>
 
int fts_ftp_event_ex( int sock, FTS_FTP_API_RETDATA_EX *retdata )

Function

This function obtains the termination results of a transmission that was registered by fts_ftp_asyn_request_ex().

You can determine whether the transmission was successful by checking the trans_status member of the transmission-end information structure.

Arguments

sock

Specifies the return value of fts_ftp_open().

retdata

Specifies the address of a transmission-end information structure. It returns the termination result of transmission.

Notes

Call this function after you have called fts_ftp_open().

If transmission is not finished when this function is issued, the function waits until the transmission is finished.

Return values

TRUE Normal

FALSE Abnormal.
Acquisition of the transmission-end information failed.

A value indicating an error is set in fts_errno. The table below lists and describes the return values for error information. In the case of an error other than one listed below, the system function's error number is set. For details, see the displayed error number for the system function.

Return value of extended error information (decimal) Description Can be retried?

FTS_API_ERROR_DISCONNECT
(805306116) A connection with the JP1/FTP daemon was released. If you want to register the transmission request again, you must start the processing over from ftp_ftp_open(). No

FTS_API_ERROR_NODATA
(805306120) There is no registered transmission request. No

FTS_API_ERROR_NOTSOCK
(805306124) The return value of fts_ftp_open() might not have been set in the first argument. No

FTS_API_ERROR_LOGIC
(805306128) A logical conflict error occurred in API. No

Return value of extended error information (decimal)	Description	Can be retried?
FTS_API_ERROR_DISCONNECT (805306116)	A connection with the JP1/FTP daemon was released. If you want to register the transmission request again, you must start the processing over from ftp_ftp_open().	No
FTS_API_ERROR_NODATA (805306120)	There is no registered transmission request.	No
FTS_API_ERROR_NOTSOCK (805306124)	The return value of fts_ftp_open() might not have been set in the first argument.	No
FTS_API_ERROR_LOGIC (805306128)	A logical conflict error occurred in API.	No

[Contents][Back][Next]

[Trademarks]

TRUE	Normal
FALSE	Abnormal. Acquisition of the transmission-end information failed.