Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
error := DEVICE_GETINFOBYLDEV_ ( ldevnum ! i
,[ logical-info ] ! o
,[ logical-info-maxlen ] ! i
,[ logical-info-len ] ! o
,[ primary-info ] ! o
,[ primary-info-maxlen ] ! i
,[ primary-info-len ] ! o
,[ backup-info ] ! o
,[ backup-info-maxlen ] ! i
,[ backup-info-len ] ! o
,[ timeout ] ! i
,[ options ] ! i
,[ match-type ] ! i
,[ devname:maxlen ] ! o:i
,[ devname-len ] ! o
,[ error-detail ] ); ! o
Parameters
ldevnum
input
INT(32):value
specifies a logical device number that is used in one of these ways:
• If options.<15> is equal to 0, ldevnum designates the device for which information is
requested.
• If options.<15> is equal to 1, the procedure begins a search of devices starting with
the logical device number immediately following ldevnum.
See the options parameter.
On G-series RVUs, the logical device number of a device can change whenever a device is
configured or the system is loaded.
logical-info
output
INT .EXT:ref:*
if present and if logical-info-maxlen is not 0, points to a buffer that returns a set of
logical attributes for the specified device. The attribute values are returned in a contiguous
array.
If this parameter is present, logical-info-maxlen and logical-info-len must also
be present.
For a description of the attributes returned in logical-info, see Device Attributes and Value
Representations (page 304).
logical-info-maxlen
input
INT:value
specifies the length (in bytes) of the buffer pointed to by logical-info. If the buffer length
is too short for the full set of device attributes, the procedure returns as many values as will fit
in the buffer.
This parameter must be present if logical-info is present.
DEVICE_GETINFOBYLDEV_ Procedure (Superseded on G-series RVUs) 301