Guardian Procedure Calls Reference Manual

FILE_COMPLETE[L]_ Procedures
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Structure Definitions for completion-info
Considerations
Guardian Considerations
OSS Considerations
Related Programming Manuals
Summary
The FILE_COMPLETE[L]_ procedures complete one previously initiated I/O operation for a Guardian
file or return 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_COMPLETEL_ procedure to complete the I/O
operation initiated by the SERVERCLASS_SENDL_ procedure.
Use the FILE_COMPLETE[L]_ procedures 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[L]_ 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.
NOTE: The FILE_COMPLETEL_ procedure is supported on systems running H06.18 and later
H-series RVUs and J06.07 and later J-series RVUs.
Syntax for C Programmers
#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 ] );
#include <cextdecs(FILE_COMPLETEL_)>
short FILE_COMPLETEL_ ( short _far *completion-info
,[ __int32_t timelimit ]
,[ short _far *complete-element-list ]
,[ short num-complete-elements ]
,[ short _far *error-complete-element ] );
366 Guardian Procedure Calls (F)