jajs_rpenvimport
- Organization of this page
Format
jajs_rpenvimport [-h logical-host-name] -e physical-host-name-of-primary-node -d input-directory-name [-s]
Description
The jajs_rpenvimport command reads (imports) the JP1/AJS3 - Manager disaster recovery operation setup information exported by the jajs_rpenvexport command and sets the JP1/AJS3 - Manager environment information.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Storage directory
- In Windows:
-
JP1/AJS3 - Manager-installation-folder\bin\
- In UNIX:
-
/opt/jp1ajs2/bin/
Arguments
-h logical-host-name
Specify the name of the logical host at which to import disaster recovery operation setup information exported by the jajs_rpenvexport command. 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. If you omit this option, the value of JP1_HOSTNAME is assumed. If JP1_HOSTNAME has not been set, the command terminates abnormally.
The command terminates abnormally if you specify a physical host name (machine name or JP1_DEFAULT) in this option.
-e physical-host-name-of-primary-node
Specify the host name (output by the hostname command) recognized as the TCP/IP host name by the operating system on the primary node at the remote site. You can specify a character string of 1 to 63 bytes. This option is mandatory.
-d input-directory-name
Specify the full path name of the directory containing the disaster recovery operation setup information exported by the jajs_rpenvexport command. Specify the directory in which the jp1ajs3_rp directory containing the exported information resides. The command terminates abnormally if no such directory exists. Do not specify a disk on the network drive.
You can specify a character string of 1 to 185 bytes.
This option is mandatory.
The command terminates abnormally if no disaster recovery operation setup information exists in the specified directory.
-s
This option forcibly overwrites the existing JP1/AJS3 - Manager environment information even if the logical host specified in the -h option has been set up (that is, the definition key logical-host-name\JP1AJSMANAGER is defined).
If you omit this option and the logical host has been set up, a response-required message asks for confirmation that you want to overwrite the JP1/AJS3 - Manager environment information.
Notes
-
To execute this command, the embedded database used by the logical host specified in the -h option must be installed. If the embedded database is not installed, the command terminates abnormally.
Use the ajsembdbidlist command to check whether the embedded database used by the logical host specified in the -h option is installed. For details on this command, see ajsembdbidlist in 2. Commands Used during Setup.
-
To execute this command, all JP1/AJS3 - Manager services at the logical host specified in the -h option must be stopped; otherwise, the command terminates abnormally.
Use the jajs_spmd_status command to check whether all JP1/AJS3 - Manager services at the logical host specified in the -h option have stopped. For details on this command, see jajs_spmd_status in 3. Commands Used for Normal Operations.
To check whether the embedded database has stopped, use the ajsembdbstatus command. For the command syntax, see ajsembdbstatus in 3. Commands Used for Normal Operations.
-
The command terminates abnormally if the system status of the embedded database is restart suspended. Make sure that the embedded database used by the logical host specified in the -h option has stopped. To release the restart suspended status of the embedded database, execute the ajsembdbstart command with the -Rf option specified. For details on this command, see ajsembdbstatus in 3. Commands Used for Normal Operations or ajsembdbstart in 3. Commands Used for Normal Operations.
-
The jajs_rpenvimport command is incorporated into a script. For this reason, specifying an excessively long character string or an invalid character string or value in this option sometimes results in an unexpected error. Specify character strings and numeric values that are defined in JP1/AJS3.
-
Before you execute this command, execute the command jajs_rpsite with the -v or -V option specified, and make sure that output of the message KAVS3711-E is disabled.
-
Do not execute this 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 or jajs_rpsite. 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 command results in an error.
-
The configuration definition information becomes invalid, disabling further operation of JP1/AJS3.
-
-
Do not forcibly terminate this command during execution.
-
You cannot specify the following characters in the command arguments:
- In Windows:
-
^ & = ! @ ~ % " < > | , ; * ?
- In UNIX:
-
^ & = ! @ ~ % " < > | , ; * ? \ ' $
-
An error might occur when you execute this command in conjunction with the jajs_spmd_status command. If so, re-execute the commands.
-
This command converts the environment parameter set in the export source host to the logical host name specified in the -h option.
The definition keys and environment setting parameters in the table below must be unique in the physical host and among all logical hosts. Before you execute this command, make sure that the definition keys and parameters are not duplicated on the logical host of the import destination or on any other logical hosts or physical hosts.
Definition key
Environment setting parameters
Definition
AJSMANAGER\scheduler-service-name
--
The name of the scheduler service
AJSSERVICEID
The scheduler service identification number
JOBSTATUSPORT
The service name of the port used to acquire the job status
RDBPORT
RDB port number
AJSTMPDIR
The name of the directory for temporary files
JOBINFDIR
The name of the directory for job error information
AJSDBDIRECTORY
The name of the database directory
-
If you specified the -bl option in the ajsembdbbuild command when building the embedded database environment at the main site, the directory you specified in the -bl option will be created at the import destination host.
-
If the shared disk is unreachable when you execute this command, the following message might be output to the integrated trace log: KNAD3914-E An attempt to open the lock file under the conf directory has failed. However, the import processing completes normally.
-
In a cluster configuration, execute this command on both the primary and secondary nodes. On both nodes, specify the physical host name of the primary node for the -e option.
Actions to be taken if an error occurs
Remove the cause of the error as indicated in the message, and then re-execute the command.
See also the cause and action information in the following table where applicable.
Message |
Cause |
Action to be taken |
---|---|---|
KAVS1111-E This function cannot be used with the compatible ISAM configuration. |
The JP1/AJS3 database is not the standard configuration. (For example, the database is being migrated, or the embedded database has not been created.) |
Check the database configuration of the logical host specified in the -h option. |
KAVS1112-E The specified directory (directory-name) does not exist. |
The directory specified in the -d option does not contain the jp1ajs3_rp directory exported by the jajs_rpenvexport command. |
Re-execute the command, specifying the correct directory name (including the jp1ajs3_rp directory) exported by the jajs_rpenvexport command. |
Return values
0 |
Normal end |
Values other than 0 |
Abnormal end |
Example
The command in this example imports disaster recovery operation setup information stored in the following directory into the logical host LHOST1 (primary node physical host: PHOST).
c:\temp\export\ajs3_rpenv_20100801 jajs_rpenvimport -h LHOST1 -e PHOST -d c:\temp\export\ajs3_rpenv_20100801