AM3270 Management Programming Manual

COMMANDS AND RESPONSES

LISTOBJECTS Command

The LISTOBJECTS command lists the names of objects known to the

AM3270 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 AM3270 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

AM3270 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 AM3270 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 AM3270 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-64