Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-115
CONFIG_GETINFO_BYNAME2_ Procedure
(G-Series and H-Series RVUs Only)
Syntax for TAL Programmers
Parameters
error returned value
INT(32)
indicates the outcome of the operation. It returns one of the following values:
0D Device found and data is returned. The value of
error-detail is set to
zero. Only if error is returned as zero will there be any meaningful data in
common-info or specific-info.
1D Device or subtype 30 process returned an error. The error is reported in
error-detail. An error-detail value of 40 indicates that the I/O
process did not respond within the timeout interval. An
error-detail
value of 14 indicates that the device was not found.
2D Required parameter is invalid. The value of
error-detail is set to the
ordinal number of the invalid parameter.
3D Bounds error; a reference parameter contained an illegal address. The
value of
error-detail is set to the ordinal number of the invalid
parameter.
4D Device returned error or invalid data to the inquiry. If
Error-detail is -
1, then the device returned zero and the response is invalid. Otherwise,
error-detail is the value of the error returned to the inquiry by the
device.
error := CONFIG_GETINFO_BYLDEV2_ (
ldevnum ! i
,common-info ! o
,common-maxlen ! i
,common-len ! o
,specific-info:specific-maxlen ! o:i
,specific-len ! o
,timeout ! i
,error-detail ); ! o
error := CONFIG_GETINFO_BYNAME2_ (
devname:length ! i
,common-info ! o
,common-maxlen ! i
,common-len ! o
,specific-info:specific-maxlen ! o:i
,specific-len ! o
,timeout ! i
,error-detail ); ! o