Guardian Procedure Calls Reference Manual

FILE_COMPLETE_SET_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Structure Definitions for COMPLETE^ELEMENT
Considerations
Guardian Considerations
OSS Considerations
Summary
The FILE_COMPLETE_SET_ procedure enables a set of Guardian and Open System Services (OSS)
files for completion by subsequent calls to the FILE_COMPLETE_ procedure. (The FILE_COMPLETE_
procedure completes I/O operations for Guardian files and returns ready information for OSS
files.)
The FILE_COMPLETE_SET_ procedure accepts a set of Guardian files and OSS files. You can
designate that files be added or removed from the set of files that are enabled for completion. For
OSS files, you can specify the type of operation to be completed (read, write, or exceptions) or
change the current specification.
A related procedure, FILE_COMPLETE_GETINFO_, provides information about the set of files that
are currently enabled for completion.
Syntax for C Programmers
#include <cextdecs(FILE_COMPLETE_SET_)>
short FILE_COMPLETE_SET_ ( short *complete-element-list
,short num-complete-elements
,[ short *error-complete-element ] );
Syntax for TAL Programmers
error := FILE_COMPLETE_SET_ ( complete-element-list ! i
,num-complete-elements ! i
,[ error-complete-element ] ); ! o
Parameters
complete-element-list
input
INT .EXT:ref:*(ZSYS^DDL^COMPLETE^ELEMENT^DEF)
is an array of COMPLETE^ELEMENT structures. Each structure describes one Guardian file or
OSS file that the caller wants to add to or remove from the set of files enabled for completion.
For information on the fields of the structure, see Structure Definitions for COMPLETE^ELEMENT
(page 376).
num-complete-elements
input
INT
FILE_COMPLETE_SET_ Procedure 375