AM3270 Management Programming Manual

COMMON DEFINITIONS
SPI Standard Definitions
ZSPI-TKN-RESPONSE-TYPE specifies which types of responses the
management application wants returned. This token can apply to
all commands supported by the AM3270 subsystem. The RESPONSE-
TYPE token controls whether the subsystem returns a response
for every object or returns only responses for objects that
experience an error or warning. A management application can
specify any of the following values:
ZSPI-VAL-ERR-AND-WARN The subsystem returns responses
about objects for which something
unusual has happened. This
includes errors and warnings.
ZSPI-VAL-ERR-WARN-AND-NORM The subsystem returns responses
about every object the command
applies to.
ZSPI-TKN-RETCODE is the return token, which specifies whether
a command completed successfully. If the command completed
successfully, including when a command completes with a warning,
the value of this token is zero. Note that if the empty
response is returned, the value of this token is nonzero even
though the command has completed successfully. If the command
did not complete successfully, the value of this token indicates
the reason the command failed. The meaning of each error
number is subsystem-specific and possibly command-specific. For
descriptions of all AM3270 error numbers, refer to Appendix A.
For descriptions of all common data-communications error numbers,
refer to the Communications Management Programming Manual .
ZSPI-TKN-SERVER-BANNER contains the server-banner string for the
AM3270 subsystem. This token is returned only for the GETVERSION
command. The server banner for AM3270 is:
AM3270- T9371C20 - 15FEB89
ZSPI-TKN-SERVER-VERSION specifies the server version of the
AM3270 subsystem. This token is required in both the command
buffer and the response buffer. The SSINIT procedure initializes
the command buffer with this token using the value defined in
the subsystem's DDL file. The value used for AM3270 is ZAM3-VAL-
VERSION. The subsystem provides the value of this token for
purposes of comparison. The value provided by the subsystem must
be at least as current as the value provided by SSINIT. If it is
not as current, the subsystem rejects the command.
5-7