Guardian Procedure Calls Reference Manual

Syntax for TAL Programmers
error := CONFIG_GETINFO_BYLDEV_ ( ldevnum ! i
,common-info ! o
,common-info-maxlen ! i
,common-info-len ! o
,specific-info:specific-info-maxlen ! o:i
,specific-info-len ! o
,timeout ! i
,error-detail ); ! o
error := CONFIG_GETINFO_BYNAME_ ( devname:length ! i
,common-info ! o
,common-info-maxlen ! i
,common-info-len ! o
,specific-info:specific-info-maxlen ! o:i
,specific-info-len ! o
,timeout ! i
,error-detail ); ! o
Parameters
ldevnum (CONFIG_GETINFO_BYLDEV_ only)
input
INT(32):value
specifies the logical device number of the device for which information is requested. The logical
device number of a device can change whenever a device is configured or the system is loaded.
Some I/O subsystems do not have a logical device number.
devname:length (CONFIG_GETINFO_BYNAME_ only)
input:input
STRING .EXT:ref:*, INT:value
specifies the name of the device for which information is requested. The value of devname
must be a local name (that is, it must not include a system name) and can have qualifiers.
The devname parameter must be exactly length bytes long.
common-info
output
INT .EXT:ref:(ZSYS^DDL^CONFIG^GETINFO)
if error is 0D and if common-info-maxlen is not 0, points to a buffer that returns a set of
logical attributes for the specified device. For information on the structure and values of the
buffer, see Structure Definitions for common-info (page 188).
common-info-maxlen
input
INT:value
specifies the length (in bytes) of the buffer pointed to by common-info. If the buffer length is
too short for the full set of device attributes, the procedure sets error to 2D, sets
error-detail to 3D, and does not return any information for the specified device.
common-info-len
output
INT .EXT:ref:1
returns the actual length (in bytes) of the buffer pointed to by common-info.
186 Guardian Procedure Calls (C)