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

^[EE]
14.2.6 グループ操作API/EE

グループ操作API/EE(Mp_JobschCtlGrpEx)について説明します。

■記述形式

#include "f3csbJobschControlEx.h"
int Mp_JobschCtlGrpEx (char *project,
　　　　　　　　　　　　 char *grpname,
　　　　　　　　　　　　 int action,
　　　　　　　　　　　　 int system_num) ;

■機能説明

本APIは、Systemwalker Operation Manager EEで、jobschctlgrpコマンドをC言語インタフェースから利用するためのインタフェースです。

■パラメタの説明

◆project

操作するジョブネットの存在するプロジェクト名を指定します。なお、API実行ユーザの利用できるプロジェクトのプロジェクト名のみ指定できます。API実行ユーザの利用できるプロジェクトのうちジョブネットが登録されているプロジェクトが1つしかない場合に限り省略できます。省略する場合はNULLを指定します。

◆grpname

操作するグループ名を指定します。省略することはできません。

◆action

グループの操作方法を指定します。

1:

start(起動)

2:

cancel(強制終了)

3:

rerun(再起動)

4:

pause(停止)

5:

continue(停止解除)

6:

disable(無効)

7:

enable(無効解除)

8:

cope(確認)

◆system_num

操作対象のサブシステムを、0から9の範囲の番号で指定します。

■復帰値

復帰値	意 味
0	正常終了しました。
4	グループが操作できない状態です。
8	ジョブスケジューラサービスが動作していません。
12	パラメタの指定に誤りがあります。または、ユーザの権限に誤りがあります。
16	致命的なエラーが発生しました。

■必要ファイル

グループ操作APIを使用するには、以下のファイルが必要となります。

LIB:

f3csbJobschControlEx.lib

INCLUDE:

f3csbJobschControlEx.h

これらのファイルは、Systemwalker Operation Managerをインストールしたディレクトリの“MpWalker.JM\lib”および“MpWalker.JM\include”配下に格納されています。

■プログラム例

グループ操作API/EEのプログラム例を以下に示します。

 

#include <windows.h>
#include <stdio.h>
#include "f3csbJobschControlEx.h"

void main()
{
    int ret;

    ret = Mp_JobschCtlGrpEx("user1",          // project name 
                            "grp001",         // group name 
                            1,                // action : start 
                            1);               // sub system number
    if (ret == 0) {
        printf("group(grp001) is controlled normaly.\n"); 
    }
    else{
        printf("ERROR: return code = %d\n", ret); 
        exit(1);
    }
    exit(0);
}