ajsembdbcancel
- Organization of this page
Format
ajsembdbcancel -u Server-name or program-name -p process-ID [-id embedded-database-setup-ID]
Description
Cancels the processing of an embedded-database command that is being executed.
Cancellation of the command results in an error. For details about the error that might occur, check the error message or the log for the command.
You can execute this command only when the embedded database is running. You can execute the command regardless of the operating status of JP1/AJS3.
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
-u Server-name or program-name
Specifies the name of the server or the name of the program related to execution of the embedded database operation commands.
The name of the program (PROGRAM) or the server name (SVID) related to the embedded database operation commands is output by executing the ajsembdbstatus command with the -s prc option specified during execution of an embedded database operation command.
The PROGRAM or SVID is output only when a corresponding embedded database operation command is being executed.
The following table lists the PROGRAM and SVID values for each command.
Command name |
SVID# |
PROGRAM |
---|---|---|
ajsembdbbuild, ajsembdbstart |
0minitx |
-- |
ajsembdbaddarea |
-- |
pdmod |
ajsembdbrorg |
0mrorgx |
-- |
ajsembdbreclaim |
0mrorgx |
-- |
ajsembdbstatus |
0mdbstx |
-- |
ajsembdbbackup |
0bcpyx |
-- |
ajsembdbrstr |
0brstrx |
-- |
- Legend:
-
--: Not applicable
- #
-
The x at the end of a program name is a number such as 0, 1, and 2.
The processing of embedded database operation commands other than those listed above cannot be canceled by this command.
-p process-ID
Specify the process ID of the information output by the ajsembdbstatus command with the -s prc option specified.
-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.
Notes
-
When you execute this command, the following message appears:
4432 16:49:20 unt1 _pd0canc KFPS05082-Q Utility server name=0mrorg0,utility server process id=5456 cancel process ? (y/n)
This is a confirmation message asking you whether you want to cancel the processing of the command. Enter y if there are no problems.
-
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.
-
If you execute the ajsembdbstatus command with the -s prc option specified while a embedded database manipulation command is running, the ajsembdbstatus command might not output a program name that can be specified for the -u option. If that occurs, the processing you attempted to cancel by using the ajsembdbcancel command either has not started yet or has already ended.
-
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.
-
Return values
0 |
Normal end |
Values other than 0 |
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 |
---|---|---|
KAVS0996-E |
The specified option contains an error. |
Check the specification of the option. |
KAVS2101-E |
The embedded database is inactive. |
Start the embedded database and then re-execute the command. |
KAVS2102-E |
The embedded database is being started or stopped. |
Confirm that the embedded database is running, and then re-execute the command. You can confirm whether the embedded database is running by executing the ajsembdbstatus command with the -s ust option specified. |
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. |