TCP/IP TELNET Management Programming Manual

Data Communications Standard Definitions
Common Definitions
5–12 53474 Tandem Computers Incorporated
ZCOM-OBJ-NULL
does not represent a controllable TELNET object. It is used as the object type in
commands that do not require an object-name token. Only two TELNET
subsystem commands use the NULL object, GETVERSION and LISTOBJECTS.
ZCOM-OBJ-PROC
is the TELNET process running on a Tandem NonStop system. The TELNET
process is created using the RUN command. The only valid summary state for
this object is the STARTED summary state.
ZCOM-OBJ-WINDOW
is the point of attachment for the TELNET process. Through a window object the
TELNET process can send or receive data. The valid summary states are
STARTED and STOPPED.
ZCOM-TKN-CAUSE-SUMSTATE-CHG
is an enumerated value that indicates the reason the summary state of an object
has changed. This token is returned in the event message ZTNT-EVT-
SUMSTATE-CHG. See Section 7, “Event Management,” for details about the event
message. The possible values for this token are subsystem-specific. They are:
ZTNT-VAL-CAUSE-ERR
indicates the change occurred because of an error that occurred on the
interface.
ZTNT-VAL-CAUSE-OP
indicates the change occurred because of a command.
ZCOM-TKN-OBJNAME
contains the name of a TELNET object. The object name must follow the naming
conventions described in Section 3, “Elements of SPI Messages for the TELNET
Subsystem.” This token is present in every command (unless the NULL object has
been specified) and can be present in every response.
In a command, the object name indicates the object on which the command is to
operate. In addition, in some commands the requester can specify an object-name
template. If an object-name template is used, a command can affect multiple
objects.
In a response, the object name indicates the object on which the command has
been performed. This token is always in the response, unless an error prevented
the command from being attempted at all. If an object-name template has been
specified, a separate object-name token is returned for each object that meets the
template requirements. This token can also be present in data lists and error lists.