JOBSubmit （キューサーバにスクリプトを登録する）

機能: JP1/AJS2，またはJP1/NetBatchのキューサーバに対してスクリプトを登録します。

形式

JOBSubmit (〔DomainName〕, QueSrvName , QueName , UserName , 〔JobName〕 , Priority , FilePath , 〔CommandLine〕 , JobNoBuff 〔, Flag〕 )

指定項目

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

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

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

UserName: ジョブを投入するユーザの名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で20文字以内（全角文字で10文字以内）です。; なお，JP1/AJS2から起動したスクリプトファイルでJOBSubmitコマンドを実行した場合，ログオンしたユーザの名称に変更されます。

JobName: 投入するジョブに付ける名称を文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で32文字以内（全角文字で16文字以内）です。; この値を省略する場合は，長さ0の文字列（""）を指定してください。このように指定するとFilePathで指定したファイル名の先頭32文字がジョブ名として扱われます。

Priority

投入するジョブの実行優先順位を指定します。

この値は次のどれかになります。

値	意味
0	対話処理と比較して低いことを表します。
1	対話処理と同等であることを表します。
2	対話処理と比較して高いことを表します。

FilePath: ジョブとして実行するスクリプトファイル名のフルパスを文字列，または値を格納した変数名で指定します。指定できる文字数は，半角文字で259文字以内（全角文字で129文字以内）です。; スペースを含むフルパスを指定しないでください。指定した場合は，正しく動作しません。

CommandLine: FilePathで指定したファイルに対するパラメタを文字列，または値を格納した変数名で指定します。サブミットするジョブにパラメタが不要な場合は，省略できます。省略する場合は，長さ0の文字列（""）を指定してください。; 指定できる文字数は，半角文字で256文字以内（全角文字で128文字以内）です。

JobNoBuff: 投入したジョブに割り当てられたジョブ番号を受け取る変数名を指定します。このジョブ番号は，JOBWaitコマンド，JOBHoldコマンド，JOBCancelコマンドで使用します。

Flag（01-01以降）: 内部的にJP1/AJS2，またはJP1/Net Batchの関数NetBatchQueueOpen，およびNetBatchQueueCloseを呼び出して指定されたキューの開閉をする場合は真（True）を，呼び出さないでキューの開閉をしない場合は偽（False）を指定します。; この値は省略できます。省略した場合，偽（False）を仮定します。; 同じキューに対して，ほかのアプリケーションと並行してこのコマンドを実行する場合，偽（False）を指定することを推奨します。

説明

指定されたキューに対して指定されたスクリプトファイルを登録します。

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

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

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

値	意味
0	正常終了。
1	パラメタに誤りがある。
2	メモリの不足や，TCP/IPが正しく設定されていないなど実行環境に不備がある。
3	ネットワークに障害が生じた。
4	次のどれかの状態を示す。指定したキューが存在しない。キュー名称に誤りがある。バッチジョブ運用が停止処理中，または停止状態である。 JP1/NetBatchサービスが初期化中である。キューが閉じられている。
10	JP1/NetBatchの関数NetBatchQueueOpen，またはNetBatchQueueCloseを使用するためのアクセス権がない。またはキューに投入できるジョブ数の最大値を超えたことによって，キューが強制的に閉じられたため，関数では操作できない。

なお，この値は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
  MessageBox ( "JOBSubmitで失敗しました！" ,OK , ,Ex )
End

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

8.12.1 JOBSubmit （キューサーバにスクリプトを登録する）

8.12.1　JOBSubmit （キューサーバにスクリプトを登録する）