(3) COBOL
5.3 EUR Server でのログの採取
5.3.6 EPS-XLSX ログ
ユーザ=UserAccount : コマンド=eurps formsheet.fms,mapdata.csv,usrdata.csv -t pdf -pf output.pdf
出力例 2
04/09/07 17:15:00 [ 2532] Err Category=002, Detail=0001, /eurps/datafile/usrdata error = 2
04/09/07 17:15:00 [ 2532] Err KEEU006-E 指定したデータファイル(usrdata)を読み込め ません。(2) : ユーザ=UserAccount : コマンド=eurps
formsheet.fms,mapdata.csv,usrdata.csv -t pdf -pf output.pdf
ss
実行時刻の秒を示します。
lll
実行時刻のミリ秒を示します。
PPPPPPPPPP
実行時のプロセス ID を示します。
ログファイルの出力先の指定
環境変数,または環境設定ファイルの EURPS_LOGFILEPATH で指定した eurps.log の出力先フォル ダと同じフォルダに出力します。指定したログファイルの出力先が存在しない場合,またはログファイ ルの出力先が指定されていない場合は,出力先フォルダを自動的に作成し,ログファイルを出力します。
EURPS_LOGFILEPATH については,マニュアル「EUR 帳票出力 リファレンス EUR Server 編」を 参照してください。
ログファイルの出力先の自動生成については,「5.3.5(1) 帳票出力時に eurps ログの出力先フォルダ を作成する機能」を参照してください。
ログファイルの出力単位
ログファイルは,Excel 形式ファイルを出力するたびに,エラーレベルまたはワーニングレベルのメッ セージと一緒に一つのファイルとして出力されます。Excel 形式ファイルを複数回出力すると,出力し た回数だけログファイルが出力されます。ただし,出力するエラーレベルまたはワーニングレベルの メッセージがない場合は,ログファイルは出力されません。
ログファイルの容量
出力される EPS-XLSX ログファイルの最大ファイル容量は 2GB です。採取したログの容量が 2GB を 超えた場合は,2GB まではログファイルに出力されます。それ以降のログは出力されません。
ログファイルへのメッセージ出力レベルの指定
ログファイルに出力するメッセージは,メッセージ出力レベルの指定によって出力する内容を変更でき ます。メッセージ出力レベルは,環境変数 EURPS_EXCELLOGFILELEVEL に設定します。次に示す 2 種類のメッセージ出力レベルを設定することで,出力されるメッセージの内容を選択できます。
表 5‒10 メッセージ出力レベル
環境変数の設定値 出力されるメッセージの内容
INFO エラーレベル(Error(Err))とワーニングレベル(Warning
(War))のログを出力します(デフォルト)。
ERROR エラーレベル(Error(Err))だけを出力します。
ログファイルに出力されるメッセージの内容を次に示します。
エラーレベル
Excel 形式ファイル出力時に発生したエラーメッセージを出力します。
ワーニングレベル
ログファイルに出力される情報の詳細については,「5.3.6(1) EPS-XLSX ログの出力形式」を参照し てください。
ログファイルに出力されるメッセージは,次に示す文字コードで表示されます。なお,変換できない文 字は,「?」で出力されます。
• Windows 環境の場合:UTF-16 で表示されます。
• UNIX/Linux 環境の場合:設定されている文字ロケール環境に依存します。
(1) EPS-XLSX ログの出力形式
EPS-XLSX ログの出力形式について,次に示します。
(a) ヘッダ情報
EPS-XLSX ログは,次に示す形式でヘッダ情報を出力します。
PP△VV-RR[Ret]
[Ret]
PP
EUR Server Standard の形名を示します。
VV
ライブラリ(Windows 環境の場合は LibXLS.dll,UNIX/Linux 環境の場合は libxls.so)のバージョ ン番号を示します。
RR
ライブラリ(Windows 環境の場合は LibXLS.dll,UNIX/Linux 環境の場合は libxls.so)のリビジョ ン番号を示します。
[Ret]
改行コード(Windows 環境の場合 CR+LF,UNIX/Linux 環境の場合 LF)を示します。
△
半角空白を示します。
(b) メッセージ情報
EPS-XLSX ログは,次に示す形式でメッセージ情報を出力します。
YY/MM/DD△HH:MM:SS△PPPPPPPPPP△状態△実メッセージ[Ret]
YY
実行時刻の西暦下 2 桁を示します。
MM
DD
実行時刻の日を示します。
HH
実行時刻の時を示します。
MM
実行時刻の分を示します。
SS
実行時刻の秒を示します。
PPPPPPPPPP
実行時のプロセス ID を示します。
状態
メッセージのレベル(エラー(Err)またはワーニング(War))を示します。
実メッセージ
EPS-XLSX ログに出力される詳細情報を示します。詳細情報については,「5.3.6(1)(c) 実メッセージ に出力される情報(エラーレベルのメッセージ)」および「5.3.6(1)(d) 実メッセージに出力される情 報(ワーニングレベルのメッセージ)」を参照してください。
[Ret]
改行コード(Windows 環境の場合 CR+LF,UNIX/Linux 環境の場合 LF)を示します。
△
半角空白を示します。
(c) 実メッセージに出力される情報(エラーレベルのメッセージ)
メッセージのレベルが「Err」(エラーレベル)のログについて,実メッセージに出力される情報を次に示 します。
APINAME:reason(0xXXXXXXXX):module(0xXXXXXXXX):pos(0xXXXXXXXX):errno(xx):message(xx) なお,「errno(xx)」および「message(xx)」は,システムエラーの場合だけ出力されます。
APINAME
エラーが発生した API 名を示します。
reason(0xXXXXXXXX)
エラーが発生した場合の理由コードを示します。
module(0xXXXXXXXX)
メンテナンスコードのモジュール番号を示します。
errno(xx)
エラーコードを示します。「xx」は,Windows 環境の場合は,GetLastError 関数で返ってきた値,
UNIX/Linux 環境の場合は,errno に設定されている値を示します。
message(xx)
errno(xx)で取得したエラーコードに対応するシステムエラーメッセージを示します。Windows 環境 の場合は,FormatMessage 関数で返ってきた値,UNIX/Linux 環境の場合は,strerror 関数で取得 した値を示します。
(d) 実メッセージに出力される情報(ワーニングレベルのメッセージ)
メッセージのレベルが「War」(ワーニングレベル)のログについて,実メッセージに出力される情報を 説明します。
複数のアイテムが同一セルに配置された結果,出力されなかったアイテムの情報はアイテムごとに 1 行で 記述されます。
出力されないアイテムごとの,実メッセージに出力される情報を次に示します。
文字アイテム(固定文字列,マッピングデータ(文字列型,日付型),またはユーザ定義データ(文字列 型,日付型))
KEEU320-W△type=String,△sheet=SHEET,△rc=RC[Ret]
type
アイテム種別を示します。固定文字列,マッピングデータ(文字列型,日付型),およびユーザ定義 データ(文字列型,日付型)の場合は,「String」になります。
sheet
シート番号を示します。
rc
出力されなかったアイテムが本来配置されるはずだった,Excel のセルの行列番号を示します。
[Ret]
改行コード(Windows 環境の場合 CR+LF,UNIX/Linux 環境の場合 LF)を示します。
△
半角空白を示します。
文字アイテム(マッピングデータ(数値型),またはユーザ定義データ(数値型))
KEEU320-W△type=Numeric,△sheet=SHEET,△rc=RC[Ret]
type
アイテム種別を示します。マッピングデータ(数値型),およびユーザ定義データ(数値型)の場合 は,「Numeric」になります。
sheet
シート番号を示します。
rc
出力されなかったアイテムが,本来配置されるはずだった Excel のセルの行列番号を示します。
[Ret]
改行コード(Windows 環境の場合 CR+LF,UNIX/Linux 環境の場合 LF)を示します。
△
半角空白を示します。
線アイテム
KEEU320-W△type=Line,△sheet=SHEET,△rc=RC,△btrl=D,△Color="RRGGBB",△pattern="PAT"[Ret]
type
アイテム種別を示します。線アイテムの場合は,「Line」になります。
sheet
シート番号を示します。
rc
出力されなかったアイテムが,本来配置されるはずだった Excel のセルの行列番号を示します。
btrl
出力されなかったアイテムが rc で示したセルのどの位置の罫線として配置されるはずだったかを示 します。D には bottom(下罫線),top(上罫線),right(右罫線),left(左罫線)のどれかが表 示されます。
Color
線アイテムの色を 16 進数表記の RGB 値で示します。
pattern
線アイテムの線種を示します。PAT には Excel 形式ファイルに出力した場合の線種が表示されます。
[Ret]
改行コード(Windows 環境の場合 CR+LF,UNIX/Linux 環境の場合 LF)を示します。
△
半角空白を示します。
網掛けアイテム,角丸四角アイテム
KEEU320-W△type=Rectangle,△sheet=SHEET,△rc=RC,△bgColor="RRGGBB",△pattern="PAT"[Ret]
type
アイテム種別を示します。網掛けアイテム,角丸四角アイテムの場合は,「Rectangle」になります。
rc
出力されなかったアイテムが,本来配置されるはずだった Excel のセルの行列番号を示します。
bgColor
網掛けアイテム,角丸四角アイテムの背景色を 16 進数表記の RGB 値で示します。
pattern
網掛けアイテム,角丸四角アイテムの塗りつぶしパターンを示します。PAT には Excel 形式ファイ ルに出力した場合の塗りつぶしパターンが表示されます。
[Ret]
改行コード(Windows 環境の場合 CR+LF,UNIX/Linux 環境の場合 LF)を示します。
△
半角空白を示します。
(2) 出力例
EPS-XLSX ログの出力例を次に示します。
(a) メッセージレベルが INFO の場合
文字アイテム(固定文字列,マッピングデータ(文字列型,日付型),またはユーザ定義データ(文字列 型,日付型))が出力されないとき
Excel の 1 シート目でセル A1 に出力されるはずだった文字アイテム(固定文字列,マッピングデータ
(文字列型,日付型),またはユーザ定義データ(文字列型,日付型))が,ほかのアイテムと同一セル に配置された結果,出力されなかった場合の出力例を次に示します。
出力例
09/02/06 15:13:29 [ 3356] War KEEU320-W type=String, sheet=1, rc=A1
文字アイテム(マッピングデータ(数値型),またはユーザ定義データ(数値型))が出力されないとき Excel の 1 シート目でセル A1 に出力されるはずだった文字アイテム(マッピングデータ(数値型),
またはユーザ定義データ(数値型))が,ほかのアイテムと同一セルに配置された結果,出力されなかっ た場合の出力例を次に示します。
出力例
09/02/06 15:13:29 [ 3356] War KEEU320-W type=Numeric, sheet=1, rc=A1 線アイテムが出力されない場合
Excel の 1 シート目でセル A1 の左罫線に出力されるはずだった線アイテム(色:黒,線種:実線,線 幅:細線)が,ほかのアイテムと同一セルに配置された結果,出力されなかった場合の出力例を次に示 します。