TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-177
#FILENAMES Built-In Function
#FILENAMES Built-In Function
Use #FILENAMES to obtain all file names that satisfy a specified file-name template.
option
specifies the criteria the requested file names must meet; specify one of these
options:
MAXIMUM [ num ]
specifies the maximum number of file names to be returned on this call. If num
is omitted or is less than 1, all matching file names are returned. If num is
greater than 0, no more than num file names are to be returned; all file names
returned are in the same subvolume.
NEWSUBVOL variable-level
specifies the name of an existing variable level that is to indicate whether the
file-name search started in a new subvolume. If you include PREVIOUS, and if
the first file name returned is in the same subvolume as the file name specified
by PREVIOUS, the variable level is set to 0. In all other circumstances, the
variable level is set to -1.
PREVIOUS [ file-name ]
specifies a starting point, alphabetically, after which file names are to be
matched. It need not specify an existing file. If you omit file-name, file-name
matching starts with the first file that matches file-name-template.
file-name-template
is a file name. You may include these template characters in any field of the file
specification except the system field:
* matches zero or more characters.
? matches a single character.
Template characters cannot match a volume identifier ($) or a field separator (.).
If you omit file-name-template, #FILENAMES applies to file names in your
current subvolume.
Result
#FILENAMES returns a space-separated list of file names.
#FILENAMES [ / option [ , option ] ... / ]
[ file-name-template ]