Guardian Procedure Calls Reference Manual

\sysnum volname (blank-fill)
=subvol-name (blank-fill)file-name[4:11]
To return the name of the next file in alphabetic sequence:
$volname (blank-fill)file-name[0:3]
or
\sysnum volname (blank-fill)
subvol-name (blank-fill)file-name[4:7]
file-id (blank-fill)file-name[8:11]
When file-name returns, it contains the next file name, if any, in alphabetic sequence.
Returned Value
INT
A file-system error code that indicates the outcome of the call. Common errors returned are:
No error; next file name in alphabetic sequence is returned in file-name.0
End-of-file, there is no file in alphabetic sequence following the file name supplied in file-name.1
Invalid file name specification.13
For a list of all file-system errors, see the Guardian Procedure Errors and Messages Manual.
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.
Example
FNAME ':=' [ "$SYSTEM ", 8 * [" "]];
WHILE NOT (ERROR := NEXTFILENAME ( FNAME ) ) DO
BEGIN
.
.
.
END;
864 Guardian Procedure Calls (N)