Guardian Procedure Errors and Messages Manual

On D-series releases, file-system error information is also available using one of the procedures
described in Table 3.
Table 3 D-Series Error Information Procedures
When to UseProcedure
To obtain information about a file using the file number (filenum).FILE_GETINFO
To obtain information about a file using the file number (filenum).FILE_GETINFOLIST_
To obtain information about a file using the file name (file-name). If you call
FILE_GETINFOBYNAME_ in a waited manner, the system returns the information in
FILE_GETINFOBYNAME_
the procedure output parameters. However, if you call this procedure in a nowait
manner, the system returns the information in the system message -108 (nowait
FILE_GETINFOBYNAME_ completion), which is described in “System Messages”.
To obtain information about a file using the file name (file-name).FILE_GETINFOLISTBYNAME_
For more information on errors related to terminals, line printers, tape drives, card readers,
interprocess communication, and the operator console, see the Guardian Programmer's Guide.
For more information about interprocess communication errors that can occur when applications
use the Subsystem Programmatic Interface (SPI), see the SPI Programming Manual.
File-system errors returned by the data communications subsystems can have special meanings
depending on the particular subsystem, access method, or protocol being used. After obtaining
the device type associated with the error, see Appendix A of the Guardian Procedure Calls
Reference Manual to determine which subsystem is involved and see the appropriate manual for
the subsystem.
NOTE: In the error code descriptions, if a device-type number includes a dot (.), the digits to the
left of the dot are the device type and the digits to the right of the dot are the device subtype.
Error Mapping to C Language errno Values
Some Guardian file-system errors map to corresponding C language error numbers. These error
numbers are returned in the errno value when using the C programming language. For a list of
file-system errors and their corresponding C errno values, see Table 4.
Table 4 Guardian File-System Errors Mapped to C Errors
C errno Symbolic NameFile-System Error
ENOERR0-1
ENOENT2
EIO4
ENOENT11
EGUARDIANOPEN12
ENOENT13-15
EBADF16
ENOENT18
EINVAL21
EFAULT22
EPERM24
EINVAL29
ENOMEM31-37
20 File-System Errors