D.2.2 Control Optionセクション

［説明］

バッチアプリケーションのカレントディレクトリを作成するためのパスを設定します。
本ステートメントで指定されたディレクトリに、ワークユニット名のディレクトリが作成され、さらにその配下にプロセスID名のディレクトリが作成されます。
プロセスIDのディレクトリがアプリケーションプロセスの実際のカレントディレクトリとなります。

本ステートメントには、255バイト以内の空白と半角カナ文字を除く文字列を指定することができます。
本ステートメントには、必ず絶対パスを指定してください。相対パスおよびカレントディレクトリ”.”は指定できません。

本ステートメントには、127バイト以内の制御文字(ShiftJISの0x00～0x1f,0x7f)を除く文字列を指定することができます。ただし、半角英文字の大文字と小文字、全角英文字の大文字と小文字は区別されません。絶対パスで指定してください。相対パスおよびカレントディレクトリ“.”は指定できません。

本ステートメントには、必ず実際に存在するパスを設定してください。パスが存在しない場合は、ワークユニットの起動に失敗します。
本ステートメントで指定されたディレクトリのディスク領域が不足している場合、ワークユニットの起動に失敗する場合があります。また、アプリケーションプロセスが異常終了した場合に、coreファイルが出力されます。そのため、十分なディスク領域を確保してください。

D.2.2.2 Application Retry Count：プロセス再起動リトライカウント数

［説明］

自動再起動不可となるまでのアプリケーションの連続異常終了回数を設定します。
本ステートメントには、0～255の整数値を指定することができます。
なお、本ステートメントは省略可能です。本ステートメントを省略した場合、または0を指定した場合は無条件に再起動を行います。

本ステートメントの設定は、セットアップコマンドで実施します。
したがって、編集しないでください。
セットアップコマンド以外で設定を変更した場合には、アプリケーションが異常終了すると、バッチワークユニットも停止し、対象ジョブキューのジョブの運用が停止する場合があります。

D.2.2.3 Path for Application：アプリケーション使用パス

［説明］

バッチアプリケーションが動作時に使用するパス（環境変数”PATH”）を設定します。

本ステートメントは最大30個まで指定できます。複数指定する場合は、ステートメントを繰り返し記述します。なお、同一パスを複数指定することはできません。
複数指定された場合、指定された順に環境変数”PATH”に設定されます。
また、本ステートメントで設定された値の後に、Interstage起動環境で設定されている”PATH”環境変数の値が設定されます。

本ステートメントには、255バイト以内の空白と半角カナ文字を除く文字列を指定することができます。
本ステートメントは省略可能です。

本ステートメントには、255バイト以内の制御文字(ShiftJISの0x00～0x1f,0x7f)を除く文字列を指定することができます。ただし、半角英文字の大文字と小文字、全角英文字の大文字と小文字は区別されません。本ステートメントは省略可能です。本ステートメントを省略した場合、アプリケーション使用パスなしと見なします。
本ステートメントは省略可能です。

D.2.2.4 Library for Application：アプリケーション使用ライブラリパス

［説明］

バッチアプリケーションが使用するライブラリのパス（環境変数”LD_LIBRARY_PATH”）を設定します。Windows(R)を利用する場合は、本項目は定義不要です。

本ステートメントは最大30個まで指定できます。
複数指定する場合は、ステートメントを繰り返し記述します。なお、同一パスを複数指定することはできません。
複数指定された場合、指定された順に環境変数”LD_LIBRARY_PATH”に設定されます。
また、本ステートメントで設定された値の後に、Interstage起動環境で設定されている”LD_LIBRARY_PATH”環境変数の値が設定されます。
本ステートメントには、255文字以内の空白と半角カナ以外の文字列を指定することができます。
本ステートメントは省略可能です。

LD_LIBRARY_PATH環境変数には、配備したバッチアプリケーションの種類によって設定が必要なものがあります。

COBOL使用時必須

/opt/FJSVcbl/lib
/opt/FSUNbsort/lib

