AM3270 Management Programming Manual

COMMANDS AND RESPONSES
ADD Command
ADD Command
The ADD command adds a subdevice to the AM3270 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 summary
state when you attempt to add a subdevice. If the line is
not in the STARTED summary state, the AM3270 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
ZAM3-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
ZAM3-MAP-ADD-SU !{}
def ZAM3-DDL-ADD-SU.
02 ZADDR type ZSPI-DDL-INT-PAIR. !{}
02 ZPROTO type ZSPI-DDL-ENUM. !{}
02 ZRECSIZE type ZSPI-DDL-INT. !{}
02 ZREPOLL-INTVL type ZSPI-DDL-TIMESTAMP.
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.
def ZCOM-DDL-REQID.
>
6-14