AM3270 Management Programming Manual
COMMANDS AND RESPONSES
TRACE Command
ZSPI-TKN-SERVER-VERSION indicates the software release version of
the AM3270 subsystem. This token is described in "SPI Standard
Definitions" in Section 5 and the
Distributed Systems Management
(DSM) Programming Manual
.
ZSPI-TKN-DATALIST indicates the beginning of a data list. This
token is described in the
Distributed Systems Management (DSM)
Programming Manual
.
ZCOM-TKN-OBJNAME specifies the name of the AM3270 line that
was traced. Unless there is an error that prevents the TRACE
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 and the
Communications Management Programming Manual
.
ZCOM-TKN-OBJTYPE specifies the type of object that was traced.
This token must have the value ZCOM-OBJ-LINE (LINE object).
This token is described in the "Data-Communciations Standard
Definitions" in Section 5, "Common Definitions," and the
Communications Management Programming Manual
.
ZSPI-TKN-ERRLIST indicates the beginning of an error list. This
token is described in the
Distributed Systems Management (DSM)
Programming Manual
.
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 TRACE
command are as follows:
ZCOM-ERR-EMPT-RSP (-33)
ZCOM-ERR-TKN-VAL-INV (-30)
ZCOM-ERR-TKN-REQ (-29)
ZCOM-ERR-TKN-DUP (-27)
ZCOM-ERR-TKN-CODE-INV (-26)
ZCOM-ERR-SSID-INV (-24)
ZCOM-ERR-SECUR-VIOL (-22)
ZCOM-ERR-OBJ-NOT-SUPP (-18)
ZCOM-ERR-FNAME-INV (-9)
ZCOM-ERR-CMD-TIMED-OUT (-7)
ZCOM-ERR-CMD-MISMATCH (-4)
Your management application tried to trace a process or
subdevice. The command is valid only for the object type
ZCOM-OBJ-LINE (LINE object).
6-124