Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-57
DEVICE_GETINFOBYLDEV_ Procedure
(Superseded on G-series Releases)
•
The parameter maxlen specifies the maximum length in bytes of the character
string pointed to by
devname. The actual length of the name returned in devname
is returned in
devname-len. All three of these parameters must either be
supplied or be absent.
Syntax for TAL Programmers
Parameters
error returned value
INT
indicates the outcome of the operation. It returns one of the following values:
0 Information was successfully returned.
1 (reserved)
2 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.
3 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.
4 Device not found;
error-detail contains a file-system error number.
5 Buffer too small. This error applies only to the
devname:maxlen parameter.
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
,[ match-subtype ] ! i
,[ devname:maxlen ] !
o:i
,[ devname-len ] ! o
,[ error-detail ] ); ! o