EM3270 Manual

Tandem EM3270 Manual—110332 I-1
I
Common Definitions
The management application programming interface to the EM3270 subsystem uses a
predefined set of tokens, token types, token values, and other data structures.
This set of standard definitions is obtained from four sources:
•
SPI (Subsystem Programmatic Interface) standard definitions
•
EMS (Event Management Service) standard definitions
•
Data communications standard definitions
•
EM3270 standard definitions
The following paragraphs discuss those definitions used by an EM3270 management
application program that have a common meaning in all instances where they are used.
This section contains general information that applies to all uses of the common
definitions in the interfaces to the EM3270 subsystem.
Tandem provides each set of standard definitions in the form of a file of DDL (data
definition language) source declarations. Each software component that supports a
programmatic interface, reports events through EMS, or defines SPI error lists has a
DDL source file. All definitions in this section are represented in DDL. Structures, both
fixed and extensible, are defined by using DDL DEF statements. For an explanation of
DDL as it applies to SPI, refer to the Distributed Systems Management (DSM)
Programming Manual.
Separate definition files for each of the supported programming languages are generated
from the DDL source files by the DDL compiler. Supported languages include: TAL
(Transaction Application Language), C, Pascal, COBOL85, and TACL (Tandem
Advanced Command Language). Tandem supplies one source file for each of the
supported programming languages and one source file for the DDL.
SPI Standard Definitions
All items in the definition files are given symbolic names. Definitions whose names
begin with ZSPI are Subsystem Programmatic Interface (SPI) standard definitions.
These definitions are available to all subsystems that support SPI procedures and can be
found in the SPI DDL file, ZSPIDEF.ZSPIDDL.
Following is a list of the SPI standard definitions used in the token-oriented management
programming interface to the EM3270 subsystem. SPI definitions applicable to the
EM3270 subsystem consist of header tokens and other special tokens available to all
applications using SPI simple tokens in EM3270 commands, responses, event messages,
and error lists; token types and fixed structures; and token values.
This list does not list SPI error numbers or definitions used only in error lists associated
with those error numbers, nor does it list all SPI token values that can be used in an
application. For information about these definitions, refer to the Distributed Systems
Management (DSM) Programming Manual.