TCP/IP TELNET Management Programming Manual

Common Syntax Elements for the Subsystem
Elements of SPI Messages for the TELNET Subsystem
53474 Tandem Computers Incorporated 3–7
The actual token value can be in one of the following forms:
A single field, such as an integer or a character string
A fixed structure, which consists of a fixed number of data fields that are always
present
An extensible structure, which consists of data fields whose number can be
extended from software release to software release and may contain fields with
null (unassigned) values
Tokens having a token value that is a single field or a fixed structure are called simple
tokens. Tokens having a token value that is an extensible structure are called
extensible structured tokens.
Simple Tokens
Simple tokens—tokens whose values are single fields or fixed structures—are
identified by token codes. Simple tokens are regarded as simple because a map is not
needed to build and decode their internal structure. The token codes for the simple
tokens used by the TELNET subsystem are represented by symbolic names having the
form Zsss-TKN-name, where sss is a three-character subsystem abbreviation and name
identifies the token code. For example, the token code ZTNT-TKN-STATUS-PROC
identifies a simple token that indicates the current summary state of the PROC object.
All the token codes defined by the TELNET subsystem (token codes with names
having the form ZTNT-TKN-name) are listed in Section 5, “Common Definitions.”
Extensible Structured Tokens
Extensible structured tokens—tokens whose values are extensible structures—are
identified by token maps. The token maps for the extensible structured tokens used by
the TELNET subsystem are represented by symbolic names having the form Zsss-
MAP-name, where sss is a three-character subsystem abbreviation and name identifies
the token map. For example, the token map ZTNT-MAP-INFO-WIN identifies an
extensible structured token that contains all the dynamic parameters for the specified
window.
Extensible structured tokens are declared in the DDL files for each subsystem. In an
extensible structured token, you may find fields whose values are given by predefined
value names. See “Predefined Value Names” later in this subsection for the form of
these predefined value names.
Refer to Section 5, “Common Definitions,” for all the token maps defined by the
TELNET subsystem.
Note that extensible structured tokens do not appear in any event message issued by
the TELNET subsystem.
Token Types
The token types used by the TELNET subsystem are represented by symbolic names
having the form Zsss-TYP-name, where sss is a three-character subsystem abbreviation