JOBCancel （ジョブをキャンセルする）

機能: JOBSubmitコマンドで登録したジョブをキャンセルします。

形式

JOBCancel ( 〔DomainName〕 , QueSrvName , QueName , UserName , JobNo )

指定項目

DomainName: QueSrvNameで指定するキューサーバが参加しているドメイン名，またはワークグループ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，ドメイン名の最大文字数です。スタンドアロンで運用している場合は省略できます。省略する場合は，長さ0の文字列（""）を指定してください。

QueSrvName: QueNameで指定するキューが作成されているサーバ名を文字列，または値を格納した変数名で指定します。指定できる文字数は，コンピュータ名の最大文字数です。

QueName: ジョブを投入したキュー名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，DomainNameとQueSrvNameとQueNameを合わせて半角文字で65文字以内（全角文字で32文字以内）です。

UserName: ジョブを投入したユーザの名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で20文字以内（全角文字で10文字以内）です。

JobNo: 実行をキャンセルするジョブのジョブ番号を数値，または値を格納した変数名で指定します。このジョブ番号は，JOBSubmitコマンドで取得した番号です。

説明

JOBSubmitコマンドで登録したジョブの実行をキャンセルします。ジョブが実行待ち状態の場合だけでなく実行中のジョブもキャンセルできます。

このコマンドは，内部的にはJP1/AJS2，またはJP1/NetBatchの関数NetBatchJobCancelWithIDが実行されています。

内部的に呼び出す関数が成功した場合は真（True）を，それ以外の場合は偽（False）を，コマンドの実行結果として返します。コマンドの実行結果が真（True）の場合は，関数の終了コードを_JOB_RTN_予約変数に格納します。コマンドの実行結果が偽（False）の場合は，_JOB_RTN_予約変数には何も格納されません。

_JOB_RTN_予約変数に格納される値は次のどれかになります。

値	意味
0	正常終了。
1	パラメタに誤りがある。
2	メモリの不足や，TCP/IPが正しく設定されていないなど実行環境に不備がある。
3	ネットワークに障害が生じた。
4	次のどれかの状態を示す。・指定したキューが存在しない。・キュー名称に誤りがある。・バッチジョブ運用が停止状態である。・JP1/AJS2，またはJP1/Net Batchサービスが初期化中である。
5	ジョブ番号で指定したジョブが存在しない。

なお，この値はJP1/NetBatch 02-00の時点での関数の終了コードです。それ以降のJP1/NetBatch，またはJP1/AJS2での関数の終了コードに関しては，JP1/NetBatch，またはJP1/AJS2を参照してください。

例

Dim  rtn1 ,jobNo
rtn1 = JOBSubmit ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,  _
                  "" ,0 ,_BIN_+"SCRIPT.SPT" ,"" ,jobNo )
If  rtn1 = True  And  _JOB_RTN_ = 0  Then
  rtn1 = JOBCancel ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,jobNo )
  If  rtn1 = True  And  _JOB_RTN_ = 0  Then
    MessageBox ( "ジョブの実行をキャンセルしました。" ,OK , ,Ex )
  End
End

対象バージョン: JP1/Script 01-00以降

8.12.4 JOBCancel （ジョブをキャンセルする）

8.12.4　JOBCancel （ジョブをキャンセルする）