TCP/IP TELNET Management Programming Manual

LISTOBJECTS Command

Commands and Responses

53474 Tandem Computers Incorporated 6–35

LISTOBJECTS Command The LISTOBJECTS command returns the names of objects known to the TELNET

subsystem. The objects returned depend on the value of the ZSPI-TKN-OBJECT-TYPE

and ZCOM-TKN-OBJNAME tokens.

When your management application specifies the NULL object, all object types and

object names known to the TELNET subsystem are returned. In this case, the

OBJNAME token must either have a zero length or be absent. If these conditions are

violated, the command is rejected and the TELNET subsystem returns an error.

When your management application specifies the WINDOW object, the object types

and object names returned vary, based on the value of the OBJNAME token. In this

case, the OBJNAME token can contain a specific object name, an object- name

template, or a zero length, or it can be absent. If the OBJNAME token contains a

specific object name, only that object is returned. If the token contains an object-name

template, only those objects that meet the template requirements are returned. If the

token has a zero length or is absent, all WINDOW objects known to the TELNET

subsystem are returned.

Although multiple object names of the same object type can be returned within a

single data list, one data list cannot contain information for more than one object type.

When the objects to be returned consist of more than one object type or the number of

objects to be returned cannot fit in one data list, additional data lists can be returned

by using the context token.

Command

ZCOM-CMD-LISTOBJECTS

Object Type

ZCOM-OBJ-NULL

ZCOM-OBJ-WINDOW

—>