Guardian Procedure Calls Reference Manual

for some returned errors, contains additional information. See Returned Value.
Returned Value
INT
Outcome of the call:
Information was successfully returned.0
(reserved)1
Parameter error; error-detail contains the number of the first parameter found to be in error, where 1
designates the first parameter on the left.
2
Bounds error; error-detail contains the number of the first parameter found to be in error, where 1
designates the first parameter on the left.
3
Device not found; error-detail contains a file-system error number.4
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 (page 304)). 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, see the Guardian
Programmer's Guide.
312 Guardian Procedure Calls (D-E)