ajsembdbunset
- Organization of this page
Format
ajsembdbunset {-r[-e]|-e[-r]} [-id embedded-database-setup-identifier] [-i embedded-database-practical-directory-name]
Format 1 (for canceling the setup of the embedded database (UNIX only))
ajsembdbunset -r [-id embedded-database-setup-identifier] [-i embedded-database-practical-directory-name]
Format 2 (for deleting the embedded database environment)
ajsembdbunset -e [-id embedded-database-setup-identifier] [-i embedded-database-practical-directory-name]
Description
Cancels the setup of the embedded database.
You can execute this command regardless of the operating status of the embedded database. You can execute the command only when all the scheduler services for which the target embedded database has been created as the scheduler database are inactive.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Storage directory
- In Windows:
-
JP1/AJS3 - Manager-installation-folder\tools\
- In UNIX:
-
/opt/jp1ajs2/tools/
Arguments
-r
You do not need to specify this option. If you specify it, processing ends without removing the embedded database setup.
-e
Specify this option to delete the embedded database environment.
The data in the embedded database will be deleted. If you want to keep the data, save it somewhere else beforehand.
In UNIX, if the -e option is specified, the -r option is also implicitly specified. That is, the registration of the embedded database running in the specified directory is canceled in the operating system.
-id embedded-database-setup-identifier
Use four characters, _JNn (N: the character specified during setup of the embedded database environment, n: 0 to 9 or A to Z), to specify the setup identifier of the embedded database.
If you omit this option, the system assumes _JF0.
To check the registered setup identifiers and embedded database practical directories, execute the ajsembdbidlist command.
For details on the ajsembdbidlist command, see ajsembdbidlist in 2. Commands Used during Setup.
-i embedded-database-practical-directory-name
Specify the name of the embedded database practical directory.
You must specify this option only when cancellation of the setup specified by using the -id option fails for example, when the ajsembdbbuild command does not end normally.
Notes
-
When you execute ajsembdbunset command, the following message appears:
message: ssss Embeddb DELETE?(y/n):
ssss: setup-identifier
This is a confirmation message for asking you whether you want to delete the environment. If the deletion will cause no problems, enter y.
-
When you execute ajsembdbunset command, check whether the specified operation directory is correct.
-
Before you execute ajsembdbunset command, stop all the JP1/AJS3 services, and the JP1/AJS3 Console Agent service on the JP1/AJS3 - Manager host (including logical hosts). The command may end normally even if you execute the command without stopping the services.
-
The ajsembdbunset command forcibly shuts down the embedded database even if the scheduler service is operating. You need to check whether the scheduler service is operating.
-
The ajsembdbunset command is implemented by a script. If you specify an illegally long character string or a invalid character string or value for the options, an unexpected error may occur. You must specify a character string or a number within the range specified by the DBMS and JP1/AJS3.
-
Do not execute ajsembdbunset command repeatedly in quick succession. If you do so, the following problems might occur:
-
The message output is invalid. For example, an invalid message is output or a message that should be output is not output.
-
The ajsembdbunset command results in an error.
-
-
In a cluster system, execute the ajsembdbunset command on both the primary and secondary hosts. On the primary host (the host specified in the -eh option of the ajsembdbbuild command), make sure that the shared disk is mounted before executing the ajsembdbunset command. You must execute the ajsembdbunset command on the primary host first. If you attempt to execute the ajsembdbunset command on the secondary host with the shared disk mounted before executing the command on the primary host, the following message is output and an error occurs: KFPS04619-E Unable to execute aa....aa command due to HiRDB unit not offline or not terminate normally(S+R). If this message is output, execute the ajsembdbunset command on the primary host with the shared disk mounted, and then re-execute the ajsembdbunset command with the -i option specified on the secondary host.
-
If the embedded database has been stopped forcibly or has terminated abnormally, restart it, normally terminate it, and then execute the command.
Return values
0 |
Ends normally |
Values other than 0 |
Ends abnormally |
Actions to be taken if an error occurs
If an error occurs, take the action indicated in the following table.
Message ID |
Phenomenon |
Action taken |
---|---|---|
KAVS0996-E |
The specified option is incorrect. |
Check the specification of the option. |
KAVS2104-E |
The embedded database is not set up. |
The environment of the embedded database has already been deleted. |
KAVS2115-E |
The embedded database is not installed. Alternatively, access permission for the path specified in the -i option does not exist. |
The embedded database to be deleted is not installed. Review the specified path, and then re-execute the command. If the AJS administrator is executing the command, make sure that the AJS administrator has execution privileges. |
KAVS2116-E |
The specified option is incorrect. |
Check the option output in the message and re-execute the command. |
KAVS2117-E |
An error occurred when you executed the command. |
Check the message output in the maintenance information. |