jajs_rpsite
- Organization of this page
Format
jajs_rpsite [-h logical-host-name] [-m {SET|SETSAME|CHANGE|UNSET} | -v | -V]
Description
The jajs_rpsite command sets up JP1/AJS3 for operation in disaster recovery mode using the disk copy and mirroring functionality of the hardware.
The following processing can be performed according to the specified option:
-
Set up a new logical host to operate as the main site
-
Change the logical host that operates as the main site
-
Exit disaster recovery mode
-
Display the name of the logical host operating as the main site
-
Display whether the site is the main site or remote site
You can execute this command only in the standard configuration.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Arguments
-h logical-host-name
Specify the target logical host name. You can specify a character string of 1 to 32 bytes.
The value of this option overrides the value of the JP1_HOSTNAME environment variable.
The command terminates abnormally if you specify a physical host name (machine name or JP1_DEFAULT) in this option.
If you omit this option and the JP1_HOSTNAME environment variable has not been set, the physical host name is assumed and the command terminates abnormally.
The command terminates abnormally if the specified logical host does not exist at the site where you executed the command.
-m {SET|SETSAME|CHANGE|UNSET}
-
SET
Sets up a new logical host to be used as the main site when operation in disaster recovery mode is to be configured by using logical hosts with different names.
JP1/AJS3 services at the remote site are deactivated when you have set up a logical host as the main site, and have started operation at the main site and copying between the shared disks.
Specify this option to set up a new logical host to operate as the main site. If the logical host to be used as the main site is already set, the command terminates abnormally regardless of whether that logical host was set by using -m SET or -m SETSAME.
The command terminates abnormally if you specify the -m SET option with the -v or -V option.
If processing ends normally, message KAVS3707-I is output.
-
SETSAME
Sets up a new logical host to be used as the main site when operation in disaster recovery mode is to be configured by using logical hosts with the same name.
JP1/AJS3 services at the remote site are deactivated when you have set up a logical host as the main site, and have started operation at the main site and copying between the shared disks.
Specify this option to set up a new logical host to operate as the main site. If the logical host to be used as the main site is already set, the command terminates abnormally regardless of whether that logical host was set by using -m SET or -m SETSAME.
The command terminates abnormally if you specify the -m SETNAME option with the -v or -V option.
If processing ends normally, message KAVS3710-I is output.
-
CHANGE
Changes the logical host that operates as the main site in disaster recovery mode.
Specify this option to switch operation to the remote site and resume job processing when a disaster at the main site causes the system to go down.
When you change the logical host that operates as the main site, JP1/AJS3 services are reactivated at the logical host you have designated, and are suppressed at the logical host which now serves as the remote site.
The command terminates abnormally if:
-
The logical host to operate as the main site has not been configured.
-
The name of the logical host already operating as the main site is specified during the configuration of operation in disaster recovery mode by using logical hosts with different names.
-
Commands are executed on the logical host already operating as the main site during the configuration of operation in disaster recovery mode by using logical hosts with the same name.
-
You specify this option with the -v or -V option.
-
Switching operation to the remote site fails.
If processing ends normally, message KAVS3708-I is output.
-
-
UNSET
Exits disaster recovery mode.
Take JP1/AJS3 out of disaster recovery mode at both the main site and remote site. JP1/AJS3 services remain deactivated at the remote site until disaster recovery mode is released.
The command terminates abnormally if you specify the -m UNSET option with the -v or -V option.
If processing ends normally, message KAVS3709-I is output.
-v
Displays the name of the logical host currently operating as the main site in disaster recovery mode.
The command terminates abnormally if you have not configured a logical host to serve as the main site in disaster recovery mode.
The command terminates abnormally if you specify the -v option with the -m or -V option.
-V
Displays whether the specified logical host is currently serving as the main site (Main is displayed) or the remote site (Remote is displayed).
The command terminates abnormally if you have not configured a logical host to serve as the main site in disaster recovery mode.
The command terminates abnormally if you specify the -V option with the -m or -v option.
Notes
-
Before you start copying between the shared disks by means of the hardware functions, make sure that you specify the -m SET or -m SETNAME option to configure the logical host that will operate as the main site. If you do not designate the logical host that is to operate as the main site, JP1/AJS3 services will not be deactivated at the remote site.
-
Do not execute the jajs_rpsite command repeatedly in quick succession. In addition, do not execute this command at the same time and on the same logical host as the command jajs_rpenvexport, jajs_rpenvimport, or jajs_spmd. If you do so, the following problems might occur:
-
The message output is incorrect. For example, an invalid message might be output or a message that would normally be output does not appear.
-
The jajs_rpsite command results in an error.
-
The configuration definition information becomes invalid, disabling further operation of JP1/AJS3.
-
-
Before you execute the -m SET, -m SETNAME, -m CHANGE, or -m UNSET option, stop disk copying by hardware functions between the shared disks.
-
If you execute the -m SET, -m SETNAME, or -m CHANGE option at the main site while information is being copied from the main site to the remote site, the command will end abnormally because the logical host that is to operate as the main site has already been specified.
-
Execute the -m SET, -m SETNAME, and -m CHANGE options at the site that is to operate as the main site.
-
Execute the -m UNSET options at both the main site and remote site.
-
After executing the command jajs_rpsite with the option -m SET, -m SETSAME, or -m UNSET, check whether the settings for operation in disaster recovery mode were correctly specified or removed. To check this, execute the command jajs_rpsite with the -v or -V option.
-
If you execute this command at the remote site while information is being copied from the main site to the remote site, the shared disks cannot be accessed and the command will end abnormally.
-
The command terminates abnormally if the shared disks of the logical hosts are not mounted.
-
To reconfigure operation in disaster recovery mode, remove the settings for operation in disaster recovery mode by using the option -m UNSET, and then respecify the settings by using the option -m SET or -m SETSAME.
Return values
0 |
Normal end |
Values other than 0 |
Abnormal end |
Example
The following examples show operation in disaster recovery mode, using the disk copy and mirroring functionality of the hardware.
Example 1
In the following example, logical hosts are configured by using different names, and LHOST_M is specified for the main-site logical host.
jajs_rpsite -h LHOST_M -m SET
Example 2
In the following example, logical hosts are configured by using the same name, and LHOST_M is specified for the main-site logical host.
jajs_rpsite -h LHOST_M -m SETSAME
Example 3
In the following example, logical hosts are configured by using different names, and the main-site logical host switches to LHOST_R (which is currently operating as the remote site) during failover.
jajs_rpsite -h LHOST_R -m CHANGE
Example 4
In the following example, logical hosts are configured by using the same name, and the main-site logical host switches to LHOST_M (which is currently operating as the remote site) during failover.
jajs_rpsite -h LHOST_M -m CHANGE
Example 5
Display the name of the logical host currently operating as the main site in the following configuration:
-
Main site: Logical host (LHOST_M)
-
Remote site: Logical host (LHOST_R)
jajs_rpsite -h LHOST_M -v
or
jajs_rpsite -h LHOST_R -v
Example 6
In the examples below, the command displays whether each specified logical host is currently operating as the main site or as the remote site, where the main site and remote site are as follows:
-
Main site: Logical host (LHOST_M)
-
Remote site: Logical host (LHOST_R)
jajs_rpsite -h LHOST_M -V
or
jajs_rpsite -h LHOST_R -V
Example 7
Exit disaster recovery mode in the following configuration:
-
Main site: Logical host (LHOST_M)
-
Remote site: Logical host (LHOST_R)
jajs_rpsite -h LHOST_M -m UNSET
and
jajs_rpsite -h LHOST_R -m UNSET
Output example 1
The following shows an output example when you specify the -v option to display the name of the logical host currently operating as the main site:
> jajs_rpsite -h LHOST_M -v LHOST_R
Output example 2
The following examples show the output when the -V option is specified to display whether the specified logical host is currently operating as the main site or the remote site:
> jajs_rpsite -h LHOST_M -V Main > jajs_rpsite -h LHOST_R -V Remote