AM3270 Management Programming Manual
COMMANDS AND RESPONSES
SWITCH Command
If ZCOM-TKN-SWITCH-PATH is specified, the path (used by the line)
to the CPU is to be switched. The value of this token is an
enumerated value indicating the path leading to the CPU the line
is to be switched to. This token can have the following values:
ZCOM-VAL-PATH-A The line is to be switched to path A.
ZCOM-VAL-PATH-B The line is to be switched to path B.
This value corresponds to the SYSGEN
modifier ALTERNATE_PATH.
These tokens are described in the
Communications Management
Programming Manual
.
ZCOM-MAP-REQID and ZCOM-TKN-CMD-TIMEOUT are standard data-
communications tokens that your application can optionally pro-
vide. These tokens are described in "Data-Communications
Standard Definitions" in Section 5 and the
Communications
Management Programming Manual
.
(ZSPI-TKN-) MANAGER, SSID, MAXRESP, RESPONSE-TYPE, ALLOW-TYPE,
and COMMENT are standard SPI tokens. With the exception of the
ZSPI-TKN-SSID token, which your management application must pass
to SSINIT, these tokens are optional. These tokens are described
in "SPI Standard Definitions" in Section 5 and the
Distributed
Systems Management (DSM) Programming Manual
.
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 process or AM3270 line
that was switched by the command. The process name is the same
as the line name in the AM3270 subsystem. Unless there is an
error that prevents the SWITCH command from being attempted at
all, this token is present in every response record. ZCOM-TKN-
OBJNAME is described more fully in "Data-Communications Standard
Definitions" in Section 5.
6-117