ajsagtdel
形式
ajsagtdel [-h 論理ホスト名] {-a 実行エージェント名 | -g 実行エージェントグループ名}
形式1(実行エージェントの削除)
ajsagtdel [-h 論理ホスト名] -a 実行エージェント名
形式2(実行エージェントグループの削除)
ajsagtdel [-h 論理ホスト名] -g 実行エージェントグループ名
機能
実行エージェントまたは実行エージェントグループを削除します。
実行権限
次に示すJP1権限レベルを与えられたユーザー
-
JP1_JPQ_Admin
引数
-h 論理ホスト名
削除する実行エージェントまたは実行エージェントグループが登録されている自ホストの論理ホスト名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
このオプションを省略した場合は,環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合,物理ホスト名が仮定されます。
物理ホストの場合,このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。
-a 実行エージェント名
削除する実行エージェント名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
-g 実行エージェントグループ名
削除する実行エージェントグループ名を指定します。
指定できる文字数は,1〜255(単位:バイト)です。
注意事項
-
このコマンドを実行する前にajsagtaltコマンドで,削除する実行エージェントの受付配信制限の状態を「閉塞」状態にし,ジョブが実行されないようにしておいてください。実行エージェントの受付配信制限の状態については,マニュアル「JP1/Automatic Job Management System 3 導入ガイド 5.2 ジョブの受付配信制限」を参照してください。
なお,イベントジョブは,実行エージェントの受付配信制限の状態の影響を受けないため,削除する実行エージェントに対する新たなイベントジョブおよび起動条件付きジョブネットを実行しないようにしておいてください。
実行中のジョブ(PCジョブ,UNIXジョブ,カスタムジョブ,アクションジョブ,またはイベントジョブ)がある場合は,実行エージェントを削除できません。削除するには,実行中のジョブを強制終了させる必要があります。
なお,実行中のジョブは,ajsagtshowコマンドで確認できます。ajsagtshowコマンドについては,「2. コマンド ajsagtshow」を参照してください。
-
このコマンドで削除した実行ホストで,過去にイベントジョブまたは起動条件付きジョブネットを実行したことがある場合,実行ホストがこのコマンドの-hオプションに指定したマネージャーホスト名を記憶しています。その場合,実行ホストの起動時または停止時に,マネージャーホストに対して不要な通信(起動した旨または停止した旨の通知)をしてしまうため,次の手順でこのコマンドの-hオプションに指定したマネージャーホスト名を削除してください。
手順を次に示します。
-
実行ホストがこのコマンドの-hオプションで指定したマネージャーホスト名を記憶しているか確認する。
実行ホストで次のコマンドを実行します。
jpoagoec -p
-
このコマンドの-hオプションで指定したマネージャーホスト名を削除する。
次のコマンドを実行します。
jpoagoec -d -hオプションで指定したマネージャーホスト名
jpoagoecコマンドについては,「2. コマンド jpoagoec」を参照してください。
-
-
イベントジョブまたは起動条件付きジョブネットを実行した状態で,次の操作を行わないでください。
-
実行エージェントに対応する実行先ホスト上でJP1/AJS3サービスを停止する前にOSを停止する。
-
実行エージェントに対応する実行先ホストを電源オフする。
上記の状態でこのコマンドを実行しても,該当する実行エージェントを削除できません。そのような状態になった場合は,マネージャーホストのJP1/AJS3サービスを停止させてコールドスタートするか,または該当する実行エージェントで実行中のイベントジョブもしくは起動条件付きジョブネットの情報を削除してからこのコマンドを実行してください。
実行エージェントで実行中のイベントジョブまたは起動条件付きジョブネットの情報を削除する手順を次に示します。
-
各スケジューラーサービスに対して,該当する実行エージェントで実行中のイベントジョブまたは監視中の起動条件付きジョブネットがあることを確認する。
次のコマンドを実行します。
jpomanjobshow [-h 論理ホスト名]※ -F スケジューラーサービス名 -a 該当する実行エージェント名
-
手順1に該当するスケジューラーサービスを停止する。
-
手順2で停止したスケジューラーサービス上で,該当する実行エージェントに対して実行中のイベントジョブまたは監視中の起動条件付きジョブネットの情報を削除する。
次のコマンドを実行します。
jpomanevreset [-h 論理ホスト名]※ -F スケジューラーサービス名 -a 該当する実行エージェント名 -s
- 注※
-
対象のマネージャーホストが物理ホストである場合,-hオプションを指定する必要はありません。
スケジューラーサービスの停止方法については,マニュアル「JP1/Automatic Job Management System 3 運用ガイド 8.5.2 スケジューラーサービスを停止する」を,jpomanjobshowコマンドについては「2. コマンド jpomanjobshow」を,jpomanevresetコマンドについては「2. コマンド jpomanevreset」を参照してください。
-
-
このコマンドは,JP1/NQSEXECおよびJP1/OJE for VOS3との連携には使用できません。
-
このコマンドは,別ホストのJP1/AJS3 - Managerに対しては実行できません。
戻り値
0 |
正常終了。 |
4 |
|
8 |
コマンド引数の指定に誤りがある。 |
12 |
コマンド処理中にメモリー不足が発生した。 |
20 |
共有メモリーのアクセスが排他エラーで失敗した。 |
24 |
コマンド実行権限がない。 |
40 |
共有メモリーの割り当て,ファイルディスクリプタの割り当て,排他資源の割り当ての際,システムの限界値を超えた。 |
120 |
|
124 |
JP1/AJSの内部処理で予期しないエラーを検知した。 |
使用例1
実行エージェント「AP1」を削除します。
ajsagtdel -a AP1
使用例2
実行エージェントグループ「APG1」を削除します。
ajsagtdel -g APG1