NET/MASTER Network Control Language (NCL) Reference Manual

NEXTFILE
Built-in Functions
4–58 106126 Tandem Computers Incorporated
NEXTFILE The NEXTFILE built-in function returns the name of the next file after the one
specified; optionally, NCL can return further detailed information about the file. NCL
returns the next file name in alphabetic sequence within the subvolume.
NEXTFILE( file-spec [, detail ] )
file-spec
specifies the name of the file. The supplied file-spec must be formatted as
follows:
[ \ systemname . ]$ volume . subvolume [ . filename ]
If the system name is omitted, NCL supplies the name of the local system. The
volume and subvolume names must be supplied.
In the preceding format, systemname and volume can contain up to seven
characters. subvolume and filename can contain up to eight characters. The
first character of each component must be alphabetic; the rest, alphanumeric.
detail
specifies an optional letter.
N
specifies that only the name of the next file is returned. This is the default.
F
specifies that full details are returned. The details are returned in a string that
contains the following space-delimited values:
the name of the file
the file code
the number of bytes in the file
the date and time the file was last changed
the owner of the file
the access codes