DtvLong dal_gfi_put_fil (srv, cli)

Copies an ASCII or binary file from the server to the client.

Input Parameters Significance
char *srv server file name
char *cli client file name [0 = server file name]

Output Parameters Significance
none -

Return Code Significance
0 all ok
-1 no graphical interface initialized
-2 RPC buffer overrun
-3 error while opening the server file
sonst IPC return code from <ipcerr.h> or return code of the system function fwrite if dal_gfi_put_fil was executed in synchronous communication mode (dal_gfi_set_ipc 'W')

The maximum record width allowed for the ASCII-file to be transmitted is 256 characters.

In order to transmit binary files the binary mode can be set via dal_gfi_bin_fil prior to calling dal_gfi_put_fil. After the transmission the system is always automatically reset to ASCII mode.

Empty files (size of 0 bytes)are never copied.

Note! With the default setting of the server timeout and normal ISDN transfer rate in the network you can transfer files up to size of about 20 MB without any risk. But please note that the transfer time generally depends on the performance of the participating computers, on the quality of your network connections, and on the setting of the server timeout. Transmission will be cancelled, whenever the server timeout has been reached.