Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)

Guardian Procedure Calls Reference Manual—522629-013

3-96

CONFIG_GETINFO_BYNAME_ Procedure

(G-Series and H-Series RVUs Only)

2D Parameter error; error-detail contains the number of the first

parameter found to be in error, where 1D designates the first parameter on

the left.

3D Bounds error;

error-detail contains the number of the first parameter

found to be in error, where 1D designates the first parameter on the left.

4D Either the device or the process simulating a device detected an error;

error-detail contains the error number returned by the device. If

error-detail is -1D, the returned information is invalid.

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)

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

values in the buffer, see “Structure Definition for

common-info.”