Store a file onto a remote host – HP Integrity NonStop H-Series User Manual

Page 110

Advertising
background image

hd

file number.

host

name of the remote host.

port

port number to be used. If the port number specified < 0, the system will choose its own port
number.

user

username used to logon.

passwd

password.

acct

account to be used to log on. If acct is set to "", it is considered unspecified.

tag

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

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

Store a File onto a Remote Host

The routines FTPput and FTPput_nw store a file onto a remote host.

#include "ftpexth"
short FTPput(short hd, short proxy, char *in,char *out)
short FTPput_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

local file name. The local file must be an Enscribe disk file. It can't be a temporary file, a
running process, or a Spooler location.

out

a string containing the remote file name and a list of attributes for the remote file. You must
specify the attributes in the order indicated below, use commas as placeholders, and omit
spaces.

if "out" is left unspecified, by setting out as "", the remote file name will be the same as the
local file name (that is, in) and the file attributes take the default values.

filecode

indicates the file code of the remote file. file code is a number between 0 and 32767.
When FTP is in binary transfer mode (set by calling FTPsettype() and specifying type I), the
default file code is 0.When FTP is in ASCII mode (set by calling FTPsettype() and specifying
type A, the default file code is 101. The filecode attribute overrides the current setting of
FTPsetfilecode().

110

FTP API External Specification

Advertising
This manual is related to the following products: