NET/MASTER Network Control Language (NCL) Reference Manual

NEXTFILE
Built-in Functions
106126 Tandem Computers Incorporated 4–59
Considerations
Names of temporary files are not returned.
If the file name is omitted, NCL returns the first file name in the subvolume.
If the file name is invalid, or if there is no next file in the specified subvolume, a
null value is returned.
file-spec can contain up to 34 characters.
See also NEXTSVOL, which returns the name of the next subvolume.
Examples
In the system on which the following example was run, no file name was specified,
and NCL returned the file name CONFIG, which was the first file in the specified
subvolume ZNNM:
&A = "\SYS1.$DATA8.ZNNM"
&RESULT = NEXTFILE(&A)
In the following example, full details about the file code, the file size in bytes, the date
and time the file was last modified, the owner of the file, and the access codes are
returned. The returned information is space-delimited:
&A = $DATA2.MGNCL.APROC
&RESULT = NEXTFILE(&A,F)
In the previous example, NCL returned the following string:
ASA 101 584 18-NOV-1994 15:16:16 100,36 CCCC
In the system on which this example was run, the file ASA was the one following
APROC alphabetically, in the subvolume MGNCL in the volume $DATA2.