TR3271 Management Programming Manual

COMMANDS AND RESPONSES
ADD Command
ADD Command
The ADD command adds a subdevice to the TR3271 subsystem. You
can add only a subdevice; this command is not valid for the PROC
or LINE object type. The line must be in the STARTED or STOPPED
summary state when you attempt to add a subdevice. If the line
is not in one of these summary states, the TR3271 subsystem
returns an error. When the subsystem finishes processing the
command (without errors), the subdevice is placed in the STOPPED
summary state. To start the added subdevice, use the START
command.
When your management application issues the ADD command for
a subdevice, the subsystem checks the configurable attributes
provided in the command. These attributes are defined in
ZTR3-MAP-ADD-SU. If the attributes are valid, the subsystem
verifies that the subdevice is not already defined and that the
number of subdevices defined on the line is not greater than 253.
If either of these checks fails, the subsystem returns an error.
Typically, a line can support 255 subdevices, but there are two
subdevices reserved with the names #ZSPI and #DEBUG.
Command
ZCOM-CMD-ADD
Object Type
ZCOM-OBJ-SU
Tokens in Command Buffer
ZTR3-MAP-ADD-SU !{}
def ZTR3-DDL-ADD-SU.
02 ZADDR type ZSPI-DDL-INT-PAIR. !{}
02 ZPROTO type ZSPI-DDL-ENUM. !{}
02 ZRECSIZE type ZSPI-DDL-INT. !{}
02 ZXPARENT type ZSPI-DDL-BOOLEAN.
02 ZTYPE type ZSPI-DDL-INT-PAIR !{}
end.
ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING. !{}
ZCOM-MAP-REQID !MAP is optional, but if present,
!fields are required.
>
6-13