SPUCONTROL [ SPU Switchover/XL User's Guide ] MPE/iX 5.0 Documentation
SPU Switchover/XL User's Guide
SPUCONTROL
Initiates, starts, and stops the SPU Switchover/XL environment, displays
status information, and displays the system name.
Syntax
{SETUP }
{SHOWSPU}
SPUCONTROL [ACTION=] {START }
{STATUS }
{STOP }
Parameters
SETUP Initializes the SPU Switchover/XL environment that
you created using the SYSGEN utility SPU commands.
This parameter eliminates rebooting the system to
activate configuration changes.
Usage requirements of this parameter are as
follows:
* You can enter SPUCONTROL SETUP only on
the system where you performed the
configuration.
* If you change the configuration, you must
enter SPUCONTROL SETUP before entering
SPUCONTROL START.
Using this parameter automatically sends a copy of
the new configuration file from the system where
the configuration is being performed to the other
system, enabling synchronization across system
pairs.
If you mounted volume sets on the current system
only for configuration purposes, this parameter
returns the volume sets to their home system.
However, in order for this action to occur, you
must first close all switchable volume sets that
this parameter should return to their home system.
NOTE The SPUCONTROL SETUP command push all closed volume sets from the
system where the configuration changes were made, to the other
system, if that system was designated as the home system. The
SPUCONTROL SETUP command does not pull volume sets from the other
system to the system where the configuration changes were made.
SHOWSPU Displays the name of this system as defined in the
SPU Switchover/XL configuration file.
START Establishes a system status message between the
system pairs that enables each system to determine
if its partner is operative. SPUCONTROL START is a
prerequisite for the SWITCHOVER command. If both
systems are running, you can enter SPUCONTROL START
from either the home or the alternate system.
Entering the command once from either system
affects both systems.
You can also enter SPUCONTROL START when one of the
system pairs is inoperative. In this case, SPU
Switchover/XL does not initiate a system status
message and checks only the operative system's SPU
configuration file.
STATUS Displays the SPU Switchover/XL status for this
system and its partner system.
STOP Terminates the system status message between the
system pairs previously initiated with the
SPUCONTROL START command. You can enter SPUCONTROL
STOP from either the home or the alternate system
to stop the system status message for the system
pair.
Note that you must enter SPUCONTROL STOP before you
can reconfigure the SPU Switchover/XL environment.
Operation Notes
The function of the SPUCONTROL START command does not remain after
rebooting one of the system pairs. The default state of a system after
rebooting is the same as entering the SPUCONTROL STOP command.
NOTE To automatically initialize the SPU Switchover/XL environment after
rebooting a system, you should include the SPUCONTROL START command
in the SYSSTART file.
After reconfiguring the SPU Switchover/XL environment, you must enter the
SPUCONTROL SETUP command before entering the SPUCONTROL START command.
Similarly, you must enter the SPUCONTROL START command before entering
the SWITCHOVER command.
You can enter this command only from the system console and must have OP
or SM capability.
Examples
The following examples show system responses for each parameter when you
enter the SPUCONTROL command:
SETUP A display similar to the foolowing appears if you
enter SPUCONTROL SETUP:
#S3/38 SPUCONTROL SETUP IS STARTING.
HH:MM/ldev#/SPUCONTROL SETUP COMPLETE.
SHOWSPU A display similar to the following appears if you
enter SPUCONTROL SHOWSPU on Alpha:
THE SPU SWITCHOVER SYSTEM NAME IS ALPHA.
START A display similar to the following appears if you
enter SPUCONTROL START:
SWITCHOVER ENVIRONMENT IS ESTABLISHED BETWEEN
homesystem AND altsystem.
STATUS A display similar to the following appears when
both the home and alternate systems are running:
_________________________________________________
| |
| System Volume Sets Home System|
| ------ ----------- -----------|
| Alpha a_production_data_set Alpha |
| a_user_vol_set Alpha |
| a_mirror_disk_set Alpha |
| |
| Beta b_test_software_set Beta |
| b_benchmark_set Beta |
_________________________________________________
A display similar to the following appears if you
switch over from the home system (Alpha) to the
alternate system (Beta):
_________________________________________________
| |
| System Volume Sets Home System|
| ------ ----------- -----------|
| Beta b_test_software_set Beta |
| b_benchmark_set Beta |
| a_production_data_set Alpha |
| a_user_vol_set Alpha |
| a_mirror_disk_set Alpha |
_________________________________________________
STOP A display similar to the following appears if you
enter SPUCONTROL START:
SWITCHOVER ENVIRONMENT IS TERMINATED BETWEEN
altsystem AND homesystem.
MPE/iX 5.0 Documentation