4.2.5 ジョブネット情報クラスAjsWsJobnetInfo

ジョブネット情報クラスは,ジョブネット制御クラスのジョブ実行状況監視の結果を保持するクラスです。ジョブネット情報クラスのインスタンスは,ジョブネット制御クラスのjobnetShowメソッドで取得できます。

クラス定義
public class AjsWsJobnetInfo
パッケージ名
jp.co.Hitachi.soft.ajs2.ws.jobcontrol
メソッド一覧
メソッド名説明
getKindジョブネットの種別を取得します。
getStatusジョブネットの状態を取得します。
getStartTimeジョブネット実行開始日時を取得します。
getEndTimeジョブネット実行終了日時を取得します。

各メソッドの詳細を説明します。

<この項の構成>
(1) getKindメソッド
(2) getStatusメソッド
(3) getStartTimeメソッド
(4) getEndTimeメソッド

(1) getKindメソッド

説明
ジョブネットの種別を取得します。
形式

public int getKind()

引数
なし
戻り値
ジョブネットの種別を整数定数で返却します。返却される定数一覧を次の表に示します。

表4-10 定数一覧(ジョブネットの種別)

定数名説明
intNETジョブネット
intRMNETリモートジョブネット
例外
なし

(2) getStatusメソッド

説明
ジョブネットの状態を取得します。
形式

public int getStatus()

引数
なし
戻り値
ジョブネットの状態を整数定数で返却します。返却される定数一覧を次の表に示します。

表4-11 定数一覧(ジョブネットの状態)

定数名説明
intNOPLAN実行予定がありません。
intTIME_WAIT実行開始時刻に到達するのを待っています。
intHOLDING保留中です。
intRUNNING実行中です。
intAB_CONTジョブネットが実行中で,同じジョブネット内で同時に実行しているジョブが異常終了しました。
intWA_CONTジョブネットが実行中で,同じジョブネット内で同時に実行しているジョブが警告終了しました。
intNORMALすべてのジョブおよびジョブネットが正常に終了しました。
intWARNINGジョブネットに,警告終了したジョブが含まれています。
intABNORMALジョブネットに,異常終了したジョブが含まれています。
intABNORMAL_WR警告終了後,再実行しましたが異常終了しました。
intEXEC_DEFFER実行予定日時にJP1/AJS3 - ManagerサービスまたはJP1/AJS2 - Managerサービスが起動されていない,またはルートジョブネットが保留のまま基準時刻を過ぎたなどの理由でジョブネットが実行されませんでした。
ジョブネットが「繰り越し未実行」状態になる条件は,次のとおりです。
  • ルートジョブネットが「開始時刻待ち」「保留中」「起動条件待ち」など待ち状態のままジョブネットの打ち切り時間を経過したとき
  • スケジューリング方式にスケジュールスキップが設定されている場合に,前の世代が終了する前に次の世代の開始時刻に到達したとき
  • スケジューリング方式にスケジュールスキップが設定されている場合に,即時実行登録で実行中のジョブネットを新たに即時実行登録したとき
  • スケジューリング方式に多重スケジューリングが設定され,多重起動が設定されていない場合に,実行中の世代が終了しないため次の世代がルートジョブネットの打ち切り時間を経過したとき
  • 多重起動が設定されていない場合に,実行中の世代があるときに起動条件が成立したため,実行中の世代の終了を待っていてルートジョブネットの打ち切り時間を経過したとき
  • スケジューラーサービスの設定で[ジョブネットのスキップ](OVERSCHEDULE)に[当日予定](plan)を設定し,ウォームスタートでスケジューラーサービスを起動した場合に,当日実行予定のスケジュールが存在するとき
  • スケジューラーサービスの設定で[ジョブネットのスキップ](OVERSCHEDULE)に[予定時刻超過](skip)を設定し,または,ジョブネットの実行登録時に[デーモン起動時に予定時刻超過]で[次回から実行する]を選択し,ウォームスタートでスケジューラーサービスを起動した場合に,スケジューラーサービスの起動時より前に実行を予定していたスケジュールが存在するとき
