2.2.14 ログファイル監視ジョブ定義情報の記述方法
ログファイル監視ジョブ定義情報の記述方法を説明します。
ログファイル監視ジョブ定義情報の形式,およびパラメーターを次に示します。
- 形式
[lftpd=[!]"トラップデータ1"[:[!]"トラップデータ2"...];]...
[lffnm="ログファイル名";]
[lfdft={s|s2|w1|w2};]
[lfrft={v:'[¥]区切り文字'|f:レコード長};]
[lfhds={l:ヘッダー行数|s:ヘッダーサイズ};]
[lfmks=[!]"ログ情報以外のデータ1"
[:[!]"ログ情報以外のデータ2"...];]
[lfsiv=ファイル監視間隔;]
[lfmxl=イベントデータの最大長;]
[lfsrc={y|n};]
[lfcre={y|n};]
[jpoif=?マクロ変数名?:引き継ぎ情報名;]
[etm=n;]
[fd=実行所要時間;]
[ex="実行ホスト名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
- パラメーター
- lftpd=[!]"トラップデータ1"[:[!]"トラップデータ2"...];
- トラップするログファイル中のデータを定義します。
- 一つのlftpdパラメーターに複数のトラップデータを指定できます(AND条件が適用されます)。また,複数のlftpdパラメーターを指定できます(OR条件が適用されます)。バイト数の合計が2,048バイトまで複数指定できます。
- トラップデータ中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- なお,トラップデータには正規表現が使用できます。
- lffnm="ログファイル名"
- 監視するファイル名を定義します。
- 指定できる文字数は,1~256(単位:バイト)です。「lffnm="ログファイル名"」の形式で,8件まで同時に指定できます。
- ログファイル名中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- lfdft={s|s2|w1|w2};
- トラップするログファイルの出力形式を定義します。省略した場合,sが仮定されます。
- s:シーケンシャルファイル(単調増加ファイル)
- s2:シーケンシャルファイル(ファイル名を変更して,同一名称でファイルを作成するファイル)
- w1:ラップアラウンド(ラップ時,ファイルの先頭から上書きする)
- w2:ラップアラウンド(ラップ時,データを削除したあと,ファイルの先頭から記述する。ファイルを削除,または名称を変更して作成し直す運用の場合は,適用できない)
- lfrft={v:'[¥]区切り文字'|f:レコード長};
- トラップするログデータのレコード形式を定義します。省略した場合,v:'¥n'が仮定されます。
- v:'[¥]区切り文字':可変長レコードで行を区切ります。区切り文字に指定できる文字数は,1(単位:バイト)です。
- f:レコード長:固定長レコードで行を区切ります。レコード長に指定できる文字数は,1~9,999,999(単位:バイト)です。
- lfhds={l:ヘッダー行数|s:ヘッダーサイズ};
- ヘッダーを定義します。
- l:ヘッダー行数:トラップするログファイルの先頭にヘッダーがある場合,ヘッダーの行数を指定します。
ヘッダー行数に指定できる値は,0~99,999(単位:行)です。
- s:ヘッダーサイズ:バイナリーデータやレコード形式がログレコードと異なっているなどの理由で,トラップするログファイルの先頭に行数で指定できないヘッダーがある場合,ヘッダーのサイズを指定します。
ヘッダーサイズに指定できる値は,0~9,999,999(単位:バイト)です。
- lfmks=[!]"ログ情報以外のデータ1"[:[!]"ログ情報以外のデータ2"...];
- トラップするログファイル中にログ情報以外のデータが含まれる場合,そのデータを定義します。
- データは複数指定できます(バイト数の合計が1,024バイトまで複数指定できます)。
- データ中に「"(ダブルクォーテーションマーク)」や「#」が含まれる場合は,キャスト文字(#)でキャストします。「"」は「#"」,「#」は「##」と記述します。
- なお,データには正規表現が使用できます。
- 複数のlfmksパラメーターを指定した場合,OR条件が適用されます。一つのlfmksパラメーターに複数のデータを指定した場合は,AND条件が適用されます。
- lfsiv=ファイル監視間隔;
- ログファイルを検索する時間間隔を定義します。
- 指定できる値は,1~86,400(単位:秒)です。省略した場合,10が仮定されます。
- lfmxl=イベントデータの最大長;
- 入力する指定ログファイル1行の先頭何バイト分をイベントデータにするかを定義します。
- 指定できる値は,2~512(単位:バイト)です。省略した場合,512が仮定されます。
- lfsrc={y|n};
- データの入力を先頭データから入力するかを定義します。省略した場合,nが仮定されます。
- y:先頭データから入力します。
- n:先頭データから入力しません。
- lfcre={y|n};
- ログファイル監視ジョブを開始した場合に,指定したログファイルがなかったときにエラーにするかを定義します。省略した場合,nが仮定されます。
- y:エラーとします。
- n:ログファイルが作成されるまで,ファイルのオープンを繰り返します。
- jpoif=?マクロ変数名?:引き継ぎ情報名;
- マクロ変数名は,「?AJS2xxxxxxxxx?」の形式で指定します。文字列(「xxxxxxxxx」の部分)の前に「AJS2」を指定し,全体を「?」で囲みます。文字列(「xxxxxxxxx」の部分)に指定できるのは,英(ただし,大文字だけ)数字と,「.(ピリオド)」だけです。
- マクロ変数名(「?AJS2xxxxxxxxx?」の部分)に指定できる文字数は,1~64(単位:バイト)です。
- このパラメーターは,「jpoif=?マクロ変数名?:引き継ぎ情報名;」の形式で,バイト数の合計が2,048バイトまで指定できます。
- このパラメーターでは,後続のUNIXジョブ,PCジョブ,およびアクションジョブに対してイベント情報を引き継げます。
- etm=n;
- 実行打ち切り時間を,実行開始時刻からの相対分で定義します。指定できる値は,1~1,440(単位:分)です。起動条件内のジョブの場合,このパラメーターは無効になります。
- fd=実行所要時間;
- 終了遅延監視するジョブの実行所要時間を定義します。
- 指定できる値は,10進数の値で1~1,440(単位:分)です。
- ex="実行ホスト名";
- ジョブを実行するエージェントホスト名を定義します。指定できる文字数は,1~255(単位:バイト)です。
- ha={y|n};
- ジョブの実行を保留するかを定義します。省略した場合,nが仮定されます。起動条件内のジョブの場合,このパラメーターは無効になります。
- eu={ent|def};
- ジョブ実行時のJP1ユーザーを定義します。省略した場合,entが仮定されます。イベントジョブの場合,このパラメーターの指定は無視されます。
- ent:ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。
- def:ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。
- ets={kl|nr|wr|an};
- 実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合,klが仮定されます。起動条件内のジョブの場合,このパラメーターは無効になります。
- kl:強制終了
- nr:正常終了
- wr:警告検出終了
- an:異常検出終了
- 注意事項
- ログファイル名には,空白文字や記号なども使用できます。ただし,「"(ダブルクォーテーションマーク)」などの特殊文字を通常文字として扱う場 合は,これらの特殊文字の前に「¥」を指定してください。
(例)
log¥#"file
- イベントジョブの受信情報を引き継ぎ情報として,標準ジョブやアクションジョブのパラメーターに引き継ぐ場合で,引き継ぐ情報に「"(ダブルクォーテーションマーク)」が含まれるとき,「¥」を前に付けて指定する必要があります。「¥」を付けない場合,受信情報を引き継いでも「"(ダブルクォーテーションマーク)」が無視されるなどの現象が発生します。これを防止するためには,「"(ダブルクォーテーションマーク)」を含むデータを指定したとおりに引き継ぎ情報として引き継がせるオプションを設定してください。
設定については,Windowsホストの場合は,マニュアル「JP1/Automatic Job Management System 2 セットアップガイド 7.13 「"(ダブルクォーテーションマーク)」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定」を,UNIXホストの場合は,マニュアル「JP1/Automatic Job Management System 2 セットアップガイド 16.9 「"(ダブルクォーテーションマーク)」を含むデータをイベントジョブの引き継ぎ情報に使用するための設定」を参照してください。