Send arguments to remote host, Rename file on remote computer, Retrieve the reply text – HP Integrity NonStop H-Series User Manual

Page 112

Advertising
background image

limit

maximum number of bytes the buffer can hold. If returned data size exceeds the buffer size,
then error number will be set to TRUNCATED, and the return data is set to the size of limit.

tag

parameter to be used for the GUARDIAN nowait operation initiated by FTPpwd_nw.

The return value is -1 if the routine fails. The error number is set accordingly.

Send Arguments to Remote Host

The routines FTPquote and FTPquote_nw send specific arguments verbatim to the remote host.

#include "ftpexth"
short FTPquote(short hd, short proxy, char *cmd)
short FTPquote_nw(short hd, short proxy, char *cmd,
long tag)

hd

file number.

proxy

1, this command applies to the proxy connection.

0, this command applies to the primary connection.

cmd

arguments to be sent to remote host.

tag

parameter to be used for the Guardian nowait operation initiated by FTPquote_nw.

The return value is -1 if the routine fails. The error number is set accordingly.

Rename File on Remote Computer

The routines FTPrename and FTPrename_nw rename a file on a remote machine.

#include "ftpexth"
short FTPrename(short hd, short proxy, char *in,
char *out)
short FTPrename_nw(short hd, short proxy, char *in,
char *out, long tag)

hd

file number.

proxy

1, this command applies to the proxy connection.

0, this command applies to the primary connection.

in

name of the file to be renamed

out

new file name.

tag

parameter to be used for the Guardian nowait operation initiated by FTPrename_nw.

The return value is -1 if the routine fails. The error number is set accordingly.

Retrieve the Reply Text

The routines FTPreplytext and FTPreplytext_nw retrieve the reply text.

112

FTP API External Specification

Advertising
This manual is related to the following products: