PAM Management Programming Manual

Commands and Responses
PAM Management Programming Manual—142481
5-70
SWITCH Command
SWITCH Command
SWITCH is a sensitive command that switches a specified line between the primary
processor and the backup processor, or it initiates a planned takeover of the backup
processor. The line must be started before it can be switched. (The SWITCH command
is implemented as the PRIMARY command in SCF.)
Tokens in Command Buffer
The tokens present in the command buffer for the SWITCH command are described in
Section 4, Common Definitions. The token description that follows provides an
explanation of the only unique token in this command.
ZCOM-TKN-SWITCH-CPU indicates the target processor to which the line is to be
switched. If the value of this token matches that of the current backup processor and the
backup processor is running, a switch occurs. This token must be present in every
SWITCH command.
Command
ZCOM-CMD-SWITCH
Object Type
ZCOM-OBJ-LINE !{A}
Tokens in Command Buffer
ZSPI-TKN-MANAGER token-type ZSPI-TYP-FNAME32. !r
ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING. !r
ZCOM-TKN-SWITCH-CPU token-type ZSPI-TYP-INT. !r
ZCOM-TKN-SEL-SUMSTATE token-type ZSPI-TYP-INT-PAIR.
ZSPI-TKN-MAXRESP token-type ZSPI-TYP-INT.
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.
ZSPI-TKN-RESPONSE-TYPE token-type ZSPI-TYP-ENUM.
ZSPI-TKN-ALLOW-TYPE token-type ZSPI-TYP-ENUM.
ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING.
Tokens in Response Buffer
ZSPI-TKN-DATALIST token-type ZSPI-TYP-LIST.
ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING. !r
ZCOM-TKN-OBJTYPE token-type ZSPI-TYP-ENUM. !r
ZSPI-TKN-RETCODE token-type ZSPI-TYP-ENUM. !r
ZSPI-TKN-ERRLIST token-type ZSPI-TYP-LIST.
ZSPI-TKN-ERROR token-type ZSPI-TYP-ENUM.
ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING.
ZCOM-TKN-OBJTYPE token-type ZSPI-TYP-ENUM.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.