ajsembdbstop

Organization of this page

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

Format

ajsembdbstop
      [-f [-q]]
      [-id embedded-database-setup-ID]

Format 1 (for normally stopping the embedded database)

ajsembdbstop
      [-id embedded-database-setup-ID]

Format 2 (for forcibly stopping the embedded database)

ajsembdbstop
      -f
      [-q]
      [-id embedded-database-setup-ID]

To Page Top

Description

Stops 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

`-f`

Specify this option to forcibly stop the embedded database.

When you specify this option in the command you execute, the embedded database is forcibly stopped whether or not the embedded database is being accessed. It might take some time for the embedded database to start the next time you attempt starting it.

`-q`

Use this option when a cluster environment is created.

Use this option to stop the embedded database when failover.

`-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.

To Page Top

Notes

Before you stop the embedded database normally, stop all scheduler services that use the embedded database as the scheduler database. In addition, stop the JP1/AJS3 service, the JP1/AJS3 Console Agent service, and other services that access the embedded database. If you attempt to stop the embedded database normally without stopping these services, the embedded database might be unable to stop, causing you to wait for a long time.
If you forcibly stop the embedded database while the embedded database is being accessed, jobs being executed are forcibly terminated or access from JP1/AJS3 - View is forcibly disconnected.
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 also stops. 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 stop.
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.

To Page Top

Return values

0	Normal end
1	The embedded database is being started or stopped
2	The embedded database is being stopped
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.
KAVS2101-E	The embedded database is inactive.	The embedded database is already stopped and no action is required.
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.
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