AM3270 Management Programming Manual
COMMANDS AND RESPONSES
START Command
ZCOM-TKN-OBJNAME specifies the name of the AM3270 line or
subdevice that was started by the command. Unless there is an
error that prevents the START command from being attempted at
all, this token is present in every response record. ZCOM-TKN-
OBJNAME is described in "Data-Communications Standard
Definitions" in Section 5, "Common Definitons" and the
Communications Management Programming Manual
.
ZCOM-TKN-OBJTYPE specifies the type of object that was started.
This token can have the following value ZCOM-OBJ-LINE (LINE
object) or ZCOM-OBJ-SU (SU object). This token is described in
"Data-Communications Standard Definitions" in Section 5, "Common
Definitions."
ZSPI-TKN-ERRLIST indicates the beginning of an error list. See
"SPI Standard Definitions" in Section 5 for details.
ZSPI-TKN-RETCODE specifies the return code for the command. This
token is described in "SPI Standard Definitions" in Section 5
and the
Distributed Systems Management (DSM) Programming Manual
.
For details on the data-communications error numbers and their
associated error lists, see "Common Error Numbers and Error
Lists" in the
Communications Management Programming Manual
.
The possible nonzero values of RETCODE in response to the START
command are as follows:
ZCOM-ERR-EMPT-RSP (-33)
ZCOM-ERR-TKN-REQ (-29)
ZCOM-ERR-TKN-DUP (-27)
ZCOM-ERR-TKN-CODE-INV (-26)
ZCOM-ERR-SUB-NOT-FOUND (-25)
ZCOM-ERR-SSID-INV (-24)
ZCOM-ERR-SECUR-VIOL (-22)
ZCOM-ERR-OBJNAME-INV (-19)
ZCOM-ERR-OBJ-NOT-SUPP (-18)
ZCOM-ERR-OBJ-NOT-FOUND (-17)
ZCOM-ERR-FNAME-INV (-9)
ZCOM-ERR-CMD-TIMED-OUT (-7)
ZCOM-ERR-TKN-VAL-INV (-30)
Your management application specified the SUB modifier with
the value ZCOM-VAL-SUB-ONLY or ZCOM-VAL-SUB-ALL for the SU
object. The SU object accepts only the value ZCOM-VAL-SUB-
NONE.
ZCOM-ERR-OBJ-ALRDY-IN-SUMSTATE (-16)
Your application tried to start a line or subdevice that is in
the STARTED summary state.
6-88