jajs_rpenvexport
- Organization of this page
Format
jajs_rpenvexport [-h logical-host-name] -d output-directory-name
Description
The jajs_rpenvexport command outputs (exports) disaster recovery operation setup information for JP1/AJS3 - Manager to the specified directory.
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 export disaster recovery operation setup information for JP1/AJS3 - Manager. 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, or if the specified logical host has not been set up (undefined definition key logical-host-name\JP1AJSMANAGER).
-d output-directory-name
Specify the full path name of the directory to which the JP1/AJS3 - Manager disaster recovery operation setup information is to be exported. The information will be stored in a directory named jp1ajs3_rp, which the system creates in the directory you specify here. Specify an existing directory. 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.
If disaster recovery operation setup information already resides in the specified directory (if a jp1ajs3_rp directory already exists), the existing information will be deleted. If you need to keep the old information, back it up first.
Notes
-
The jajs_rpenvexport 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_rpenvimport 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.
-
The output JP1/AJS3 - Manager disaster recovery operation setup information is incorrect.
-
-
Do not forcibly terminate this command during execution.
-
The command sometimes ends normally even if the environment is invalid. If this occurs, JP1/AJS3 - Manager will not operate correctly on the host that the acquired disaster recovery operation setup information is imported to.
Before you export disaster recovery operation setup information, make sure that the environment is operating normally.
-
You cannot specify the following characters in the command arguments:
- In Windows:
-
^ & = ! @ ~ % " < > | , ; * ?
- In UNIX:
-
^ & = ! @ ~ % " < > | , ; * ? \ ' $
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. |
Return values
0 |
Normal end |
Values other than 0 |
Abnormal end |
Example
The command in this example exports disaster recovery operation setup information to the following directory in logical host (LHOST1).
c:\temp\export\ajs3_rpenv_20100801 jajs_rpenvexport -h LHOST1 -d c:\temp\export\ajs3_rpenv_20100801