オペレーティングテステムがRHEL5(Intel64)の場合
/opt/FJSVcbl64/lib
/opt/FJSVXbsrt/lib

オペレーティングテステムがRHEL5(Intel64)以外の場合
/opt/FJSVcbl/lib
/opt/FSUNbsort/lib
バッチジョブ定義データベースにSymfoware/RDBを利用する場合は必須

/opt/FSUNrdb2b/lib

/opt/FJSVrdb2b/lib

D.2.2.5 Environment Variable：環境変数

［説明］

バッチアプリケーションが動作時に使用する環境変数を、半角カナ文字を除いた4096バイト以内の文字列で設定します。
設定内容は以下のような形式で指定します。

Environment Variable:環境変数=値

LD_PRELOADなど、値をスペースで区切る環境変数を設定する場合は、以下の例のようにダブルクォーテーションで括って設定してください。

Environment Variable:"LD_PRELOAD=/etc/opt/FSUNiconv/lib/libicv.so /usr/lib/watchmalloc.so.1"

ただし、文字種別／長さ以外のチェックは行いません。

本ステートメントは複数指定することができます。その場合、すべての”Environment Variable”ステートメントで指定した文字列の合計が、4096バイト以内でなければなりません。
[Application Program]セクションの”Environment Variable”ステートメントで指定された環境変数と[Control Option]セクションの”Environment Variable”ステートメントで指定された環境変数が同じ場合は、[Application Program]セクションの”Environment Variable”ステートメントで指定された環境変数が使用されます。
なお、以下は本ステートメントの予約語なので指定できません。

PATH
LD_LIBRARY_PATH
CLASSPATH

本ステートメントは省略可能です。

環境変数には、設定が必要なものや、配備したバッチアプリケーションの種類によって設定が必要なものがあります。
以下の表をもとに設定してください。

名前	説明	必要性
LANG	文字コードを指定します。バッチアプリケーションのロケールに合わせて、指定してください。 ja EUCを利用する場合に指定します。 ja_JP.PCK SJISを利用する場合に指定します。 ja_JP.UTF-8 UTF-8を利用する場合に指定します。 ja_JP.eucJP EUCを利用する場合に指定します。 ja_JP.UTF-8 UTF-8を利用する場合に指定します。	必須
OD_CODE_SET	文字コードを指定します。バッチアプリケーションのロケールに合わせて、指定してください。 EUC EUCを利用する場合に指定します。 SJISMS SJISを利用する場合に指定します。 UTF8 UTF-8を利用する場合に指定します。 EUC EUCを利用する場合に指定します。 UTF8 UTF-8を利用する場合に指定します。 SJISMS SJISを利用する場合に指定します。 UTF8 UTF-8を利用する場合に指定します。	必須
APFW_PARAM_COMPLEMENT_MODE	入力パラメタの未設定データの判定を行う場合に指定します。固定で次の値を設定します。 ON	入力パラメタの未設定データの判定時必須 (*)
NLSPATH	COBOLランタイムのエラーメッセージファイルの格納PATHを指定します。固定で次の値を設定します。 /opt/FJSVcbl/lib/nls/%L/%N.cat:/opt/FJSVcbl/lib/nls/C/%N.cat:/opt/FSUNbsort/lib/nls/%L/%N.cat:/opt/FSUNbsort/lib/nls/C/%N.cat オペレーティングテステムがRHEL5(Intel64)の場合 /opt/FJSVcbl64/lib/nls/%L/%N.cat:/opt/FJSVcbl64/lib/nls/C/%N.cat:/opt/FJSVXbsrt/lib/nls/%L/%N.cat:/opt/FJSVXbsrt/lib/nls/C/%N.cat オペレーティングテステムがRHEL5(Intel64)以外の場合 /opt/FJSVcbl/lib/nls/%L/%N.cat:/opt/FJSVcbl/lib/nls/C/%N.cat:/opt/FSUNbsort/lib/nls/%L/%N.cat:/opt/FSUNbsort/lib/nls/C/%N.cat	COBOL使用時必須
@CBR_CONSOLE	COBOLアプリケーションを動作させる場合に設定します。固定で次の値を設定します。 SYSTEM 本パラメタの詳細については、NetCOBOLのマニュアルの使用手引書を参照してください。	COBOL使用時必須
@WinCloseMsg	COBOLアプリケーションを動作させる場合に設定します。固定で次の値を設定します。 OFF 本パラメタの詳細については、NetCOBOLのマニュアルの使用手引書を参照してください。	COBOL使用時必須

