Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-19
FILE_COMPLETE_ Procedure
FILE_COMPLETE_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Structure Definition for completion-info
General Considerations
Considerations for Guardian Files
Considerations for OSS Files
Related Programming Manuals
Summary
The FILE_COMPLETE_ procedure completes one previously initiated I/O operation for
a Guardian file or returns ready information for one Open System Services (OSS) file.
The Guardian or OSS file is from a set of files that was previously enabled for
completion by one or more calls to the FILE_COMPLETE_SET_ procedure. Use the
FILE_COMPLETE_ procedure to:
•
Wait for the operation to complete on a particular file, on a particular set of files, or
on any Guardian file. Execution of the calling process suspends until the
completion, or a timeout, occurs. A timeout is not considered a completion.
•
Check for the operation to complete on a particular file, on a particular set of files,
or on any Guardian file. The call to FILE_COMPLETE_ immediately returns to the
calling process, regardless of whether there is a completion. If there is no
completion, an error indication is returned.
Only one file is completed with each call. If I/O on a Guardian file is completed or if an
OSS file is ready, a structure containing completion information is returned to the caller.
A related procedure, FILE_COMPLETE_GETINFO_, provides information about the
set of files that are enabled for completion.
Syntax for C Programmers
•
CEXTDECS (via the included file TNSINTH) defines 32-bit values as the typedef
__int32_t which for TNS and TNS/R compiles is defined as
long and for TNS/E
compiles is defined as
int.
#include <cextdecs(FILE_COMPLETE_)>
short FILE_COMPLETE_ ( short *completion-info
,[ __int32_t timelimit ]
,[ short *complete-element-list
,[ short num-complete-elements ]
,[ short *error-complete-element ] );