NET/MASTER Network Control Language (NCL) Reference Manual

NEXTSVOL
Built-in Functions
4–60 106126 Tandem Computers Incorporated
NEXTSVOL The NEXTSVOL built-in function returns the name of the next subvolume after the one
specified. NCL returns the subvolume names in alphabetic sequence.
NEXTSVOL( vol-spec )
vol-spec
specifies the name of the subvolume. The supplied vol-spec must be formatted
as follows:
[ \ systemname . ]$ volume . subvolume
If the system name is omitted, NCL supplies the name of the local system. The
volume and subvolume names must be given.
In the preceding format, systemname and volume can contain up to seven
characters. subvolume can contain up to eight characters. The first character of
each component must be alphabetic; the rest, alphanumeric.
Considerations
If vol-spec is invalid, or if there is no subsequent subvolume in the specified
volume, a null value is returned.
vol-spec can contain up to 26 characters.
See also NEXTFILE, which returns the name of the next file in a subvolume.
Examples
In the system on which the following example was run, NCL returned the next
subvolume name in alphabetic sequence to GMM, which was HAWKDOC:
&A = $DATA.GMM
&RESULT = NEXTSVOL(&A)
In the previous example, the subvolume GMM may or may not exist.
In the following example, NCL returned the null value "":
SAY NEXTSVOL("$DATA9.ZNNM")
In the previous example, for the system on which this built-in function was executed,
there was no subsequent subvolume.