JOBHold （ジョブを保留／解除する）

機能: JOBSubmitコマンドで登録したジョブを保留・保留解除します。

形式

JOBHold ( 〔DomainName〕 , QueSrvName , QueName , UserName , JobNo , Flag )

指定項目

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

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

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

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

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

Flag: ジョブの実行を保留するときには真（True）を，ジョブの保留を解除するときには偽（False）を指定します。

説明

JOBSubmitコマンドで登録したジョブの実行を保留，または保留解除します。ジョブが実行待ち状態の場合にだけ，実行を保留できます。またジョブが保留状態の場合にだけ，保留を解除できます。

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

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

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

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

なお，この値は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 = JOBHold ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,jobNo ,True )
  If  rtn1 = True  And  _JOB_RTN_ = 0  Then
    MessageBox ( "ジョブの実行を保留しています。" ,OK , ,Information )
  End
End

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

8.12.3 JOBHold （ジョブを保留／解除する）

8.12.3　JOBHold （ジョブを保留／解除する）