NET/MASTER Network Control Language (NCL) Reference Manual

VALFILE2
Built-in Functions
4–96 106126 Tandem Computers Incorporated
VALFILE2 The VALFILE2 built-in function determines whether a supplied string is a valid
Guardian file name in the specified system. If so, VALFILE2 returns 1. If the string is
not a valid file name, or does not exist in the specified system, or cannot be validated
because the specified system is inoperative, VALFILE2 returns 0 (zero).
VALFILE2( 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, and 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 VALFILE1, which determines whether a supplied string is a valid
Guardian file name 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.mgncl.aline'
&RESULT = VALFILE2(&A)
In the following example, 0 (zero) is returned:
SAY VALFILE2('NCP')
In the following example, 0 (zero) is returned:
SAY VALFILE2($11data)