NET/MASTER Network Control Language (NCL) Reference Manual

VALFILE1
Built-in Functions
106126 Tandem Computers Incorporated 4–95
VALFILE1 The VALFILE1 built-in function determines whether a supplied string is a valid
Guardian file name. If so, VALFILE1 returns 1; otherwise, it returns 0 (zero). The file
need not exist; only the format of the name is checked.
VALFILE1( file-spec )
file-spec
specifies the name of the file. The supplied name must be formatted as follows:
[ \ systemname . ]$ volume . subvolume . filename
In the preceding format, systemname and volume can each contain up to seven
characters. subvolume and filename can each contain up to eight characters.
The first character of each component must be alphabetic, and the remainder must
be alphanumeric. Leading spaces are not allowed.
Considerations
file-spec can contain up to 34 characters.
See also VALFILE2, which not only determines whether a supplied string is a
valid Guardian file name but also whether it exists in a specified system.
See also VALFILE3, which determines whether a supplied string is a valid
Guardian file name and returns the fully qualified Guardian file name with the
missing volume and/or subvolume names (if any) with default values.
Examples
In the following example, 1 is returned:
&A = '\sys1.$data2.mikeg.aline'
&RESULT = VALFILE1(&A)
In the following example, 0 (zero) is returned:
SAY VALFILE1('NCP')
In the following example, 0 (zero) is returned:
SAY VALFILE1($11data)