TACL Reference Manual

UTILS:TACL Commands and Functions

HP NonStop TACL Reference Manual—429513-018

8-71

FILENAMES Command

Use the FILENAMES command to display the names of all files that satisfy the file-

name specifications in the file-name-template. The FILENAMES command is an

alias for the #XFILENAMES built-in function.

OUT list-file

specifies a device, or a sequential file accessible to the sequential I/O (SIO) facility,

that is to receive the output from FILENAMES. If you omit this option, TACL writes

the listing to its current OUT file.

If you specify an OUT file that does not exist, TACL creates an EDIT file named

list-file. If you specify an OUT file that already exists, TACL appends the

information to the end of the file.

file-name-template

is a list of one or more disk file specifications separated by commas or spaces.

Each disk file specification must be formatted as follows:

[[[\ node-name.]$ volume-name.] subvolume-name.] file-name

For a description of file-name templates, see Section 2, Lexical Elements.

Consideration

If you do not include any file-name template, FILENAMES lists all files in your default

volume and subvolume.

Examples

This example illustrates the output of the FILENAMES command:

17> FILENAMES $BOOKS.TACL.SEC*

$BOOKS.TACL

SEC01 SEC02A SEC02B SEC02C SEC02D

18>

The asterisk in the file-name template instructs FILENAMES to display the names of all

files that begin with SEC, regardless of which, or how many, characters follow.

This example illustrates the use of two file-name template characters. The asterisk (*)

in the subvolume indicates that you want TACL to search for any subvolume that

begins with BOOK. The question mark (?) in the file name indicates that you want to

FILENAMES [ / OUT list-file / ]

[ file-name-template [ [,] file-name-template ] ... ]