Submit ルール

適用範囲

オブジェクト:トランザクション
言語:.NET、Ruby、Cobol、Java、RPG、Visual FoxPro
インターフェース:Web、Win

目的

プログラムは非同期に実行されます。
Syntax
   Submit(program, submit-parms [ , parm1, … , parmN ] ) [ if cond ] ;

入力値の説明:
program
    呼び出すプログラムの名前です。GeneXus プログラム、外部プログラムのどちらも指定できます。GeneXus プログラムを使用する場合、有効なプログラムは、画面を使用しないプロシージャーのみです (つまり、問い合わせと確認がないものです)。この名前は文字列とし、引用符の間に記述する必要があります。変数は使用できません。

    iSeries 環境
       外部プログラムを使用する場合、制限が 1 つだけ存在します。つまり、Submit ルールを実行する際には、プログラムがジョブのライブラリーリストに含まれている必要があります。

submit-parms
    呼び出すプロセスで使用する場所、ユーザー名、パスワードに関連するパラメーターを指定するために使用します。
    このパラメーターは Windows 環境でのみ使用し、当分の間、すべてのジェネレーターによって無視されます。

    iSeries 環境
    カンマ区切り形式の文字列であり、バッチモードでジョブのパラメーターを指定するために使用します。パラメーターの内容の構造は次のとおりです:
    KEYWORD=VALUE [ KEYWORD=VALUE [ ... ] ]
    適用可能なキーワードの値およびその意味を次の表に示します:

キーワード	説明	既定値
JN	実行されるジョブのデスクリプション名 (*)	*JOBD
JDF	ジョブデスクリプションファイルの名前を示す (*)	*USRPRF
JQ	ジョブが送信されるジョブのキューの名前(*)	*JOBD
JQP	ジョブのキューの優先度を示す(**)	*JOBD
PD	ジョブによって生成されるすべての情報の印刷に使用されるプリンターの名前(*)	*CURRENT
PQ	ジョブによって生成されるすべての情報が送信される印刷のキュー(*)	*CURRENT
H	ジョブのキューにジョブが保持されるかどうかの指定を可能にする(***)	*JOBD

(*) 文字または数字で構成される文字列であること。先頭には文字を使用する必要があり(スペースは使用不可)、最大文字数は 10 文字です。
(*) 1 ～ 9 の数字であること。
(***) 有効な値は「Y」および「N」。

parm1, … , parmN
呼び出されるプログラムが受け取るパラメーター。パラメーターは項目属性と変数が使用できます。エクスプレッションまたは定数の受け渡しはサポートされていません。各パラメーターの定義が、プログラムのデータタイプと一致することを確認してください。

説明

非同期の実行が許可されない環境　(つまり、DOS) では、SUBMIT ルールまたはコマンドの機能が CALL コマンドの機能と同一であると認識されます。submit-parms パラメーターは無視されます。

注:
各ルールまたは一連のルールには、特定の環境においてのみトリガーされることを指定できます。詳細については、次のドキュメントを参照してください:『フォーム - 特定のイベントとルール』

例

iSeries 環境:パラメーター &A および &B を使用して、MYPGRAM と呼ばれるプログラムを実行するために次のコマンドが使用されます。これは、優先度 3 を使用したジョブのキューである BATCHQUEUE 内で GENINVOICE として実行される必要があり、ジョブのキューには保持されません。

SUBMIT('MYPGRAM','JN=GENINVOICE JQ=BATCHQUEUE JQP=3 H= N',&A,&B)
SUBMIT は、アプリケーション内に存在する各 SUBMIT (ルールまたはコマンド) の CL プログラムの生成によって実装されます。SUBMIT はこれらの CL プログラムによって実際に実行されます。これらの CL プログラムは対応するプログラム (COBOL または RPG) から呼び出されます。

実行されるコマンドは次のとおりです:
SBMJOB CMD(CALL PGM(Program) PARM('Parm1Val'….'ParmNVal’)) [ JOB(Vjn) ] [ JOBD(Vjdf) ] [ JOBQ(Vjq) ] [ JOBPTY(Vjqqp) ] [ PRTDEV(Vpd) ] [ OUTQ(Vpq) ] [ HOLD(Vh) ]

プログラム:iSeries バージョンの COBOL で実行される場合、無効な Cobol 文字 ('_'、ñ など) で構成することはできません。
Parm1Val, …, ParmNVal:Parm1 ….ParmN に対応する値です。

Vxxx:ユーザーがキーワード xxx に割り当てる値です。指定しない場合、GeneXus によって既定値であると見なされます。

iSeries 環境において SubmitParms パラメーターに属する既定のキーワード値です。
JN	呼び出される名前
JDF	*USRPRF
JQ	*JOBD
JQP	*JOBD
PD	*CURRENT
PQ	*CURRENT
H	*JOBD

参考情報

Call コマンド
Call ルール
Submit コマンド