付録D データ影響波及分析の環境変数
- 構文
-
CBLDIA_PERFORMANCELOG=ファイルのパス名
- 機能
-
データ影響波及分析のパフォーマンスログの出力先を指定します。この環境変数を指定すると,影響波及の解析が正常終了またはエラーで終了した時点で,指定したパス名のファイルに出力されます。
パフォーマンスログは,トラブル発生時に調査資料として必要になります。環境変数CBLDIA_PERFORMANCELOGは,システム環境変数またはユーザ環境変数に必ず指定して運用してください。
- 規則
-
書き込みオープンできないパス名を指定すると,環境変数CBLDIA_PERFORMANCELOGの指定は無視され,パフォーマンスログは出力されません。
パフォーマンスログは次の規則に従って出力されます。
-
ログ出力中に入出力エラーになった場合でも,エラーは通知されません。その後のログ出力処理はスキップされます。
-
初回解析時は上書きで,2回目以降の解析では追加で書き込まれます。
-
ファイル名(パス名と拡張子を除いたもの)の末尾が@の場合は,@が日付("_yyyymmdd_hhmmss")に置き換えられた名前のファイルに出力されます。その場合は,追加で書き込まれないで,解析の実行のたびに別ファイルに出力されます。
- 出力例
-
D:¥temp¥sample@.log
2015年4月10日2時00分38秒に実行すると,次に示すファイル名に置き換えられます。
D:¥temp¥sample_20150410_020038.log
この変換によってパス名がパス名長の上限を超えた場合は,環境変数CBLDIA_PERFORMANCELOGの指定は無視されます。
パフォーマンスログの出力例
/////////////////////////////////////////////////////////////////////////////// // // COBOL2002 Professional Tool Kit 03-05 Data Impact Analyzer // // PERFORMANCE LOG (CREATED AT 2015/04/10 16:30:07) // /////////////////////////////////////////////////////////////////////////////// [ LOADED SOURCE INFORMATION LIST ] SourceID InfoSize LoadTime FileName ----------------------------------------------------------------------------- [00301] 26,377 0s 032ms D:\Sample\sample_main.CBL [00302] 10,855 0s 015ms D:\Sample\sample_sub1.CBL [00303] 1,367 0s 015ms D:\Sample\sample_sub2.CBL ----------------------------------------------------------------------------- Total Number of Source Information Loaded from DB : 3 files Total Amount of Source Information Loaded from DB : 38,599 bytes [ EXECUTION PERFORMANCE INFORMATION ] Amount of Time for Loading of Source Information : 0m 00s 062ms Amount of Time for Traversing of Source Information : 0m 00s 000ms Amount of Time for Analyzing of Source Information : 0m 00s 107ms Amount of Time for Searching of DB : 0m 00s 026ms Amount of Time for GC : 0m 00s 012ms Amount of Time for Closing of DB : 0m 00s 007ms --------------------------------------------------------------------- Total Amount of Time for Data Impact Analysis : 0m 00s 214ms [ MEMORY PERFORMANCE INFORMATION ] Amount of Memory for Opening of DB : 179,320 bytes Amount of Memory for Loading of Source Information : 46,884 bytes Amount of Memory for Analyzing of Source Information: 95,132 bytes -------------------------------------------------------------------------- Total Amount of Memory for Data Impact Analysis : 321,336 bytes
ファイルの出力例の項目の意味を次に示します。
- [ LOADED SOURCE INFORMATION LIST ]
-
影響範囲解析のためにデータベースから読み込まれたソースファイル解析情報のリストです。データベース内でソースファイル解析情報を一意に示すためのソースID,データベース内のソースファイル解析情報のサイズ,読み込みに要した時間,およびソースファイルの絶対パス名が表示されます。
ソースファイル解析情報のサイズは,そのソースファイルをコンパイルした際のコンパイルリストの2〜3倍になります。ソースファイルから見積もる場合はこれを目安にできます。
その下には,ソースファイル解析情報の総数と総量(データベース内の形式でのサイズの総合計)が表示されます。
- [ EXECUTION PERFORMANCE INFORMATION ]
-
影響範囲解析の実行性能情報です。解析情報のロード時間の合計,走査時間の合計,解析時間の合計,データベースの検索時間の合計,GC(ガーベジコレクション)時間,およびデータベースのクローズ時間が表示されます。
- [ MEMORY PERFORMANCE INFORMATION ]
-
影響範囲解析のメモリ性能情報です。
データベースのオープンで要したメモリ量,メモリ上に展開されたソースファイル解析情報のメモリ量,およびソースファイル解析情報を解析するために使用したメモリ量が表示されます。
- 注意
-
-
メモリ上のソースファイル解析情報の形式は,100KB以上あるケースでは,データベース内のソースファイル解析情報の形式に比べて,サイズが1〜2割程度小さくなります。
-
表示されているメモリ量は,ガーベジコレクションのため,厳密な量ではありません。数十パーセントのオーダの誤差を含むことがあります。また解析処理のキャンセルやエラーの発生時は,正規の処理を通過していないために正しいメモリ量が計算されないで,負値のメモリ量が表示されることがあります。
-
- 構文
-
CBLDIA_REMAPFILE=フォルダ対応付けファイル絶対パス
- 機能
-
データ影響波及分析用データベースをサーバマシンからクライアントマシンに配布する場合に,フォルダ名を変換するための対応付けファイルを指定します。
- 規則
-
-
有効なファイル絶対パスが指定されなかった場合,または指定したファイル絶対パスが存在しない場合,エラーメッセージが出力され,処理が中断されます。
-
環境変数CBLDIA_REMAPFILEを使用する場合は,コントロールパネルのシステム環境変数またはユーザ環境変数に設定してください。
-