EM3270 Manual

EMS Standard Definitions
I-4 110332—Tandem EM3270 Manual
Common Definitions
All SPI standard definitions are fully described in the Distributed Systems Management
(DSM) Programming Manual. Definitions that are specific to the EM3270 subsystem are
given below.
•
ZSPI-SSN-ZEM3 is the subsystem number assigned to the EM3270 subsystem.
•
ZSPI-TKN-OBJECT-TYPE specifies the object-type number of an EM3270
object. The value of this token for the EM3270 subsystem is always ZCOM-OBJ-
type, where type specifies the object type. The valid object types associated with a
command vary with each command used by the EM3270 subsystem.
•
ZSPI-TKN-SERVER-BANNER used in responses and some events, contains a
copy of the server banner identifying the version of EM3270.
•
ZSPI-TKN-SSID specifies the subsystem ID. This token is required in all
commands and responses. The SSINIT procedure initializes the command buffer
with this token using the value defined in the subsystem’s definition file. The value
used for the EM3270 subsystem is ZEM3-VAL-SSID.
•
ZEM3-VAL-SSID has the following structure definition:
def ZEM3-VAL-SSID tacl SSID.
02 Z-FILLER type ZSPI-DDL-CHAR8, value ZSPI-VAL-TANDEM.
02 Z-OWNER type ZSPI-DDL-CHAR8, redefines Z-FILLER
02 Z-NUMBER type ZSPI-DDL-INT, value ZSPI-SSN-ZEM3.
02 Z-VERSION type ZSPI-DDL-UINT, value ZEM3-VAL-VERSION.
end.
•
ZSPI-VAL-TANDEM indicates that the destination subsystem is a Tandem
subsystem. The requester must assign this value to the owner field of the ZSPI-
TKN-SSID token before sending a command to a Tandem system.
•
ZSPI-SSN-ZEM3 specifies the subsystem number assigned to the EM3270
subsystem. This value name is defined as a constant in the SPI DDL file,
ZSPIDEF.ZSPIDDL.
•
ZEM3-VAL-VERSION is a 16-bit unsigned integer that specifies the current
software release version of the EM3270 subsystem.
•
ZSPI-TKN-ERROR is an error token, returned within an error list in a response,
that identifies an error detected by the subsystem. Its value consists of the subsystem
ID that detected the error, followed by the error number.
EMS Standard Definitions
Definitions whose names begin with ZEMS are Event Management Service (EMS)
standard definitions. These definitions are available to all subsystems that support EMS
and can be found in the EMS DDL file, ZSPIDEF.ZEMSDDL.
Below is a list of EMS standard definitions used in the management programming
interfaces to the EM3270 subsystem. These definitions consist of simple tokens used in
EM3270 event messages; header tokens available to all applications using EMS; and
token types used in other definitions.