2.3.15 changeStatusメソッド
(1) 説明
指定されたジョブの状態を変更できます。
状態を変更できるジョブの詳細については,マニュアル「JP1/Automatic Job Management System 3 導入ガイド」のジョブの状態の変更について記載している個所を参照してください。
(2) 形式
- 終了コードを変更する場合
public void changeStatus( java.lang.String manager, java.lang.String serviceName, java.lang.String unitName, java.lang.String execID, ChangeStatus newStatus, int newReturnCode) throws AjsCdException
- 終了コードを変更しない場合
public void changeStatus( java.lang.String manager, java.lang.String serviceName, java.lang.String unitName, java.lang.String execID, ChangeStatus newStatus) throws AjsCdException
(3) 実行権限
ログインしたJP1ユーザーが,ユニットに対して次に示すJP1権限レベルのどれかを与えられている必要があります。
-
JP1_AJS_Admin権限
-
JP1_AJS_Manager権限
-
JP1_AJS_Operator権限
(4) 引数
引数名 |
省略 |
説明 |
---|---|---|
manager |
不可 |
要求を依頼するJP1/AJS3 - Managerのホスト名を,1〜255バイトの文字列で指定します。loginメソッドの第1引数に指定した値と合わせてください。 |
serviceName |
不可 |
要求対象のスケジューラーサービス名を,1〜30バイトの文字列で指定します。 |
unitName |
不可 |
要求対象のジョブネット(ユニット)の完全名を,1〜930バイトの文字列で指定します。 |
execID |
不可 |
実行IDを,文字列で指定します。 指定する形式は「@[mmmm]{A〜Z}nnnn」です。 |
newStatus |
不可 |
変更後の状態を定数で指定します。 指定できる値と内容については,「付録A.1 (10)ChangeStatus」を参照してください。 ホストリンクジョブネットの場合,「NORMAL(正常終了にする)」以外を指定すると例外を発生します。 ジョブネットコネクタの場合,「NOT(変更しない)」,「FAIL(起動失敗にする)」,「BYPASS(計画未実行にする)」,および「RETURNCODE(終了コードで判定する)」を指定すると例外を発生します。 ユニットがイベントジョブ,アクションジョブまたはORジョブの場合,「RETURNCODE(終了コードで判定する)」は指定できません。 イベントジョブ,アクションジョブまたはORジョブの場合,「RETURNCODE(終了コードで判定する)」を指定すると例外を発生します。 選択したユニットが判定ジョブの場合,状態を変更できません。判定ジョブの場合,「NOT(変更しない)」以外を指定すると例外を発生します。 |
newReturnCode |
可 |
変更後の終了コードを指定します。指定を省略した場合は,終了コードを変更しません。 指定できる値は,-2,147,483,648〜2,147,483,647です。 ホストリンクジョブネット,またはジョブネットコネクタの場合,終了コードを指定すると例外を発生します。 |
(5) 戻り値
なし。
(6) 例外
例外が発生した場合,このメソッドは例外クラス(AjsCdException)を送出します。