intINVALID_SEQ実行順序がループしていて,実行できないジョブまたはジョブネットがあります。
intINTERRUPTジョブネット中に異常終了したユニットはありませんが,まだ実行処理されていないユニット(未実行終了状態のユニット)があり,ジョブネットの実行が中断しています。
次に示すような場合,ユニットは先行に異常終了がない状態で未実行終了となります。
  • JP1/AJS3 - View,JP1/AJS2 - View,またはコマンドからジョブネットに対して,中断操作をした場合
  • キューイング状態のジョブに対して強制終了し,ジョブが実行されなかった場合
  • キューレスジョブが通信障害などで実行されなかった場合
  • ジョブネット配下で異常終了していたジョブが,再実行や状態変更で異常終了ではなくなった場合
  • ajsstopコマンドに「-j」オプションを指定して,スケジューラーサービスを停止した場合
なお,スケジューラーサービスをウォームスタートしたとき,実行中,異常検出実行中,または警告検出実行中だったルートジョブネットは,配下の状態に関係なく中断状態となります。
intKILL次のどれかの理由で,ジョブネットを強制終了しました。
  • 実行中に終了結果をファイルへ書き込めなかったなど,ジョブネットの終了状態を判別できないような障害が発生した
  • 実行中にJP1/AJS3 - ManagerサービスまたはJP1/AJS2 - Managerサービスが停止した
  • 実行中にシステムが停止した
  • 実行中のジョブを強制終了した
  • 実行中のジョブが指定時間を超えたため処理の打ち切りを実行した
intKILL_WR警告終了後,再実行しましたが強制終了しました。
intCONDITION_WAIT起動条件の成立を待っています。
ただし,多重起動が設定されていない場合,実行中のジョブネットがある間は起動条件が成立しても起動条件待ちのままとなります。
intMONITORING起動条件に定義した事象を監視しています。
intUNEXEC_MONITOR起動条件が成立しないまま運用時間が終了しました。
intMONITOR_CLOSE監視中のジョブネットを中断または強制終了しました。
intMONITOR_INTRPT起動条件を定義したジョブネットが起動条件を監視している場合に,スケジューラーサービスを制限停止(ジョブ制限,ジョブネット制限,スケジュール制限)したとき,スケジューラーサービスを停止させるため監視を中断しました。
この場合,次にスケジューラーサービスをホットスタートまたはウォームスタートで起動したとき,サービスの起動と同時に起動条件の監視を再開します。
intMONITOR_NORMAL指定された回数または監視時間の範囲内に起動条件が成立しました。
intEND_DELAY終了遅延が発生しています。
intSTART_DELAY開始遅延が発生しています。
intNEST_END_DELAYネストジョブネットで終了遅延が発生しています。
intNEST_START_DELAYネストジョブネットで開始遅延が発生しています。
例外
なし

(3) getStartTimeメソッド

説明
ジョブネット実行開始日時を取得します。
形式

public java.lang.String getStartTime()

引数
なし
戻り値
ジョブネットが実行された日時を,「YYYY/MM/DD.hh:mm:ss」形式で返却します。「YYYY/MM/DD.hh:mm:ss」は,「西暦年/月/日.時:分:秒」を意味します。
ジョブネット実行が開始されていない場合,nullを返却します。
例外
なし

(4) getEndTimeメソッド

説明
ジョブネット実行終了日時を取得します。
形式

public java.lang.String getEndTime()

引数
なし
戻り値
ジョブネット実行が終了した日時を,「YYYY/MM/DD.hh:mm:ss」形式で返却します。「YYYY/MM/DD.hh:mm:ss」は,「西暦年/月/日.時:分:秒」を意味します。
ジョブネットが実行されなかった場合,またはジョブネットが実行中の場合,nullを返却します。
例外
なし