EMS FastStart Manual

Brief Review of Event Design
EMS FastStart Manual–133701
2-13
Step 10: Assign a Group Field Number to Each Field
For more information on how to build this file, see the DSM Template Services Manual.
In order to create and then compile your application template source file, you need to
know the name of the corresponding token that matches each of the application fields
you define in the ACF. These tokens are created by EMS FastStart during the generation
process and are defined in a DDL source file (for example, ATM1DDLS). The
information about these fields is also be stored in the DDL dictionary.
The name of each of these tokens is built according to these rules:
•
Each field name you define in the ACF will have two prefixes added to them. The
TAL/TACL syntax is used to describe the token names here since this is the same
syntax used by the template compiler language.
•
The first prefix added is “-TKN-”.
•
The second prefix added is the USER-VARIABLES-PREFIX parameter (for
example, ATM). See Section 4, Preparing the Application Configuration File
, for a
description of how to define the USER-VARIABLE-PREFIX.
The following examples show the token name created by the ATM example used
throughout this manual. Note that the token field name syntax is shown as TACL
compatible since this syntax will be used by the filter compiler. In this example, the
USER-VARIABLES-PREFIX is ATM.
Please refer to Appendix D, ATM Example, EVENT DEFINITION SOURCE FILE:
SATMDDL on page D-1. This is a template source file corresponding to this example in
this section.
Step 10: Assign a Group Field Number to Each Field
Assign a group field number to each field (for example, “1” in FIELD-1-NUMBER).
You can assign any number from 1 through 999. When you assign group field numbers,
you must start with “1” and continue assigning consecutive numbers (for example,
2, 3, 4...). If you try assigning group field numbers in any other way, EMS FastStart does
ACF field name Token field name
ATM-NAME ATM-TKN-ATM-NAME
ATM-LOCATION ATM-TKN-ATM-NAME-LOCATION
ATM-ACCOUNT-NUMBER ATM-TKN-ATM-NAME-ACCOUNT-NUMBER
ATM-RETRY-LIMIT ATM-TKN-ATM-RETRY-LIMIT
ATM-HW-COMPONENT ATM-TKN-ATM-HW-COMPONENT
ATM-HW-SUBCOMPONENT ATM-TKN-ATM-HW-SUBCOMPONENT
ATM-SERIAL-NUMBER ATM-TKN-ATM-SERIAL-NUMBER
ATM-SENSE-STATUS ATM-TKN-ATM-SENSE-STATUS
Note. All of the steps you have completed so far apply to both EMS and EMS FastStart.
Beginning with Step 10, Assign a Group Field Number to Each Field, the information applies
only to EMS FastStart.