12-38
Creating A Script File
FTP DIRFIRST
Syntax: FTP DIRFIRST LOCAL <filename> [<size> <mode> <modtime>
<uname> <gname>]
FTP DIRFIRST REMOTE <filename> [<size> <mode> <modtime>
<uname> <gname>]
This FTP file transfer command will get the first entry in the current local or remote
directory and place it in the previously defined string variables, where
<filename> is a previously defined string variable (see var) which will store the
name of the file. This is the only variable that must be specified, the
others are optional.
<size> is a previously defined string or integer variable which will store the
size of the file.
<mode> is a previously defined string variable which will store the mode.
<modtime> is a previously defined string variable which will store the time of the
last modification.
<uname> is a previously defined string or integer variable which will store the
user name.
<gname> is a previously defined string or integer variable which will store the
group name.
Note that if you require a value which follows one or more that are not required, you
will still need to supply variables for them. For example, if you only wanted the time
that the file was last modified, you would need to specify a variable for <size> and
<mode> as well as <modtime>.
On a UNIX system the first entry is always ".". This can be followed by one or more
ftp dirnext commands to work through the directory listing.
If the command is invalid then the variable will be set to "" (zero length).
Refer to the Error Numbers section for a list of possible error numbers.