Guardian Procedure Calls Reference Manual
In the C ZSYSC file, the structure for the completion_info parameter is defined as:
typedef struct __zsys_ddl_completion_info {
short z_filetype;
long z_error;
long z_fnum_fd;
union {
struct {
short filler_0:15;
unsigned short filler_1:1;
short filler_2:13;
unsigned short z_read_ready:1;
unsigned short z_write_ready:1;
unsigned short z_exception:1;
} z_return_value;
unsigned long z_completion_type;
long z_count_transferred;
} u_z_return_value;
long z_tag;
} zsys_ddl_completion_info_def;
Z^FILETYPE
returns the file type of the file that was completed by this call. This field can have these values:
The file is a Guardian file.0
The file is an OSS file.1
Z^ERROR
returns a file-system error number for the completion on this file.
Z^FNUM^FD
returns the Guardian file number or OSS file descriptor of the file completed by this call.
Z^COMPLETION^TYPE
returns the type of operation completed on an OSS file. More than one state can be ready.
(For Guardian files, this space is replaced by Z^COUNT^TRANSFERRED.)
Z^COMPLETION^TYPE contains these fields:
Z^READ^READY
can have these values:
Read is not ready for this file.0
Read is ready for this file.1
Z^WRITE^READY
can have these values:
Write is not ready for this file.0
Write is ready for this file.1
Z^EXCEPTION
can have these values:
No exception occurred for this file.0
An exception occurred for this file.1
370 Guardian Procedure Calls (F)