EMS FastStart Manual

Building Your Application for Event Generation

EMS FastStart Manual–133701

6-4

EGEN

The EGEN procedure accepts a record structure from the user application and formats a

tokenized event buffer based on the information received. The EGEN mode is a function

of the combination of parameters passed to EGEN by the application. Sample syntax for

EGEN procedure is shown in Example 6-3.

Example 6-2. Syntax of the Open^egen^collector Procedure

{ status := } Open^egen^collector ( collector^file^number, ! o

{ CALL } [sync^depth], ! i

error^detail ) ! o

status returned value

INT

on return, is one of the following numbers:

0 No Error

<> 0 An error occurred when opening the collector.

Please refer to Appendix B for the list of

warnings or errors that can be returned by this

procedure.

collector^file^number output

INT:ref:1

is used to pass back the filenumber which was opened by this

procedure.

sync^depth input

INT:value

is used to specify a sync depth value used when opening the collector.

If not specified, a value of one is assumed.

error^detail output

INT:ref:1

is used to pass back the file system error if an error occurs

within this procedure.