initUtil

形式

public void initUtil( String p_apname,
                      String p_utlname)
         throws BLCException

機能

ユティリティ専用のBLC初期化処理(実行時情報の設定)を行います。

BLCの各メソッドを使用する前に,必ずこのメソッドをコールしてください。

本メソッドを実行した場合,プロセスが終了する前にfinalUtil()を必ず実行してください。

本メソッドでは以下の処理を行います。

備考
p_apnameに"ABC"を,p_utlnameに"XYZ"を指定した場合。
読込みリソース名は,下記のファイル名を対象とします。
  • BLCプロパティ:ABC.BLCproperties
出力トレース名
  • BLCトレース:XYZ_BLCTrace-"面数".log

パラメータ

p_apname

アプリケーション名を16バイト以内で指定します。

「"アプリケーション名".BLCproperties」ファイルが存在するパスがClassPathに追加されていない場合,BLC例外をスローします。

本パラメタの指定値,および,BLCTraceクラスのputTraceメソッドで指定するアプリケーション名もプロセス間で競合しないよう注意が必要です。

p_utlname

実行するユティリティ名を16バイト以内で指定します。

同じユティリティ名のアプリケーションが同時に実行された場合の動作は保証できません。

よって,ユティリティ側で本メソッドをコールする前に2重起動防止チェックを行ってください。

例外

BLCException

パラメタ不正,または実行情報の取得に失敗