Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

ajsembdbcancel

Format

ajsembdbcancel
      -u UAP-ID
      -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 UAP-ID

Specify the name of the program that is run by the command that manipulates the embedded database (a command that begins with ajsembdb).

Note that the program name you specify in this option is an item indicated as PROGRAM in the information output by the ajsembdbstatus command with the -s prc option specified.

The following table lists the name of the program for each command:

Command name Program name^#

ajsembdbbuild, ajsembdbstart 0minitx

ajsembdbaddarea pdmod

ajsembdbrorg 0mrorgx

ajsembdbreclaim 0mrorgx

ajsembdbstatus 0mdbst

ajsembdbbackup 0bcpyx

ajsembdbrstr 0brstr

# The x at the end of a program name is a number such as 0, 1, and 2.

-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 in the manual Job Management Partner 1/Automatic Job Management System 3 Command Reference 2.

If you omit this option, the system assumes _JF0.

Command name	Program name^#
ajsembdbbuild, ajsembdbstart	0minitx
ajsembdbaddarea	pdmod
ajsembdbrorg	0mrorgx
ajsembdbreclaim	0mrorgx
ajsembdbstatus	0mdbst
ajsembdbbackup	0bcpyx
ajsembdbrstr	0brstr

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.

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.

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.

[Contents][Back][Next]

[Trademarks]