2.2.1 JP1/AJS3 for EAP(ジョブ制御)の動作環境を設定する
JP1/AJS3 for EAP(ジョブ制御)の動作環境は,ジョブ制御用の環境設定ファイルを編集することで変更できます。
ジョブ制御用の環境設定ファイル(confファイル)は,以下に示すパスにあります。インストール時に環境設定ファイルが存在しなかった場合は,同じディレクトリ下にあるモデルファイルと同じものが,環境設定ファイルとしてインストール時に自動的に作成されます。
-
Windowsの場合
インストール先フォルダ\conf\conf
-
Linuxの場合
/etc/opt/jp1_am_r3/conf/conf
インストール時に作成される環境設定ファイルの基になるモデルファイルの内容を次の図に示します。
-
Windowsの場合
図2‒1 ジョブ制御用環境設定ファイルのモデルファイル(Windows版) -
Linuxの場合
図2‒2 ジョブ制御用環境設定ファイルのモデルファイル(Linux版)
OSがWindowsで,ファイルシステムにNTFS形式を使用している場合,環境設定ファイルの情報の改ざんを防ぐために,環境設定ファイルに対して,Administrators権限を持つ管理者だけが環境設定ファイルを編集できるようなアクセス権を設定しておくことをお勧めします。
なお,環境設定ファイルを再編集する場合は,JP1/AJS3 for EAPのコマンドが実行されていないことを確認してください。
環境設定ファイルでの文法は,次のとおりです。
[section] key=string
-
sectionとkey,keyとkeyの区切りには,一つ以上の改行コードを指定します。
-
sectionおよびkeyに指定する文字列では,大文字,小文字が区別されません。
-
同一section内でのkeyの指定順序は任意です。
-
行の先頭に「;」が指定されている場合,その行をコメント文として扱います。
-
複数の同じ名称のsectionまたはkeyが指定されていた場合,最初に指定されていた値が有効になります。
次の場合,JP1/AJS3 for EAPは項目のデフォルトを使用して動作します。
-
環境設定ファイルを作成しなかった場合
-
環境設定ファイルに指定した値が不正な場合(シンタックスエラーを含む)
-
環境設定ファイルが読み込めない場合
次に,環境設定ファイルに指定できるkeyをセクションごとに説明します。
-
trace(トレースセクション)
トレースセクションでは,トレースレベル,トレースファイルサイズ,およびトレース情報を格納するトレースファイル名を指定します。
traceに指定できるkeyを次の表に示します。
注※1 トレースファイルサイズを307,200キロバイトに設定した場合,トレースレベル2(デフォルト)で100件/時間のジョブを実行したときに,少なくとも7日間分のトレースデータを記録できます。
注※2 UNC形式で表されるリモート資源名とは,Microsoft社が提供しているネットワーク上のフォルダおよびファイル名を指定する,「\\コンピュータ名\共有名」を指しています。このフォルダおよびファイルは,常時アクセスできるようにする必要があります。
注※3 トレースファイルが標準で格納されるディレクトリについては,「付録A ディレクトリ名一覧」を参照してください。
- 重要
-
トレースファイルの出力時に一時ディレクトリを使用します。
Windowsの場合,環境変数TMPで指定したフォルダを使用します。環境変数TMPには,コマンド実行ユーザーの権限でアクセスできるフォルダを指定してください(JP1/AJSで実行する場合,JP1/AJSのサービスに対するアカウントがデフォルトのときは,システム環境変数のTMP環境変数になります)。
-
event(イベントセクション)
Windowsの場合,event(イベントセクション)では,Windowsのアプリケーションログで使用されるイベントを生成するかどうかを指定します。
Linuxの場合,event(イベントセクション)では,syslogメッセージを生成するかどうかを指定します。eventに指定できるkeyを次の表に示します。
-
command(コマンドセクション)
command(コマンドセクション)では,JP1/AJS3 for EAPの作業ディレクトリ,ジョブの終了監視時間間隔,指定したR/3オブジェクトの妥当性をチェックするかどうか,通信エラーが発生したときの接続回復を試みる時間・時間間隔,およびR/3ジョブログを標準エラー出力ファイルにも出力するかどうかを指定します。また,接続先のUnicode版 SAPシステムで,文字コードの変換時に使用するコードページ番号も指定します。commandに指定できるkeyを次の表に示します。
注※1 UNC形式で表されるリモート資源名とは,Microsoft社が提供しているネットワーク上のフォルダ名を指定する,「\\コンピュータ名\共有名」を指しています。このフォルダは,常時アクセスできるようにする必要があります。
注※2 JP1/AJSのジョブ実行時のワークパスについては,マニュアル「JP1/Automatic Job Management System 3 設計ガイド(システム構築編)」を参照してください。
注※3 checklevelに「0」を指定した場合に比べて,ネットワークに掛かる負荷が大きくなります。また,コマンドの実行時間も長くなります。
注※4 RetryCountまたはRetryTimeを指定する場合は,互いに他方のkeyを指定するかどうかによって,有効となるkeyが異なります。
keyの指定 |
RetryCount |
||||
---|---|---|---|---|---|
指定なし |
指定あり |
||||
0 |
N(>0) |
||||
RetryTime |
指定なし |
(1)3回リトライ |
(4)即座にエラー |
(5)N回リトライ |
|
指定あり |
0 |
(2)即座にエラー |
(4)即座にエラー |
(5)N回リトライ |
|
T(>0) |
(3)T分間リトライ |
(4)即座にエラー |
(5)N回リトライ |
(1) RetryTimeとRetryCountを両方とも指定がない場合,RetryCountのデフォルト値3回リトライ。
(2) RetryTimeが0でRetryCountが指定なしのためエラー。
(3) RetryTimeの指定が有効。T分間リトライ。
(4) RetryCountが0のため,即座にエラー。
(5) RetryCountの指定が優先のため,N回リトライ。
注※5 RetryCount,RetryTimeを指定した場合の動作を次に示します。
-
XMI(XMIセクション)
XMI(XMIセクション)では,XMIインターフェースセッションの監査レベルを指定します。XMIに指定できるkeyを次の表に示します。
Key |
stringに指定できる値 |
説明 |
---|---|---|
|
このkeyの指定を省略した場合,既存のXMIインターフェースセッションの監査レベルは変更されません。 |