EMS FastStart Manual

Building Your Application for Event Generation
EMS FastStart Manual133701
6-11
EGEN Default Values
EGEN Default Values
EGEN default values are used by the EGEN procedure to determine if information
should be added to the event buffer. EGEN compares the value of each field defined in
your ACF against a set of default values. Each field type supported by EGEN has a
specific default value.
Before generating an event, an application always initializes all fields of the egen-record
(the egen-record contains all the fields declared in the ACF) with default values. This is
done with the initialize^egen^record procedure. The following values are entered into
the field types:
These default values were assigned because they represent values which are unlikely to
occur during the course of running an application. If the actual value passed to EGEN
differs from the default value, that new value is passed to the event message buffer. If the
actual value matches the default value, EGEN assumes nothing has changed, and no
value is added to the event buffer. The objective is to supply information which does not
match the default values. If you feel that one of the EGEN default values may in fact
match a legitimate value passed by an event, change the default value for that field type.
If you do not do this, variable data will be missing from your event message buffer.
Example
Table 6-4 shows the contents of the following fields after a call to the
initialize^egen^record procedure.
Field type EGEN Default Values
ZSPI-DDL-INT 32767
ZSPI-DDL-INT2 2147483647
ZSPI-DDL-INT4 9223372036854775807
ZSPI-DDL-UINT 65535
ZSPI-DDL-ENUM 32767
ZSPI-DDL-TRANSID 9223372036854775807
ZSPI-DDL-TIMESTAMP 9223372036854775807
Table 6-4. Field Content After Call to Initialize^egen^record Procedure (page 1
of 2)
FIELD-NAME FIELD-TYPE FIELD-VALUE
ATM-NAME ZSPI-DDL-CHAR8 8 spaces
ATM-LOCATION ZSPI-DDL-CHAR24 24 spaces
ATM-ACCOUNT-NUM ZSPI-DDL-INT2 2147483647
ATM-RETRY-LIMIT ZSPI-DDL-INT 32767
ATM-HW-COMPONENT ZSPI-DDL-CHAR24 24 spaces