TCP/IP TELNET Management Programming Manual

STATISTICS Command
Commands and Responses
6–60 53474 Tandem Computers Incorporated
ZCOM-TKN-OBJNAME
specifies the name of a TELNET object for which statistical information was
requested. Unless an error prevents the STATISTICS command from being
attempted at all, this token is present in every response record. If you have used
an object-name template, a separate ZCOM-TKN-OBJNAME token is returned for
each window that meets the template requirements. ZCOM-TKN-OBJNAME is
described more fully in “Data Communications Standard Definitions” in Section 5.
ZCOM-TKN-OBJTYPE
specifies the type of object for which information was requested. The possible
values are ZCOM-OBJ-PROC and 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 ZCOM return codes and
associated error lists, see the Communications Management Programming Manual.
For details on the ZSPI return codes and associated error lists, see the Distributed
Systems Management (DSM) Programming Manual.
The following nonzero values of RETCODE can be returned in response to the
STATISTICS command:
ZSPI-ERR-INVBUF (-1)
ZCOM-ERR-CMD-MISMATCH (-4)
ZCOM-ERR-CMD-TOO-LARGE (-8)
ZCOM-ERR-OBJ-NOT-FOUND (-17)
ZCOM-ERR-OBJ-NOT-SUPP (-18)
ZCOM-ERR-SPI-ERR (-23)
ZCOM-ERR-SSID-INV (-24)
ZCOM-ERR-TKN-CODE-INV (-26)
ZCOM-ERR-TKN-DUP (-27)
ZCOM-ERR-TKN-REQ (-29)
ZSPI-TKN-ERRLIST
indicates the beginning of an error list. See “SPI Standard Definitions” in Section 5
for a detailed description of this token.