ajsembdbstart

Organization of this page

Format
Description
Execution privileges
Storage directory
Arguments
Notes
Return values
Actions to be taken if an error occurs

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]

To Page Top

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.

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\tools\
In UNIX:: /opt/jp1ajs2/tools/

To Page Top

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.

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.

To Page Top

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.

To Page Top

Return values

0	Normal end
1	The embedded database is being started or stopped
2	The embedded database is active
Other values	Abnormal end

To Page Top

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.

To Page Top