NET/MASTER Network Control Language (NCL) Reference Manual
VALFILE3
Built-in Functions
4–98 106126 Tandem Computers Incorporated
Examples
Table 4-5 summarizes combinations of
file-spec
and
subvol-spec
. The table
operates as if nodes \SYS1 and \SYS2 exist, and node \SYS3 does not exist. The table
assumes a default subvolume of $X.Y.
Table 4-5. Examples of VALFILE3
file-spec subvol-spec
VALFILE3 Returns Comment
C null $X.Y.C Valid.
B.C null $X.B.C Valid.
$A.B.C null $A.B.C Valid.
\SYS1.C null \SYS1.$X.Y.C The node name is returned if provided in
file-spec
.
\SYS1.B.C null \SYS1.$X.B.C The node name is returned if provided in
file-spec
.
\SYS1.$A.B.C null \SYS1.$A.B.C The node name is returned if provided in
file-spec
.
C $V.S $V.S.C Valid.
B.C $V.S $V.B.C Valid.
$A.B.C $V.S $A.B.C Valid.
C \SYS2.$V.S \SYS2.$V.S.C The node name is returned if provided in
subvol-spec
.
B.C \SYS2.$V.S \SYS2.$V.B.C The node name is returned if provided in
subvol-spec
.
$A.B.C \SYS2.$V.S \SYS2.$A.B.C The node name is returned if provided in
subvol-spec
.
\SYS1.C \SYS2.$V.S \SYS1.$V.S.C If
file-spec
and
subvol-spec
include a node name, the
first node name takes precedence.
\SYS1.B.C \SYS2.$V.S \SYS1.$V.B.C If
file-spec
and
subvol-spec
include a node name, the
first node name takes precedence.
\SYS1.$A.B.C \SYS2.$V.S \SYS1.$A.B.C If
file-spec
and
subvol-spec
include a node name, the
first node name takes precedence.
\SYS1.$A.B $V.S null
file-spec
is invalid.
$A.B $V.S null
file-spec
is invalid.
$A $V.S null
file-spec
is invalid.
C $V null
subvol-spec
is invalid.
B.C $V null
subvol-spec
is invalid.
$A.B.C $V null
subvol-spec
is invalid.
C S null
subvol-spec
is invalid.
B.C S null
subvol-spec
is invalid.
$A.B.C S null
subvol-spec
is invalid.
\SYS3.C $V.S \??.$V.S.C \SYS3 does not exist in the network; therefore, \?? is returned.
\SYS3.B.C $V.S \??.$V.B.C \SYS3 does not exist in the network; therefore, \?? is returned.
\SYS3.$A.B.C $V.S \??.$A.B.C \SYS3 does not exist in the network; therefore, \?? is returned.
C \SYS3.$V.S \??.$V.S.C \SYS3 does not exist in the network; therefore, \?? is returned.
B.C \SYS3.$V.S \??.$V.B.C \SYS3 does not exist in the network; therefore, \?? is returned.
$A.B.C \SYS3.$V.S \??.$A.B.C \SYS3 does not exist in the network; therefore, \?? is returned.