ftp_copy

	status.i4.v = ftp_copy(ftp_command.i1a.r [,user_name.i1a.r]
			       [,password.i1a.r] [,host_name.i1a.r]
			       [,use_alt_ftp.i4.v] [,options.u4.v])

	This routine allows an application program to submit an	ftp
	(file transfer protocol) command.

	ftp_command	ftp command file name
	[user_name]	null terminated user name (default is NULL which
			results in an anonymous transfer)
	[password]	null terminated password (default is NULL)
	[host_name]	host name to connect to  (This must be specified
			if the user name and password are supplied when
			using the alternate FTP client.) (default is NULL)
	[use_alt_ftp]	flag indicating whether or not to use an
			alternate FTP client (This is done sometimes
			if the default FTP client cannot communicate
			properly with a particular node.)
			(TRUE -> use alternate FTP client,
			 FALSE -> use the default FTP client (default))
                       This option applied to VMS where there were two
                       somewhat broken FTP implementations that worked
                       to some degree in different scenarios.  Under
                       Linux there is a single presumably working FTP
                       implementation, therefore this argument is always
                       treated as FALSE, because only the primary
                       FTP allowed a NULL hostname with an explicit
                       user and password.
	[options]	function options
			(FTP_XFER_OPT_NONE -> no options selected(default),
			 FTP_XFER_OPT_NO_DISPLAY -> don't display transfer
						    status in a window)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		no host name supplied when using the alternate
				FTP cient and user name supplied
	CBS_NOTOPN		error creating temporary command file
	CBS_NO_SUCH		directory or file not found
	CBS_NOTENB		system request failed or
				not enabled on this console
	CBS_NODAT		FTP command failed

	This function requires the following include files:

	cbslib_h

	Related functions:

	None

	C/C++ usage:

	static const char	ftp_command[] = "ftp.com";
	static const char	user_name[] = "user";
	static const char	password[] = "pass";
	static const char	host_name[] = "ftphost";
	int	status;
	int	use_alt_ftp = FALSE;
	unsigned int	options = FTP_XFER_OPT_NONE;

	status = ftp_copy(ftp_command,user_name,password,host_name,
			  use_alt_ftp,options);