EMS FastStart Manual

Building Your Application for Event Generation
EMS FastStart Manual–133701
6-3
Open^egen^collector
Open^egen^collector
This procedure opens the collector on behalf of the user application. It uses a run time
parameter, called a DEFINE, which allows you to select the name of the collector to
which events will be written. This DEFINE, =_EMS_COLLECTOR is discussed in
Define Run-time Parameters
on page 6-20. If this DEFINE is not used, the default
collector $0 is opened.
The defined collector (or the default collector) is opened with a default sync depth of 1
(if not otherwise specified by the caller) and for nowait I/O. Example 6-2
shows the
syntax for this procedure.
Example 6-1. Syntax for the Initialize^egen^record Procedure
{ status := } INITIALIZE^EGEN^RECORD ( egen^record ) ! i/o
{ CALL }
status returned value
INT
on return, is one of the following numbers:
0 No Error
<> 0 An error occurred when initializing the
egen^record. Please refer to Appendix B
for the list of warnings or errors that can be returned by this
procedure.
egen^record input, output
INT .EXT:ref:*
is the structure to be initialized with default values.