*：“入力パラメタの未設定データの判定”については、“Interstage Job Workload Server バッチ開発ガイド”の“COBOLアプリケーションのインタフェース”を参照してください。

以下に示す環境変数には、バッチアプリケーションの文字コードに合わせて統一した値を設定する必要があります。

LANG
OD_CODE_SET
NLS_LANG

D.2.2.6 Startup Time：ワークユニット起動待ち時間

［説明］

ワークユニットの起動が完了するまでの監視時間（秒）を設定します。
本ステートメントには、0～65535の整数値を指定することができます。
アプリケーションプロセスの起動処理が指定された時間を超過した場合は、プロセスをシャットダウンし起動処理を中止します。
その場合、ワークユニット起動処理は異常終了します。

本ステートメントは省略可能です。本ステートメントを省略した場合、省略値として180が設定されます。
なお、0が設定された場合は、起動時間監視は行いません。ワークユニット起動処理が完了するまで待ち続けます。

D.2.2.7 Shutdown Time：プロセス強制停止時間

［説明］

ワークユニットの強制停止が完了するまでの監視時間（秒）を設定します。
本ステートメントには、0～65535の整数値を指定することができます。
アプリケーションプロセスの強制停止処理が指定された時間を超過した場合は、プロセスをシャットダウンし、停止処理は正常終了します。

本ステートメントは省略可能です。本ステートメントを省略した場合、省略値として180が設定されます。
なお、0が設定された場合は、停止時間監視は行いません。
ワークユニットの停止処理が完了するまで待ち続けます。

D.2.2.8 Start Log：プロセス起動ログ採取

［説明］

ワークユニットのプロセス起動時のログの出力の有無を設定します。

”YES”: 起動ログを採取します。
”NO”: 起動ログを採取しません。

”YES”が指定された場合、ワークユニットのカレントディレクトリ配下にログファイルを作成し、プロセスの起動パラメタおよび起動時の環境変数を出力します。
ログファイルの出力先とファイル名は、以下のとおりです。

[カレントディレクトリ]/[ワークユニット名]/[プロセス ID]_info.log

[カレントディレクトリ]\[ワークユニット名]\[プロセス ID]_info.log

本ステートメントは省略可能です。本ステートメントを省略した場合、省略値として”NO”が設定されます。
本ステートメントを指定することにより、開発段階において環境変数に誤りが無いか確認するための、調査資料を採取することができます。

D.2.2.9 Process Degeneracy：プロセス縮退運用

［説明］

ワークユニット運用中に、プロセスの異常終了が発生した場合、自動再起動機能によりプロセスは再起動されます。
この時、何らかの原因によりプロセスの再起動に失敗した場合、プロセス数が1つ少ない状態で運用を継続(縮退運用)することができます。

”YES”: 再起動に失敗した場合、プロセス数を縮退し、運用を継続します。
”NO”: 再起動に失敗するとワークユニットを停止します。

プロセス多重度(Concurrency)が2以上の場合に有効です。
なお、プロセス再起動失敗を繰り返し、運用中のプロセス数が0になった場合は、ワークユニットを停止します。

本ステートメントは省略可能です。本ステートメントを省略した場合、省略値として”NO”が設定されます。
本ステートメントを指定することで、プロセス異常終了後、再起動に失敗した場合でも、残りのプロセスでワークユニットの運用を継続することができます。
そのため、本ステートメントに”YES”を指定することを推奨します。