Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Glossary
Safeguard Management Programming Manual—422086-028
Glossary-18
symbolic name
to states. Examples of summary states are STARTED, STOPPED, SUSPENDED,
ABORTING, and DIAGNOSTIC.
symbolic name. A name used in programs to refer to a value or a variable. HP provides
definition files that declare symbolic names for values, token codes, token maps,
extensible structures, and other related variables used in management applications.
syntax token. A token whose function is not to provide information for a command or
response but to bracket or group other tokens. Its use is analogous to that of a
punctuation symbol. The tokens that begin and end lists (the list tokens) are syntax
tokens. See also parameter token and information token.
token. In SPI, a distinguishable unit in an SPI message. Programs place tokens in an SPI
buffer using the SSPUT procedure (except for header tokens, which are a special
case), and retrieve them from the buffer with the SSGET procedure. A token has two
parts: an identifying code, or token code, and a token value. For command and
response messages, a token normally represents a parameter to a command, an item
of information in a response, or control information for the subsystem. For event
messages, a token normally represents an item of information about an event or about
the event message itself. In TACL, an entity recognized by the #ARGUMENT built-in
function when parsing an argument string passed to a routine.
token code. In SPI, a 32-bit value that, as the first part of a token, allows any token to be
identified and located within an SPI message. A token code consists of a token type
(16 bits) and a token number (16 bits). In TAL, C, TACL, and COBOL, names are used
to represent token codes (ZSPI-TKN-SSID, for example). In DDL, a special definition
(using the TOKEN-CODE statement) that the DDL compiler will translate into an SPI
token code. See also token map and qualified token code.
token data type. The part of the token code that defines the kind of value (such as an
integer or a file name) allowed for a token.
token length. The part of a token code that indicates the length in bytes of the
corresponding token value. A token length of 255 indicates that the token value has
variable length or a length greater than 254. In this case, the first word of the token
value contains the (noninclusive) byte length of the rest of the token value.
token map. In SPI, a structure that contains decoding information for an extensible
structured token. Also, a variable name used to reference an extensible structured
token. The token map includes a token code and a description of the token value: its
fields, the null values of those fields, and the versions of the fields. A token map
defines a structure that might change in some later code version (by the addition of
new fields at the end), and the information in the map allows SPI to provide
compatibility between different structure versions. In DDL, a special definition (using
the TOKEN-MAP statement) that the DDL compiler will translate into an SPI token
map.