AM3270 Management Programming Manual
COMMANDS AND RESPONSES
GETVERSION Command
Tokens in Response Buffer
ZSPI-TKN-SSID is an echo of the subsystem ID value provided
by your application. This token is described in "SPI Standard
Definitions" in Section 5, "Common Definitions," and the
Distributed Systems Management (DSM) Programming Manual
.
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. See
"SPI Standard Definitions" in Section 5 for details.
ZCOM-TKN-OBJNAME specifies the name of the AM3270 process to
which the command was sent. The process name corresponds to
the line name. Unless there is an error that prevents the
GETVERSION 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 for which informa-
tion was requested. The value of this token should be ZCOM-
OBJ-NULL (NULL object) or ZCOM-OBJ-PROC (PROC object). This
token is described in "Data-Communications Standard Definitions"
in Section 5, "Common Definitions," and the
Communications
Management Programming Manual
.
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
GETVERSION command are as follows:
ZCOM-ERR-EMPT-RSP (-33)
ZCOM-ERR-TKN-VAL-INV (-30)
ZCOM-ERR-TKN-DUP (-27)
ZCOM-ERR-TKN-CODE-INV (-26)
ZCOM-ERR-SSID-INV (-24)
ZCOM-ERR-OBJNAME-INV (-19)
ZCOM-ERR-OBJ-NOT-SUPP (-18)
ZCOM-ERR-CMD-TIMED-OUT (-7)
6-49