バッチジョブ実行システムからJavaバッチアプリケーションを実行する場合には，次に示す情報をジョブ定義XMLファイルに指定する。バッチジョブ実行システムは，これらの情報を指定してcjexecjobコマンドを呼び出し，Javaバッチアプリケーションを実行する。

表3-54　ジョブ定義XMLファイルに指定する情報

指定例を次に示す。

 
<EXEC PGM="jp.co.Hitachi.MyBank.MyJob" LANG="Java" Group="MyGroup" Option="-cp 
C:\mydir\hello.jar -DHello=World" PARM="myjob check_transaction" />
 

DD要素で指定した内容は，バッチジョブ実行システムによって-DオプションとしてJavaオプションに指定される。指定例を次に示す。

 
<DD NAME="WRITEDATA" TYPE="FILE" DSN="C:\myinfo\mydata.txt" DISP="OLD" />
 

ジョブ定義XMLファイル中のLANG="Java"のジョブステップで上記DD要素が定義された場合，バッチジョブ実行システムはNAME属性の指定値に"DDN_"を与えた文字列とDSN属性の指定値を，それぞれ次に示すように-Dオプションの<name>および<value>としてJavaオプションに設定する。指定例を次に示す。

 
-DDDN_WRITEDATA="C:\myinfo\mydata.txt"
 

これによって，Javaアプリケーション内で<name>の値をキーとして，DD要素に指定されたファイルのパス名を取得できる。指定例を次に示す。

 
　　　　　:
java.lang.String mystr;
mystr = System.getProperty("DDN_WRITEDATA");
 
// これによってmystrに"C:\myinfo\mydata.txt"が格納される。
　　　　　:
 

バッチジョブ実行システムは，ジョブ定義XMLファイルに指定されたJavaバッチアプリケーション用の属性値に基づいてcjexecjobコマンド用の引数を作成し，cjexecjobコマンドを呼び出す。

ジョブ定義XMLファイルでのJavaバッチアプリケーション用のXML属性の指定方法を次に示す。

 
<EXEC PGM="<Javaアプリケーションクラス名>" LANG="Java"
Group="<スケジュールグループ名>" Option="<Javaオプション>"
PARM="<mainメソッドに渡す引数>"/>
<DD NAME="<-Dオプションのname部分"DSN="<-Dオプションのvalue部分"/>
 

上記のXML定義ファイルを指定した場合，バッチジョブ実行システムは次のようにcjexecjobコマンドを呼び出す。

 
cjexecjob△<スケジュールグループ名>△-jobID△<ジョブID>△
<Javaオプション>△"-DDDN_<-Dオプションのname部分>=
<-Dオプションのvalue部分>"△"<Javaアプリケーションクラス名>"△
<mainメソッドに渡す引数>
 

構築例を次に示す。

 
<EXEC PGM="jp.co.Hitachi.MyBank.MyJob" LANG="Java"
Group="MyGroup" Option="-cp C:\mydir\hello.jar -DHello=World"
PARM='"myjob check_transaction"'/><DD NAME=" WRITEDATA"
DSN="C:\myinfo\mydata.txt" DISP="OLD"/>
 

上記のジョブ定義XMLを指定した場合，次のようなcjexecjobコマンドラインが構築される。

 
cjexecjob△MyGroup△-jobID△<BJEXが自動割り当てした29桁の英数字>
△-cp△C:\mydir\hello.jar△-DHello=World△
-DDDN_WRITEDATA=C:\myinfo\mydata.txt△"myjob check_transaction"
 

ジョブスケジューリング機能を利用したJavaアプリケーションの実行には，ジョブIDの情報が必要となる。LANG="Java"指定のJavaバッチアプリケーションの実行ではバッチジョブ実行システムが，実行したJavaバッチアプリケーションを識別するために独自にジョブIDを割り当てる。その機能によって，ジョブステップごとにユニークなジョブIDを保証するため，Option属性にcjexecjobコマンドの"-jobID"オプションを指定しないこと。指定した場合，バッチジョブ実行システムからJavaバッチアプリケーションの強制停止はできない。バッチジョブ実行システムは，次の形式でジョブIDを作成してJavaアプリケーションに割り当てるため，運用でほかのJavaバッチアプリケーションと重複しないようにすること。Javaアプリケーションに対するジョブIDの割り当て形式を次の図に示す。

図3-47　Javaアプリケーションに対するジョブIDの割り当て形式

Javaアプリケーションに対するジョブIDの割り当て形式の項目と内容を次の表に示す。

表3-55　Javaアプリケーションに対するジョブIDの割り当て形式の項目と内容

• 空白を含む文字列を属性値として指定する場合は，シングルクォートとダブルクォートの順に囲むこと。次に例を示す。
  
  1. mainメソッドへの引数として空白入りの文字列「KAIKEI HOUKOKU」を渡したい場合は，PARM='"KAIKEI HOUKOKU"'と指定する。
  2. -Dオプション「PROFIT」に対し，value部分に空白入りの文字列「KESSAN VALUE」を指定したい場合は，Option='-DPROFIT="KESSAN VALUE"'と指定する。
• Javaオプションとして，-cp，-classpath，-D以外はサポートしないため指定しないこと。詳細については，マニュアル「Cosminexus アプリケーションサーバ V8 リファレンス コマンド編」のcjexecjobコマンドを参照のこと。
• LANG="Java"を指定しないでGroupやOptionを指定した場合は，エラーとなる。
• DD要素に指定できる属性に制限はないが，ISAMファイルなどはJavaから利用することは困難なため，指定するファイルについて考慮すること。
• LANG="Java"を指定する場合，従来のバッチサーバ名称指定によるJavaバッチアプリケーションの実行はできない。
• cjexecjobコマンドの引数は「Javaオプション」，「Javaアプリケーションクラス名」，および「mainメソッドに渡す引数」の文字数合計が1,024バイト以下であること。そのため，ジョブ定義XMLファイルに指定する値の文字数には注意すること（特に世代ファイルの作成数には注意すること）。cjexecjobコマンドの引数の詳細についてはマニュアル「Cosminexus アプリケーションサーバ V8 リファレンス コマンド編」を参照のこと。
• cjexecjobコマンドが異常終了した場合，cjexecjobが出力するエラーメッセージが，ジョブステップの標準エラー出力としてジョブログに出力される。
• 使用するOSごとに，コマンドラインに入力できる文字数に上限がある。そのため，各属性に指定した値の長さが上限値以内であっても，各属性の長さの合計がOSごとの上限を超えないように注意すること。