DSM/SCM Event Management Programming Manual

Elements of SPI Messages for DSM/SCM
DSM/SCM Event Management Programming Manual529844-003
2-3
Other Tokens
Other Tokens
DSM/SCM event messages also include other tokens to provide information about the
event. This subsection briefly reviews the form these tokens can take and the elements
that make up these tokens. For more information on the construction of these tokens,
see the SPI Programming Manual.
Simple Tokens
Simple tokens are tokens whose values are single fields or fixed structures. Simple
tokens are identified by token codes. The token codes for the simple tokens used by
DSM/SCM are represented by symbolic names of the form ZPHI-TKN-name, where
name identifies the token code. For example, ZPHI-TKN-ACT-COMP-CD identifies a
simple token that specifies the completion code for an activity.
For a table of all token codes defined by DSM/SCM, see Appendix A, Token Codes.
Token Types
The token types used by DSM/SCM are represented by symbolic names of the form
ZSPI-TYP-name, where name identifies the token type. For example, the token type
ZSPI-TYP-CHAR8 represents a string of eight ASCII characters. DSM/SCM does not
define any private token types. That is, no token types have names of the form
ZPHI-TYP-name.
Throughout this manual, when a simple token is described, its token type is given.
Predefined Value Names
Many of the tokens and fields defined by DSM/SCM have predefined values. The
predefined values used by DSM/SCM are represented by symbolic names of the form
ZPHI-VAL-name, where name identifies the predefined value. For example, the
predefined value ZPHI-VAL-EVT-BUFLEN represents the recommended buffer length
for a DSM/SCM event message.
Field Types
All the field types used by DSM/SCM are SPI standard field types, so they are
represented by symbolic names of the form ZSPI-DDL-name, where name identifies
the field type. For example, the field type ZSPI-DDL-INT represents the integer data
type. Throughout this manual, when a field is described, its field type is given.
For more information on SPI tokens, their types, and their values, see the SPI
Programming Manual.