Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-33
NEXTFILENAME Procedure
(Superseded by FILENAME_FINDNEXT_
0 No error; next file name in alphabetic sequence is returned in file-name.
1 End-of-file, there is no file in alphabetic sequence following the file name
supplied in
file-name.
13 Illegal file name specification.
Refer to the
Guardian Procedure Errors and Messages Manual for a list of all file-
system errors.
file-name input, output
INT:ref:12
on the call, is the internal-format file name from which the search for the next file
name begins.
file-name on the initial call can be one of the following forms.
To obtain the name of the first file on
$volname:
file-name[0:11] $volname (blank-fill)
or
\sysnum volname (blank-fill)
To obtain the name of the first file in
subvol-name on $volume:
file-name
[0:3] $volname (blank-fill)
or
\sysnum volname (blank-fill)
file-name[4:11] = subvol-name (blank-fill)
To return the name of the next file in alphabetic sequence:
file-name[0:3] $volname (blank-fill)
or
\sysnum volname (blank-fill)
file-name[4:7] subvol-name (blank-fill)
file-name[8:11]
file-id
(blank-fill)
When
file-name returns, it contains the next file name, if any, in alphabetic
sequence.
Considerations
•
The NEXTFILENAME procedure can be used to search for files on HP NonStop™
Storage Management Foundation (SMF) virtual volumes. However, the names in
the special SMF subvolumes (ZYS* and ZYT*) where SMF physical files reside are
not returned.