ajsintrpt

〈このページの構成〉

形式
機能
実行権限
引数
注意事項
戻り値
補足事項
使用例

形式

ajsintrpt
     [-F サービス名]
     [-B 実行登録番号]
     [-R]
     [-E]
     [-T]
     [-X {yes|no|auto}]
     ジョブネット名，またはジョブグループ名...

ページの先頭へ

機能

現在実行中のジョブが終了したあと，ジョブネットの実行を中断します。

ページの先頭へ

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限
JP1_AJS_Manager権限
JP1_AJS_Operator権限

ページの先頭へ

引数

`-F` サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

`-B` 実行登録番号

実行を中断するジョブネットの，実行登録番号を「YYYYMMDDNNN」の形式で指定します。「YYYYMMDDNNN」の内容を次に示します。

YYYY：実行予定年

MM：実行予定月

DD：実行予定日

NNN：実行予定年月日の実行登録順序番号

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

`-R`

指定したジョブグループおよびジョブネットに含まれるすべてのジョブネットの実行を中断します。

このオプションを，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットの実行を中断します。

`-E`

実行登録済みのジョブネットの実行を中断します。

`-T`

ルートジョブネットの実行を中断します。

`-X {yes|no|auto}`

プランニンググループの下にあるユニットの中から，現在運用中のユニットを自動的に選択して操作するかどうかを指定します。ただし，ジョブグループ配下のユニットに対しては，どの値を指定しても自動的に選択しません。また，ルートジョブネット名称も省略できません。

yes

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。
no

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。
auto

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。
- 自動的に選択して操作する場合
  
  プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。
- 自動的に選択して操作しない場合
  
  プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

ジョブネット名，またはジョブグループ名

実行を中断するジョブネット名，または-R，-E，-Tオプションと同時にジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，ジョブネットを指定する場合，指定できるのはルートジョブネット名だけです。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDを指定できます。ただし，実行IDを指定した場合，-Bオプションは無効になります。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

ページの先頭へ

注意事項

ジョブネットの実行を中断できるのは，次のどちらかのユーザーです。
- 中断するジョブネットに含まれるすべてのユニットを定義したときに，または属性を変更したときに，操作権限を与えられたユーザー
- Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー
  
  ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。
スケジューラーサービスが起動していない場合，このコマンドは異常終了します。
中断しようとしたジョブネットがサスペンド状態の場合，このコマンドは異常終了します。
プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する指定をした場合に，自動的に選択されたユニットに操作権限がないと，エラーになります。
-Xオプションが省略された場合，環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象が決定されます。
プランニンググループの下にあるユニット名の指定方法については，「3. 通常の運用で使用するコマンド　ajsplan」の「補足事項」を参照してください。
このコマンドを実行すると，JP1/AJS3内で通信やデータベースの更新が実施されます。そのため，連続で多数実行するとJP1/AJS3全体に高い負荷が掛かり，処理の遅延など，運用に影響を与えるおそれがあります。連続して実行する場合は，2〜3秒の間隔を空けて実行するようにしてください。特に，イベントジョブ，カスタムイベントジョブ，またはイベントジョブおよびカスタムイベントジョブを使用したジョブネットに対して実行する場合には制限があるため，注意が必要です。イベントジョブおよびカスタムイベントジョブの制限値については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録B.8 イベント・アクション制御の制限値」を参照してください。

ページの先頭へ

戻り値

0	正常終了。
4〜124で4の倍数値	異常終了。

ページの先頭へ

補足事項

「監視中」の世代を中断した場合は，「監視中」の世代が「監視打ち切り終了」になります。「実行中」および「実行中」の世代の終了を待っている「起動条件待ち」の世代は中断されません。
実行を中断されたジョブネットは，ajsrerunコマンドで再実行できます。
このコマンドは，指定したユニットの中断をスケジューラーサービスに依頼すると終了します。指定したユニットの終了を待ちません。

ページの先頭へ

使用例

ジョブネット（net1）の実行を中断します。

ajsintrpt net1

ページの先頭へ