ajsembdbcancel

〈このページの構成〉

形式
機能
格納先ディレクトリ
実行権限
引数
注意事項
戻り値
エラー時の対処

形式

ajsembdbcancel
     -u サーバ名，またはプログラム名称
     -p プロセスID
     [-id 組み込みDBセットアップ識別子]

ページの先頭へ

機能

実行中の組み込みDBの操作コマンドの処理を中断させます。

中断したコマンドはエラーとなります。発生するエラーの詳細については，各コマンドのエラーメッセージまたはログを参照してください。

このコマンドは，組み込みDBが稼働中の場合だけ実行できます。JP1/AJS3の稼働状態には関係なく実行できます。

ページの先頭へ

格納先ディレクトリ

Windowsの場合: JP1/AJS3 - Managerインストール先フォルダ\tools\
UNIXの場合: /opt/jp1ajs2/tools/

ページの先頭へ

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

ページの先頭へ

引数

`-u` サーバ名，またはプログラム名称

組み込みDB操作コマンドで動作しているサーバ名，またはプログラム名称を指定します。

組み込みDB操作コマンド実行中に，ajsembdbstatusコマンドを-s prcオプション指定で実行すると出力される，組み込みDB操作コマンドに対応したプログラム名称（PROGRAM），またはサーバ名（SVID）を指定してください。

これらのPROGRAM，またはSVIDは対応する組み込みDB操作コマンドが実行中の場合にだけ表示されます。

各コマンドのPROGRAM，またはSVIDを次に示します。

コマンド名	SVID^※	PROGRAM
`ajsembdbbuild`，`ajsembdbstart`	0minitx	−
`ajsembdbaddarea`	−	pdmod
`ajsembdbrorg`	0mrorgx	−
`ajsembdbreclaim`	0mrorgx	−
`ajsembdbstatus`	0mdbstx	−
`ajsembdbbackup`	0bcpyx	−
`ajsembdbrstr`	0brstrx	−

（凡例）: −：該当しない。
注※: 末尾のxは，0，1，2...と数値になります。

上記以外の組み込みDB操作コマンドについては，このコマンドで処理を中断できません。

`-p` プロセスID

ajsembdbstatusコマンドの-s prcオプション指定で出力される情報のPIDを指定します。

`-id` 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

ページの先頭へ

注意事項

このコマンドを実行した場合，次に示すメッセージが出力されます。
```
4432 16:49:20 unt1 _pd0canc KFPS05082-Q Utility server name=0mrorg0,utility server process id=5456 cancel process ? (y/n)
```
処理をキャンセルするかどうかの確認のメッセージであるため，問題ない場合は「y」を入力してください。
このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。
組み込みDB操作コマンドの実行中にajsembdbstatusコマンドの-s prcオプション指定を実行しても，-uオプションで指定できるプログラム名称が出力されない場合があります。これは，ajsembdbcancelコマンドでキャンセルできる処理が未開始であるか，またはすでに終了している状態であることを示します。
このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。
- 不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。
- このコマンドが，不当にエラーになる。

ページの先頭へ

戻り値

0	正常終了。
0以外の値	異常終了。

ページの先頭へ

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID	現象	対処方法
KAVS0996-E	指定したオプションに誤りがあります。	オプションの指定内容を見直してください。
KAVS2101-E	組み込みDBは停止中です。	組み込みDBを起動してから再実行してください。
KAVS2102-E	組み込みDBは起動・停止処理中です。	組み込みDBの起動を`ajsembdbstatus`コマンドの`-s ust`オプション指定で確認してから再実行してください。
KAVS2104-E	組み込みDBがセットアップされていません。	組み込みDBをセットアップしてから再実行してください。
KAVS2116-E	指定したオプションに誤りがあります。	メッセージに出力されているオプションを見直して再実行してください。
KAVS2117-E	コマンド実行時にエラーが発生しました。	保守情報に出力されているメッセージを参照してください。

ページの先頭へ