jajs_rpenvimport

Format

jajs_rpenvimport
     [-h logical-host-name]
     -e physical-host-name-of-primary-node
     -d input-directory-name
     [-s]

To Page Top

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.

To Page Top

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

To Page Top

Storage directory

In Windows:

JP1/AJS3 - Manager-installation-folder\bin\

In UNIX:

/opt/jp1ajs2/bin/

To Page Top

Arguments

To Page Top

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.

To Page Top

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.

To Page Top

Return values

To Page Top

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

To Page Top