Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-61
DEVICE_GETINFOBYLDEV_ Procedure
(Superseded on G-series Releases)
match-type input
INT:value
if present and if not -1, specifies a device type that is to be used as a search
criterion. Supplying
match-type causes the procedure to return information for
the next device that has a device type of
match-type and a logical device
number greater than
ldevnum.
options.<14> and options.<15> must both be equal to 1 in order to use this
parameter.
match-type can also be used in combination with match-subtype. See
“Considerations,” later in this subsection.
match-subtype input
INT:value
if present and if not -1, specifies a device subtype that is to be used as a search
criterion. Supplying
match-subtype causes the procedure to return information
for the next device that has a device subtype of
match-subtype and a logical
device number greater than
ldevnum.
options.<13> and options.<15> must both be equal to 1 in order to use this
parameter.
match-subtype can also be used in combination with match-type. See
“Considerations,” later in this subsection.
devname:maxlen output: input
STRING .EXT:ref:*, INT:value
if supplied and if
maxlen is not 0, returns a local name (that is, a name that does
not include a node name) designating the device. The returned name has no
qualifiers.
If the device does not have a name, a
devname-len of 0 is returned. A devname
in the form $
logical-device-number is never returned.
maxlen specifies the length in bytes of the string variable devname.
devname-len output
INT .EXT:ref:1
returns the actual length in bytes of the name returned in
devname. If the device
does not have a name, a
devname-len of 0 is returned.
This parameter must be present if
devname is present.