NET/MASTER Network Control Language (NCL) Reference Manual

VALDEV2
Built-in Functions
4–94 106126 Tandem Computers Incorporated
VALDEV2 The VALDEV2 built-in function determines whether a supplied string is a valid
Guardian device name in the specified system. If so, VALDEV2 returns 1. If the string
is not a valid device name, or does not exist in the specified system, or cannot be
validated because the specified system is inoperative, VALDEV2 returns 0 (zero).
VALDEV2( device-spec )
device-spec
specifies the device name. The supplied device name must be formatted as
follows:
[ \ systemname . ]$ device [ .# subdevice [ . qualifier ] ]
In the preceding format, systemname , device , and subdevice can contain up
to seven characters. qualifier can contain up to eight characters. The first
character of each component must be alphabetic, and the remainder must be
alphanumeric.
Considerations
If the system name is omitted, NCL uses the name of the local system.
device-spec can contain up to thirty-four characters.
See also VALDEV1, which determines whether a supplied string is a valid device
name in a specified system.
Examples
In the following example, 0 (zero) is returned:
&A = '\sys1.$sna03.#term03'
&RESULT = VALDEV2(&A)
In the following example, 0 (zero) is returned:
SAY VALDEV2('#term7')
In the following example, 1 is returned:
SAY VALDEV2($atp7.#term1)