Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual522629-013
5-32
FILE_COMPLETE_SET_ Procedure
General Considerations
Each file that is enabled for completion is enabled for multiple completions until
your program removes it from the enabled set or closes it. Completion on a file
does not remove it from the set of enabled files.
If the FILE_COMPLETE_SET_ procedure returns an error indication, the request
(adding or removing the file from the enabled set) is not performed. Adding a file
that is already in the enabled set does not result in an error; the call finishes
successfully. Removing a file that is not in the enabled set does not result in an
error; the request is ignored and the call finishes successfully.
Considerations for Guardian Files
A Guardian file specified to the FILE_COMPLETE_SET_ procedure is rejected if it
has not been opened in a nowait manner.
Considerations for OSS Files
An OSS file specified to the FILE_COMPLETE_SET_ procedure is rejected if it is
not one of the supported file types. The supported OSS file types are the same as
those supported by the OSS
select() function. Refer to the select(2)
function reference page either online or in the
Open System Services System Calls
Reference Manual for additional information.
OSS files can be opened blocking or nonblocking.
An OSS child process does not inherit possession of a set of enabled files from the
parent process. Membership in a set of enabled files is not propagated to an OSS
file that is created by the OSS
dup() function.