Guardian Procedure Calls Reference Manual

DEVICE_GETINFOBYNAME_ Procedure (Superseded on G-Series RVUs)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
NOTE: On G-series RVUs, this procedure is supported for compatibility with previous software
and should not be used for new development. This procedure cannot obtain all of the physical
attributes of a device. For new development, call the CONFIG_GETINFO_BYNAME_ procedure.
The DEVICE_GETINFOBYNAME_ procedure obtains the physical and logical attributes of a device.
The device is specified by name.
Syntax for C Programmers
#include <cextdecs(DEVICE_GETINFOBYNAME_)>
short DEVICE_GETINFOBYNAME_ ( char *devname
,short length
,[ short *logical-info ]
,[ short logical-info-maxlen ]
,[ short *logical-info-len ]
,[ short *primary-info ]
,[ short primary-info-maxlen ]
,[ short *primary-info-len ]
,[ short *backup-info ]
,[ short backup-info-maxlen ]
,[ short *backup-info-len ]
,[ __int32_t timeout ]
,[ short *error-detail ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := DEVICE_GETINFOBYNAME_ ( devname:length ! i: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
,[ error-detail ] ); ! o
DEVICE_GETINFOBYNAME_ Procedure (Superseded on G-Series RVUs) 309