TCP/IP Management Programming Manual

Commands and Responses

HP NonStop TCP/IP Management Programming Manual—529636-001

6-42

LISTOBJECTS Command

The LISTOBJECTS command lists the names of objects known to the TCP/IP

subsystem. The objects listed 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 TCP/IP subsystem are listed. 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 TCP/IP subsystem returns an error.

When your management application specifies the SUBNET or ROUTE object, the

object types and object names listed 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, a zero length, or it can be absent. If the OBJNAME token contains a specific

object name, only that object is listed. If the OBJNAME token contains an object-name

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

token has a zero length or is absent, all objects of the specified type known to the

TCP/IP subsystem are listed.

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.

All users on the system can issue this command.

Command

ZCOM-CMD-LISTOBJECTS

Object Type

ZCOM-OBJ-NULL or ZCOM-OBJ-SUBNET or ZCOM-OBJ-ROUTE

Tokens in Command Buffer

ZSPI-TKN-SSID token-type ZSPI-TYP-SSID. !{}

ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING.

ZSPI-TKN-MAXRESP token-type ZSPI-TYP-INT.

ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.

ZSPI-TKN-ALLOW-TYPE token-type ZSPI-TYP-ENUM.

ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING.