EMS FastStart Manual

Preparing the Application Configuration File

EMS FastStart Manual–133701

4-7

Field Definitions

For each field defined in the ACF, you need to specify three things: the field name, the

field type, and the field number. Each must share the same value for X, the group field

number. For example:

The field name, type, and number are always defined as a group. The “x” represents the

group field number.

The group field number “X” is replaced by an integer value for each different field.

Valid values for “X” are 1 through 9990. Numbers from 9991 through 9998 are reserved

by EMS FastStart. The first “X” value must be 1 and the values must continue

sequentially (2, 3, 4, 5, etc.).

Fields 1 and 2 are defined as follows in the sample ACF:

For more information, see the Distributed Systems Management (DSM) Programming

Manual.

Adding Data Types with EXTRADDL

If you need a data type not found in the standard types supported by EMSFS, you can

define another in the EXTRADDL file.

EMS FastStart provides a DDL source file to allow you to expand on the basic data

types allowed. New data types are defined in the DDL source file, EXTRADDL, located

in the EMS FastStart distribution subvolume. Only character fields can be defined in the

EXTRADDL. EMS FastStart automatically sources in the EXTRADDL file during the

main DDL compilation step. The name of the new data type you define should always

be of the form ZSPI-DDL-CHAR*, where the asterisk (*) represents the number of

characters you define. For example, ZSPI-DDL-CHAR20.

The EXTRADDL file contains a definition for the ZSPI-DDL-CHAR254 data type. You

can add a new data type to the EXTRADDL file by adding a section that defines the new

data type. The sample code in Example 4-2

shows the EXTRADDL file with added code

for a new data type, CHAR20. To add your own data types, use this code as a guide.

FIELD-x-NAME field-x-name

FIELD-x-TYPE field-x-type

FIELD-x-NUMBER field-x-number

FIELD-1-NAME atm-name

FIELD-1-TYPE ZSPI-DDL-CHAR8

FIELD-1-NUMBER 100

FIELD-2-NAME atm-location

FIELD-2-TYPE ZSPI-DDL-CHAR24

FIELD-2-NUMBER 200