Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-60
DEVICE_GETINFOBYLDEV_ Procedure
(Superseded on G-series Releases)
backup-info-maxlen input
INT:value
specifies the length in bytes of the buffer pointed to by
backup-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
backup-info is present.
backup-info-len output
INT .EXT:ref:1
returns the actual length in bytes of the buffer pointed to by
backup-info.
This parameter must be present if
backup-info is present.
timeout input
INT(32):value
specifies how many hundredths of a second the procedure should wait for a
response from the I/O process. The maximum value is 2147483647. The default
value is 6000D (one minute). A value of -1D causes the procedure to wait
indefinitely.
options input
INT:value
specifies options. The bits, when set, indicate the following:
<0:12> Reserved (specify 0)
<13> Specifies that the procedure search for the next device that has a subtype
of
match-subtype. options.<15> must be equal to 1 and match-
subtype
must be specified when this option is used.
<14> Specifies that the procedure search for the next device that has a type of
match-type. options.<15> must be equal to 1 and match-type
must be specified when this option is used.
<15> Specifies that the procedure search for the next device that matches the
selection criteria. The search begins with the logical device number
immediately following the one specified by the
ldevnum parameter. This
option can be used alone or in combination with
options.<13> or
options.<14>. See “Considerations,” later in this subsection.
The default value of
options is 0.