TCP/IP TELNET Management Programming Manual

SPI Standard Definitions
Common Definitions
5–6 53474 Tandem Computers Incorporated
ZSPI-TKN-RETCODE
is the return token, which specifies whether a command completed successfully. If
a command completes successfully, including when a command completes with a
warning, the value of this token is ZCOM-ERR-OK. Note that if the empty
response (ZCOM-ERR-EMPT-RSP) 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 can be subsystem-
specific and possibly command-specific. Although the TELNET subsystem does
not define any subsystem-specific errors, it does return some of the data
communications and SPI defined errors. For descriptions of all the data
communications error numbers, refer to the Communications Management
Programming Manual. For descriptions of all the SPI error numbers, refer to the
Distributed Systems Management (DSM) Programming Manual.
ZSPI-TKN-SERVER-BANNER
contains the server-banner string for the TELNET subsystem. This token is
returned only for the GETVERSION command. The server banner for TELNET is:
TELNET T9551C11 - 24MAY89 - compile date
ZSPI-TKN-SERVER-VERSION
specifies the server version of the TELNET subsystem. This token is required in all
the 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 TELNET is ZTNT-VAL-VERSION. The value provided by the
ZTNT-VAL-VERSION must be at least as current as the value provided by SSINIT.
If it is not as current, the subsystem rejects the command.
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 TELNET is
ZTNT-VAL-SSID.