ajsembdbstart
- Organization of this page
Format
ajsembdbstart [-R|Rf] [-r] [-id embedded-database-setup-ID]
Format 1 (for starting the embedded database)
ajsembdbstart [-id embedded-database-setup-ID]
Format 2 (for starting the embedded database to restore the area storing the internal information of the embedded database system)
ajsembdbstart -r [-id embedded-database-setup-ID]
Format 3 (for starting the embedded database after canceling suppression of starting the embedded database (in UNIX only))
ajsembdbstart -R [-r] [-id embedded-database-setup-ID]
Format 4 (for canceling suppression of starting the embedded database (in UNIX only))
ajsembdbstart -Rf [-id embedded-database-setup-ID]
Description
Starts the embedded database.
You can execute this command only while the embedded database and all the scheduler services for which the applicable embedded database was created as the scheduler database are not running.
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
Specify this option when you use the ajsembdbrstr command to restore the system area in the embedded database.
-id embedded-database-setup-ID
Specify the setup identifier that identifies the embedded database in the _JFn format (n: 0-9 or A-Z). The value specified in this argument must be the same as the value specified in the -id option of the ajsembdbbuild command.
If you want to operate an embedded database created by using the jajs_setup, jajs_setup_cluster, and jajs_migrate commands, use the ajsembdbidlist command to check the setup identifier of the embedded database. For details on the ajsembdbidlist command, see ajsembdbidlist in 2. Commands Used during Setup in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 2.
If you omit this option, the system assumes _JF0.
-R
This option, which can be used in UNIX only, cancels suppression of starting the embedded database, and then starts the embedded database.
Before you specify this option, make sure that the embedded database is inactive and the error indicated by the reason code in the KFPS00715-E message has been corrected.
-Rf
This is a UNIX-specific option that is used to cancel suppression of starting the embedded database.
Specifying this option does not start the embedded database. However, if the embedded database uses a method to cancel suppression of starting the embedded database that was available earlier than version 10-00, and the embedded database is in a non-cluster environment, the embedded database is automatically started after the suppression of starting is canceled.
Specification of this option overrides the -r option specification.
Notes
-
This command is implemented by a script. If you specify an excessively long character string or an invalid character string or value for an option, an unexpected error might occur. You must use the number of characters allowed for a character string or a value in the option as specified in the DBMS and JP1/AJS3 specifications.
-
You cannot execute this command together with any of the following commands on the same logical host:
ajsprofalter command
ajsembdbstart command
ajsembdbstop command
ajsstart command
ajsstop command
jajs_hstd command
jajs_hstd_stop command
jajs_spmd command
jajs_spmd_status command
jajs_spmd_stop command
jajs_start command (UNIX only)
jajs_start.cluster command (UNIX only)
jajs_stop command (UNIX only)
jajs_stop.cluster command (UNIX only)
-
When JP1/AJS3 is running, the jajs_dbmd process stopped by the ajsembdbstop command also starts. Note, however, that if the type of the embedded database is one used for JP1/AJS3 - Manager before version 10-00, the jajs_dbmd process does not start.
-
Do not execute this command more than once 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 command results in an error.
-
-
In Windows, make sure that the embedded database service has started. If this command is executed when the service has not started, an error occurs and the messages KAVS2117-E and KFPS01801-E appear.
Return values
0 |
Normal end |
1 |
The embedded database is being started or stopped |
2 |
The embedded database is active |
Other values |
Abnormal end |
Actions to be taken if an error occurs
If a command error occurs, take the indicated action in the following table.
Message |
Cause |
Action to be taken |
---|---|---|
KAVS0787-E |
The system administration daemon is processing. |
Use the jajs_spmd_status command to check the service status, and then re-execute the command. |
KAVS0996-E |
The specified option contains an error. |
Check the specification of the option. |
KAVS2102-E |
The embedded database is being started or stopped. |
Use the -s ust option of the ajsembdbstatus command to check whether the embedded database is running and then re-execute the command. |
KAVS2103-E |
The embedded database is running. |
The embedded database is already started and no action is required. |
KAVS2104-E |
The embedded database is not set up. |
Set up the embedded database and then re-execute the command. |
KAVS2116-E |
The specified option contains an error. |
Check the option output in the message and then re-execute the command. |
KAVS2117-E |
An error occurred during execution of the command. |
Check the message output in the maintenance information. |