EMS FastStart Manual

Building Your Application for Event Generation
EMS FastStart Manual–133701
6-5
EGEN
Example 6-3. Syntax for the EGEN Procedure
{ status := } EGEN ( egen^record, ! i
{ CALL } [collector^file^number], ! i
[event^buffer^ptr], ! i
[tag], ! i
[event^buffer^used] ) ! o
status returned value
INT
on return, is one of the following numbers:
0 No Error
<> 0 An error occurred within Egen. Please
refer to Appendix B for the list of
warnings or errors that can be returned by
this procedure.
egen^record input
INT .EXT:ref:*
is the structure which contains the event message information.
collector^file^number input
INT:ref:1
is used to pass the file number on which to WRITEX or WRITEREADX
the event message formatted by Egen.
event^buffer^ptr input
INT .EXT:ref:1
is the address of the buffer that will contain the tokenized
event message formatted by Egen.
tag input
INT(32):value
is used to pass a tag that will be associated with the WRITEX or
WRITEREADX operation to be done by Egen.
event^buffer^used output
INT .EXT:ref:1
is used to pass back the length of the tokenized event message formatted by
Egen.