NET/MASTER Network Control Language (NCL) Reference Manual

VALDEV1
Built-in Functions
106126 Tandem Computers Incorporated 4–93
VALDEV1 The VALDEV1 built-in function determines whether a supplied string is a valid
Guardian device name. If so, VALDEV1 returns 1; otherwise, it returns 0 (zero). Only
the format of the name is checked.
VALDEV1( 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
device-spec can contain up to 34 characters.
See also VALDEV2, which not only determines whether a supplied string is a
valid device name but also whether it exists in a specified system.
Examples
In the following example, 1 is returned:
&A ='\xyza.$sna03.#term03'
&RESULT = VALDEV1(&A)
In the following example, 0 (zero) is returned:
SAY VALDEV1('#term7')
In the following example, 1 is returned:
SAY VALDEV1($atp7.#term1)