TCP/IP TELNET Management Programming Manual

ALTER Command
Commands and Responses
6–18 53474 Tandem Computers Incorporated
(ZSPI-TKN-) MAXRESP and COMMENT
are standard SPI tokens your application can optionally provide. These tokens are
described in “SPI Standard Definitions” in Section 5.
Tokens in Response Buffer
ZSPI-TKN-SSID
identifies the subsystem ID. The value for the TELNET subsystem is ZTNT-VAL-
SSID. This token is described more fully in “SPI Standard Definitions” in
Section 5.
ZSPI-TKN-SERVER-VERSION
indicates the software release version of the TELNET subsystem. See “SPI
Standard Definitions” in Section 5 for a detailed description of this token.
ZSPI-TKN-DATALIST
indicates the beginning of a data list. The ZSPI-TKN-MAXRESP token must have
a value other than zero for data lists to be included in the response. See “SPI
Standard Definitions” in Section 5 for a detailed description of this token.
ZCOM-TKN-OBJNAME
specifies the name of the TELNET process or window altered by the command.
Unless an error prevents the ALTER command from being attempted at all, this
token is present in every response record. ZCOM-TKN-OBJNAME is described
more fully in “Data Communications Standard Definitions” in Section 5.
ZCOM-TKN-OBJTYPE
specifies the type of object altered. This token has the value ZCOM-OBJ-PROC or
ZCOM-OBJ-WINDOW. See Section 5, “Common Definitions,” for a detailed
description of this token.
ZSPI-TKN-RETCODE
specifies whether the command completed successfully. If the command
completed successfully, including when the command completes with a warning,
the value of this token is zero (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. Always check the contents of the error list to
determine the token or value in error. For details on the ZTNT return codes and
associated error lists, see Appendix A, “Error Numbers and Error Lists.” For
details on the ZCOM return codes and associated error lists, see the
Communications Management Programming Manual. For details on the ZSPI return