15.3 ジョブ終了出口

Systemwalker Operation Manager リファレンスマニュアル - Microsoft(R) Windows NT(R)/Windows(R) 2000/Windows Server(TM) 2003 -

目次索引

15.3 ジョブ終了出口

ジョブスケジューラに登録してあるジョブが終了した場合に呼び出される、出口プログラムについて説明します。

jobexit.bat、jobexit.exeの順に出口プログラムが検索され、見つかった出口プログラムが呼び出されます。jobexit.batが見つかった場合、jobexit.exeが存在しても呼び出されません。

利用者がこれらの出口を利用して、独自の処理を行いたい場合は、同名の出口プログラムを作成して、Systemwalker Operation Managerをインストールしたディレクトリ配下のMpWalker.JM\binディレクトリに格納してください。

■出口プログラムに渡されるパラメタ

出口プログラムに渡されるパラメタは、以下のとおりです。

argc　　：パラメタの数（5）　　　　　　　　　　　　　　　（注1）
argv[0] ：出口プログラム名
argv[1] ：ジョブネットの登録されているプロジェクト名
argv[2] ：ジョブネット名
argv[3] ：ジョブネット名称
argv[4] ：一時ファイル名
argv[5] ：サブシステム番号（文字列）　　　　　　　　　　　（注2）

注1） Systemwalker Operation Manager EEの場合、パラメタの数は6になりま
      す。
注2） Systemwalker Operation Manager EEのパラメタです。

一時ファイルには、ジョブ情報が以下のように格納されます。

ジョブ名
終了コード
状態

上図の各情報について説明します。

ジョブ名:

実行属性によって、以下の内容が格納されます。

ジョブとして子ジョブネットが登録されている場合、子ジョブネットのジョブネット名が格納されます。

実行属性が“ジョブ実行制御”の場合:: ジョブ名です。ジョブ名が省略されている場合は、コマンドとして登録した文字列が格納されます。
実行属性が“Interstage”の場合:: ジョブのワークユニット名です。

終了コード:

ジョブの終了コード(0～256までの文字)です。

状態:

ジョブの状態を以下の4つのうちのいずれかの文字列で表します。

normal_end:: 正常終了したことを示します。
pseudo-normal:: 疑似正常終了したことを示します。
abnormal_end:: 異常終了したことを示します。
canceled:: 強制終了したことを示します。

なお、一時ファイルは、ファイル名Extnnn.tmp(nnnはシステムが付加)で、ジョブスケジューラのデータベースディレクトリ配下のworkディレクトリに作成されます。一時ファイルは、ジョブスケジューラ側では削除しないので、出口プログラムで削除する必要があります。出口が登録されていない場合は、一時ファイルは作成されません。

■パス状態のジョブについて

先行ジョブの終了コードによる後続ジョブの起動条件を指定している場合に、パス状態で終了したジョブは、ジョブ終了出口が起動されません。

■注意事項

ジョブネットやグループの実行が遅延する可能性があるため、時間のかかる処理は行わないでください。
出口の実行ユーザは、ジョブスケジューラサービスのスタートアップアカウントです。

■プログラム例

ジョブ終了出口のプログラム例を以下に示します。

/*  ジョブ終了時に、"KANRI”サーバに以下のメッセージを送信する
      ジョブ名 is ended !! code = 終了コード
*/
#include <stdio.h>
#include <string.h> 
#include <process.h>

main(int argc, char *argv[])
{
    FILE *fp; 
    char jobname[100];
    char jobcode[100];
    char cmdline[256];

    fp = fopen(argv[4], "r"); 
    fgets(jobname, 99, fp); 
    jobname[strlen(jobname)] = '\0';
    fgets(jobcode, 99, fp); 
    jobcode[strlen(jobcode)] = '\0';
    fclose(fp); 

    sprintf(cmdline,
            "NET SEND KANRI %s is ended !! code = %s",
            jobname,    //ジョブ名
            jobcode);   //終了コード

    system(cmdline);

    unlink(argv[4]);    // temp ファイルを削除

    exit(0);
}

目次索引