ajsembdbuninstl
- Organization of this page
Format
ajsembdbuninstl {-mh logical-host-name | -id setup-identifier}
Description
The ajsembdbuninstl command uninstalls the JP1/AJS3 standard database (embedded database).
You can execute this command regardless of the operating status of the embedded database. Note, however, that all scheduler services for which the scheduler database is set up in the embedded database environment to be uninstalled must be stopped when the command is executed.
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
-mh logical-host-name
Specify the name of the logical host on which you want to perform uninstallation. All embedded databases installed on the specified logical host will be uninstalled.
You can specify a character string of 1 to 32 bytes.
You cannot specify JP1_DEFAULT in this option.
To uninstall the embedded databases from the physical host, specify the -id option.
-id setup-identifier
Specify a four-character setup identifier, _JFn (n: 0 to 9 or A to Z), which identifies the embedded database to be uninstalled.
You can specify this option for uninstallation on either the physical or logical host.
Do not uninstall the following embedded databases because they contain information required by the system:
-
The embedded database whose setup identifier is _JF0
-
The first embedded database set up on a host where an embedded database setup identifier is changed to other than _JF0 by performing data migration during embedded database advance setup, embedded database advance setup, or embedded database re-setup
-
The embedded database set up with the setup identifier specified in the -I option of the jajs_setup_cluster command in an environment in which a logical host is set up
For details on the jajs_setup_cluster command, see jajs_setup_cluster in 2. Commands Used during Setup.
Notes
-
If the return value of this command is not 0, the following message is output: Database uninstall failed (error code=yy). In yy, the return value is indicated. If this message is output, take action appropriate for the indicated return value. For details, see 2.7.8(3) Action to be taken if an error occurs during uninstallation of the embedded database in the manual JP1/Automatic Job Management System 3 Troubleshooting.
If information about an uninstalled embedded database remains in the JP1/AJS3 common definition information, the ajsembdbuninstl command might fail. If such information remains, delete the common definition information by executing the command shown below. For details on the jbsunsetcnf command, see the JP1/Base User's Guide.
jbsunsetcnf -i -h JP1_DEFAULT-or-logical-host-name -c JP1AJS2 -n EMBDBINSTALL
If no information has been set when the command is executed, the following message might be output: KAVA0405-I The specified sub-key does not exist (JP1_DEFAULT or logical-host-name\JP1AJS2\EMBDBINSTALL). Processing stops.. However, you can ignore this message.
-
This command does not delete the embedded database installation directory or the embedded database data area directory. If these directories are no longer necessary, delete them manually.
-
In UNIX, when you uninstall the embedded database, if the entry of the embedded database exists in the /etc/inittab directory (in Linux, the /etc/init directory), it is deleted.
-
Do not execute this command repeatedly in quick succession.
Return values
0 |
Normal end |
Values other than 0 |
Abnormal end |