TR3271 Management Programming Manual

Table Of Contents

COMMANDS AND RESPONSES

LISTOBJECTS Command

The LISTOBJECTS command lists the names of objects known to the

TR3271 subsystem. The objects listed depend on the value of the

ZSPI-TKN-OBJECT-TYPE, ZCOM-TKN-OBJNAME, and ZSPI-TKN-SUB tokens.

When your management application specifies the NULL object, all

object types and object names known to the TR3271 subsystem are

listed. The OBJNAME token must either have a zero length or

not be present. In addition, the SUB modifier cannot be present

because the NULL object is not in the object hierarchy. If any

of these conditions is violated, the command is rejected and the

TR3271 subsystem returns an error.

When your management application specifies the LINE object,

the OBJNAME token can contain a specific line name, have a

zero length, or not be present. Only the line type and name

are listed. (The TR3271 subsystem only supports one line per

process). If the SUB modifier is included (depending on the

value), the object types and names of the subordinate subdevices

are also listed.

When your management application specifies the SU object, the

OBJNAME token can contain a specific subdevice name, have a

zero length. or not be present. If the OBJNAME token contains

a specific subdevice name, only the name of the subdevice is

listed. If the OBJNAME token has a zero length or is not

present, all subdevice names are listed. If the SUB modifier is

included, it is ignored.

For the LISTOBJECTS command the TR3271 subsystem returns informa-

tion on each object either:

• In a separate data list, if the value of the ZSPI-TKN-MAXRESP

token is nonzero, or

• In a separate reply message not enclosed in a data list, if

the value of the ZSPI-TKN-MAXRESP token is 0.

All valid users can issue this command.

6-63