Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-103
CONFIG_GETINFO_BYNAME_ Procedure
(G-Series and H-Series RVUs Only)
Z^BACKUP^PHANDLE
is the process handle of the backup I/O subsystem that owns the device.
Z^RESERVED^1
is reserved.
Considerations
•
It is possible for CONFIG_GETINFO_BYLDEV_ to return an error value of 0D
(information successfully returned) while the I/O subsystem reports an error in the
Z^LOGICAL^STATUS field of the returned buffer. In that case, the
error value of
0D indicates that communication with the I/O subsystem was successful, while the
I/O subsystem logical status value reflects the status of the I/O subsystem.
•
Searching logical devices
To perform a search of logical devices, call the file-name inquiry procedures
FILENAME_FINDSTART_, FILENAME_FINDNEXT_, and
FILENAME_FINDFINISH_.
I/O Subsystems That Use the specific_info Parameter
The specific_info parameter contains information passed back from the
subsystem called by CONFIG_GETINFO_BYNAME (and the other
CONFIG_GETINFO procedures). The structure of this parameter is different
depending on which subsystem is called. The CONFIG_GETINFO_BYNAME
procedure supports the following subsystems:
•
Storage subsystem
•
ServerNet Lan Subsystem Access (SLSA) Subsystem
•
ServerNet Wide Area Network (SWAN)
Storage Subsystem
The structure returned by the storage subsystem in the specific_info parameter of
the reply consists of a header field followed by a number of path info fields.
The structure is specific to the type of device being described; for example, the
information for a magnetic disk or SCSI-IOP device contains SCSI-specific information,
and the path for a tape device contains tape-specific information, and so on.