Systemwalker Operation Manager リファレンスマニュアル

17.2.6 グループ操作API/EE

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

記述形式

【Windows版】

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

【UNIX版】

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

機能説明

本APIは、Systemwalker Operation Manager EEおよびGEEで、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	致命的なエラーが発生しました。	システムエラーが発生した可能性があります。イベントログ/SYSLOGを確認し、システムに異常がないか確認してください。異常があった場合は、保守情報収集ツールで“ジョブスケジューラ”の情報を採取し、富士通技術員に連絡してください。異常がない場合は一時的な問題と思われるため、再度実行してください。

必要ファイル

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

Windows版

LIB:

f3csbJobschControlEx.lib

INCLUDE:

f3csbJobschControlEx.h

Windows for Itanium版

LIB:

f3csbJobschCtlGrp_64.lib

INCLUDE:

f3csbJobschControl_64.h

Solaris版、Linux版共通

LIB:

libjobschex.so

INCLUDE:

jobschapiex.h

Linux for Itanium版

LIB:

libjobschex64.so

INCLUDE:

jobschapiex64.h

グループ操作APIはLIBに格納されており、グループ操作APIで使用する定数および構造体はINCLUDEファイルに宣言されています。

これらのファイルは以下のディレクトリに格納されています。

Windows版

LIB：

Systemwalker Operation Managerインストールディレクトリ
MpWalker.JM¥lib

INCLUDE：

Systemwalker Operation Managerインストールディレクトリ
MpWalker.JM¥include

Solaris版、Linux版、Linux for Itanium版共通

LIB:

/opt/FJSVJOBSC/usr/lib

INCLUDE:

/opt/FJSVJOBSC/usr/include

プログラム例

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

【Windows版】

#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);
}

【UNIX版】

#include <stdio.h>
#include "jobschapiex.h"

main () 
{
    int ret;

    ret = Mp_JobschCtlGrpEx ("user1",         /* project name      */ 
                             "grp1",          /* group name        */ 
                             1,               /* action : start    */ 
                             1);              /* sub system number */ 

    if (ret == 0) {
        printf ("group(grp1) was normally controlled.¥n"); 
    }
    else{
        printf ("ERROR: return code = %d¥n", ret);
        exit(1);
    }
    exit(0);
}