Pathway/iTS System Management Manual (G06.24+)

Terminal Control Process (TCP) Commands
HP NonStop Pathway/iTS System Management Manual—426748-002
9-44
SWITCH TCP Command
SWITCH TCP Command
Use the SWITCH command to make the TCP exchange the function of its primary
process with the function of its backup process while the TCP is running. This
command does not change the value of the SET TCP CPUS attribute in the
PATHMON configuration file.
TCP tcp-name
specifies the name of one or more previously defined and added TCPs. tcp-name
can be either a single TCP name or several TCP names separated by commas
and enclosed in parentheses.
The TCP must have an initialized backup process.
If the named TCP is not running or is not defined with the NONSTOP attribute on,
an error is returned.
TCP *
exchanges the operations of all the primary and backup processes for TCPs
defined with the NONSTOP attribute on. This option changes only those TCPs with
initialized backup processes.
STATE state-type
specifies the state of the multiple TCPs. Possible values are:
PENDING NOT PENDING
RUNNING NOT RUNNING
STOPPED NOT STOPPED
This command exchanges the operations of primary and backup processes only
for those TCPs in the RUNNING state. If you specify any other state, the system
redisplays the command prompt; it does not display any output or generate an
error message.
You can substitute SEL for STATE.
Considerations
•
After this command completes, PATHCOM returns these information message:
INFO - *2031* TCP tcp-name SWITCHED
•
If you restart a TCP that was running with its primary and backup processes
switched, the primary and backup processes start in their configured CPUs.
SWITCH { [ TCP ] tcp-name }
{ [ TCP ] tcp-name [ , tcp-name ]... }
{ TCP * [ , STATE state-type ] }