Data Definition Language (DDL) Reference Manual

SPI Tokens
Data Definition Language (DDL) Reference Manual—529431-004
7-19
Standard SPI Definitions in Token-Map Definitions
For a description of how to use these definitions in a subsystem that accepts SPI
programmatic commands, see the Distributed Name Service (DNS) Management
Programming Manual.
Standard SPI Definitions in Token-Map Definitions
SPI does not provide standard definitions for token maps; subsystems must define
their own token maps. When you define a token map, do not prefix the map-name
with the letter Z; this ensures that your token-map name will not be the same as a
current or future name supplied by HP.
SPI does provide a standard token type for all token maps. The standard token type for
token maps is ZSPI-TYP-MAP, which consists of the standard token data type ZSPI-
TDT-MAP and a token length of 255. You never refer to these definitions when you
define a token map.
Each field in an extensible structured token must have a size, a type, and an SPI null
value. It is generally good practice to specify the field type by referring to one of the
standard SPI definitions. The names of these definitions have the form:
ZSPI-DDL-name
In this form, name uniquely identifies the definition.
The file ZSPIDEF.ZSPIDDL on the disk volume chosen for your system contains the
DDL definitions for any standard SPI definitions you need. To refer to the standard
definitions, compile this file into your dictionary, using the DDL SOURCE command.
TACL
?Section map^name Struct
BEGIN
INT2 CODE VALUE v1v2;
INT MAP (0:n-3) VALUE v3, ..., vn;
END;
For the TACL data structure, the first STRUCT variable is a double-word
integer specifying the token code in the first 2 words of the token map. The
rest of the STRUCT is an integer array containing one value for each
remaining word in the token map.
pTAL or TAL
DEFINE map^name = [v1, v2, ..., vn]#;
LITERAL map^name^WLN = n;
For the pTAL or TAL data structure, each constant in the DEFINE list
specifies the value of one word in the token map. The LITERAL
map^name^WLN specifies the total number of words in the token map.
Table 7-1. DDL Data Structures Generated for Token Maps
Language Data Structure