NET/MASTER Network Control Language (NCL) Reference Manual

VALFILE3
Built-in Functions
106126 Tandem Computers Incorporated 4–97
VALFILE3 The VALFILE3 built-in function determines whether a supplied string is a valid
Guardian file name and supplies it with default values for any missing volume or
subvolume names.
VALFILE3( file-spec [, subvol-spec ])
file-spec
specifies the name of the file to be validated. The supplied name must be
formatted as follows:
[ \ systemname . ] [ [ $ volume . ] subvolume . ] filename
In the preceding format, file-spec can contain up to 34 characters; subvolume
and filename can each contain up to 8 characters. The first character of each
component must be alphabetic, and the remainder must be alphanumeric.
Leading spaces are not allowed. If the supplied string is not a valid file name,
NCL returns a null string.
subvol-spec
specifies the name of the default subvolume. The supplied name must be
formatted as follows:
[ \ systemname . ] $ volume . subvolume
In the preceding format, subvolume can 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.
If the default subvolume ( subvol-spec ) is incorrectly specified, NCL returns a
null string.
If subvol-spec is omitted, or is a null string, NCL supplies the default volume
and subvolume of the executing process.
Considerations
If file-spec or subvol-spec is in network format, NCL returns the file name
in network format. If you specify a node name, only the existence of the node is
checked (not the volume, subvolume, or file name). If the node name does not
exist, NCL returns \?? as the node name.
See also VALFILE1, which determines whether a supplied string is a valid
Guardian file name in a specified system.
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.