Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-72
DEVICE_GETINFOBYNAME_ Procedure
(Superseded on G-Series Releases)
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.
error-detail output
INT .EXT:ref:1
for some returned errors, contains additional information. See
error, earlier in
this subsection.
Considerations
•
I/O process status
The physical information that is returned in
primary-info and backup-info
includes a status field (see “Device Attributes and Value Representations,” under
the DEVICE_GETINFOBYLDEV_ procedure). This field contains a file-system
error number that indicates the result of the request for information from the I/O
process.
It is possible for DEVICE_GETINFOBYNAME_ to return an
error value of 0
(information successfully returned) while the IOP reports an error in the status field.
In that case, the
error value of 0 indicates that communication with the IOP was
successful, while the IOP status value reflects the validity of the returned
information.
Example
! obtain logical and physical information for
! the device named "$TERM11".
device^name ':=' "$TERM11";
error := DEVICE_GETINFOBYNAME_ (
device^name : 7,
l^info, l^info^maxlen, l^info^len,
p^info, p^info^maxlen, p^info^len,
b^info, b^info^maxlen, b^info^len,
8000D, error^detail );
Related Programming Manual
For programming information about the DEVICE_GETINFOBYNAME_ procedure, refer
to the
Guardian Programmer’s Guide.