EMS FastStart Manual

Building Your Application for Event Generation
EMS FastStart Manual133701
6-6
Complete^egen^operation
Complete^egen^operation
This procedure is used to complete the WRITEX or WRITE-READX nowaited I/O on
the collector file on behalf of the user application. Example 6-4 shows the syntax for this
procedure.
Example 6-4. Syntax for the Complete^egen^operation Procedure
{ status := } COMPLETE^EGEN^OPERATION ( collector^file^number, ! i
{ CALL } tag, ! o
[time^limit], ! i
error^detail ) ! o
status returned value
INT
on return, is one of the following numbers:
0 No Error
<> 0 An error occurred when completing the write of
the event buffer. Please refer to Appendix B
for the list of warnings or errors that can
be returned by this procedure.
collector^file^number input
INT:ref:1
is used to pass the file number on which to complete the
write/writeread operation.
tag output
INT(32) .EXT:ref:1
is used to pass back the tag associated with the operation just
completed.
time^limit input
INT(32):value
is used to pass a time limit value to the AWAITIOX procedure call.
If no value is passed, the value of -1D will be used.
error^detail output
INT:ref:1
is used to pass back the file system error if an error occurred within
this procedure.