JOBWait （ジョブの終了を待つ）

機能: JOBSubmitコマンドで登録したジョブが終了するのを待ちます。

形式

JOBWait ( 〔DomainName〕 , QueSrvName , QueName , UserName , JobNo , 〔JobNameBuff〕 , 〔ExitCodeBuff〕 , 〔JobSubmitTimeBuff〕 , 〔JobStartTimeBuff〕 , 〔JobEndTimeBuff〕 , 〔FilePathBuff〕 , 〔CommandLineBuff〕 〔, Time〕 )

指定項目

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

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

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

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

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

JobNameBuff: ジョブ名称を受け取る変数名を指定します。; この値は省略できます。

ExitCodeBuff: JobNoで指定したジョブの終了コードを受け取る変数名を指定します。; この値は省略できます。

JobSubmitTimeBuff: JobNoで指定したジョブの投入時刻を受け取る変数名を指定します。変数にはyyyy/mm/dd/w/HH:MM:SS:sssの形式（yyyy:西暦， mm:月， dd:日， w:曜日（0:日曜～6:土曜）， HH:時， MM:分， SS:秒， sss:ミリ秒）で格納されます。; この値は省略できます。

JobStartTimeBuff: JobNoで指定したジョブの実行が開始された時刻を受け取る変数名を指定します。変数にはyyyy/mm/dd/w/HH:MM:SS:sssの形式（yyyy:西暦， mm:月， dd:日， w:曜日（0:日曜～6:土曜）， HH:時， MM:分， SS:秒， sss:ミリ秒）で格納されます。; この値は省略できます。

JobEndTimeBuff: JobNoで指定したジョブの実行が終了した時刻を受け取る変数名を指定します。変数にはyyyy/mm/dd/w/HH:MM:SS:sssの形式（yyyy:西暦， mm:月， dd:日， w:曜日（0:日曜～6:土曜）， HH:時， MM:分， SS:秒， sss:ミリ秒）で格納されます。; この値は省略できます。

FilePathBuff: JOBSubmitコマンドで指定したジョブとして実行するスクリプトファイル名のフルパスを受け取る変数名を指定します。; この値は省略できます。

CommandLineBuff: JOBSubmitコマンドで指定したジョブとして実行するファイルに対するパラメタを受け取る変数名を指定します。; この値は省略できます。

Time: ジョブの終了を監視する間隔を数値，または値を格納した変数名で指定します。; 間隔はミリ秒単位で指定します。; この値は省略できます。省略した場合，1,000ミリ秒を仮定します。

説明

JOBSubmitコマンドで登録したジョブの実行が終了するのを待ちます。

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

内部的に呼び出す関数が成功した場合は真（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 = JOBWait ( _DOMAIN_ ,_COMP_ ,"Que1" ,_USER_ ,jobNo )
  If  rtn1 = True  And  _JOB_RTN_ = 0  Then
    MessageBox ( "ジョブの実行は終了しました。" ,OK , ,Information )
  End
End

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

8.12.2 JOBWait （ジョブの終了を待つ）

8.12.2　JOBWait （ジョブの終了を待つ）