Generator Specifications
K
A
DAK
359
C.3 System Configuration Template
The System Configuration Template is an assembly language source file which defines a
System Configuration Module for any system using AMX and its managers. It is
recommended that you list file AM831CG.CT and examine it carefully before trying to read
this description.
The template file consists of KADAK macro definitions for all of the various components
of a System Configuration Module. The macro definitions are followed by code
generating instances of these macros. Conditional assembly is used to inhibit elements in
the module which are not required if the corresponding AMX option has not been
selected.
A KADAK macro consists of a macro definition statement, a body of source language
statements and directives and a macro end statement. The macro definition and end
statements are a special pair of directives defined by KADAK.
A simple example is shown below.
;~...MAC ...TMR PROC,PERIOD,PARAM,TAG,TMID
EXTRN ~1~:FAR ;Timer Procedure
IF ~P3~
EXTRN ~3~:FAR ;Timer parameter
ENDIF
;~...ENDM
The macro definition statement contains a macro directive ([~...MAC), a parameter
keyword (...TMR) and an optional comment string (PROC,PERIOD,etc.). These three
fields are separated by one or more space and/or tab characters.
The macro directive must start in the first column. The first character of the directive
must be the comment character used by the assembler. For Intel compatible assemblers,
that character is ;.
The second character in the directive is the parameter delimiter character. This can be
any printable character but is reserved exclusively for identifying parameters within the
body of the macro. It must not appear in any other context within the macro body. For
instance, we could not have used the character : since it appears in the EXTRN directives.
We have chosen the character ~ because it is not required in any of the macro definitions
in the System Configuration Template.
Immediately after the parameter delimiter character comes the macro definition keyword
...MAC.
The parameter keyword (...TMR) identifies a particular keyword in the User Parameter
File which contains the parameter list needed for expansion of the macro body.
The comment string is optional and is normally used to provide a descriptive list of the
macro parameters. The comment string is not used in the parameter substitution process.