10.2.4 ジョブネット操作(起動パラメタ指定)API/EE

Systemwalker Operation Manager リファレンスマニュアル - UNIX共通 -

目次索引

第10章 API情報 10.2 ジョブスケジューラAPI

^[EE]
10.2.4 ジョブネット操作(起動パラメタ指定)API/EE

ジョブネット操作(起動パラメタ指定)API/EE(Mp_JobschControlParamEx)について説明します。

■記述形式

#include "jobschapiex.h"
int Mp_JobschControlParamEx (char *project,
　　　　　　　　　　　　　　　char *netname,
　　　　　　　　　　　　　　　char *parameter,
　　　　　　　　　　　　　　　int action,
　　　　　　　　　　　　　　　int rerunopt,
　　　　　　　　　　　　　　　int system_num) ;

■機能説明

本APIは、Systemwalker OperationMGR EEで、jobschcontrolコマンドをC言語インタフェースから利用するためのインタフェースです。本APIを利用すると、起動対象のジョブネットの各ジョブにパラメタを渡すことができます。

ジョブ実行属性のジョブネットのみ利用できます。

■パラメタの説明

◆project

操作するジョブネットの存在するプロジェクト名を指定します。なお、API実行ユーザの利用できるプロジェクトのプロジェクト名のみ指定できます。

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

◆parameter

起動するパラメタを200バイト以内の文字列で指定します。

ただし、起動/再起動以外の操作の場合、指定された値は無視されます。

NULLが指定された場合: 前回起動時に指定されたパラメタをジョブの引数の最後に付加します。
文字列が指定された場合: 指定されたパラメタをジョブの引数の最後に付加します。

◆netname

操作するジョブネット名を指定します。省略することはできません。

◆action

ジョブネットの操作方法を指定します。

1:: start(起動)
2:: cancel(強制終了)
3:: rerun(再起動)
4:: pause(停止)
5:: continue(停止解除)
6:: disable(無効)
7:: enable(無効解除)
8:: cope(確認)
9:: reinstate(終了取消)
10:: revoke(持越解除)

◆rerunopt

actionで3(rerun)を選択した場合のオプションを指定します。

0:: 通常の再起動を行います。異常終了したジョブから起動します。異常終了したジョブより前のジョブに再起動ポイントが設定されている場合には、そのジョブから起動します。
1:: 先頭ジョブからジョブネットを再起動します。
2:: 異常終了したジョブに対して「次の再起動のみ無効」を設定してジョブネットを再起動します。

◆system_num

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

■復帰値

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

■必要ファイル

ジョブネット操作APIを使用するには、以下のファイルが必要となります。

LIB:: libjobschex.so
INCLUDE:: jobschapiex.h

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

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

LIB:: /opt/FJSVJOBSC/usr/lib(Solaris OE版)
INCLUDE:: /opt/FJSVJOBSC/usr/include(Solaris OE版)

■プログラム例

ジョブネット操作API/EEのプログラム例を以下に示します。

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

main () 
{
    int ret;

    ret = Mp_JobschControlParamEx ("user1",         /* project name      */
                              "net1",          /* jobnet name       */
                              "param1",        /* parameter         */
                              1,               /* action : start    */
                              0,               /* rerun opt : none  */
                              1);              /* sub system number */

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