uCosminexus DocumentBroker Version 3　統計解析ツール

文法書

3000-3-F11-20

目　　次

前書き

変更内容

はじめに

1.　統計解析ツールの機能概要

1.1　統計解析ツールとは

1.2　EDMRptAclogコマンドの機能概要

1.3　EDMRptTraceコマンドの機能概要

2.　統計解析ツールの処理概要

2.1　EDMRptAclogコマンドの処理概要

2.2　EDMRptTraceコマンドの処理概要

3.　実行環境の設定

3.1　実行環境設定の流れ

3.2　環境変数の設定

3.3　統計解析ツールのディレクトリ構成

4.　コマンドの実行に必要なファイル

4.1　EDMRptAclogコマンドに必要なファイル

4.1.1　アクセスログファイル

4.1.2　プロパティ拡張情報ファイル

4.1.3　DocumentSpace構成定義ファイル

4.1.4　集計キー定義ファイル

4.1.5　抽出エントリ定義ファイル

4.1.6　動作環境定義ファイル

4.2　EDMRptTraceコマンドに必要なファイル

4.2.1　トレースファイル

4.2.2　抽出エントリ定義ファイル

5.　トラブルシュート機能

5.1　EDMRptAclogコマンドのトラブルシュート機能

5.1.1　メッセージ

5.1.2　OIID変換，操作対象識別子変換時のエラー処理

5.2　EDMRptTraceコマンドのトラブルシュート機能

5.2.1　メッセージ

6.　コマンドリファレンス

6.1　コマンドの記述形式

6.2　EDMRptAclogコマンドの詳細

6.2.1　EDMRptAclogコマンド（アクセスログの解析）

6.2.2　EDMRptAclogコマンドの機能の処理方式

6.2.3　EDMRptAclogコマンドの出力形式

6.2.4　EDMRptAclogコマンドの出力例

6.3　EDMRptTraceコマンドの詳細

6.3.1　EDMRptTraceコマンド（トレースの解析）

6.3.2　EDMRptTraceコマンドの機能の処理方式

6.3.3　EDMRptTraceコマンドの出力形式

6.3.4　EDMRptTraceコマンドの出力例

付録

付録A　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi Solutions, Ltd.

前書き

■ 対象製品

R-1M95D-13※　 uCosminexus DocumentBroker Server Version 3　 03-60（適用OS：AIX 5L V5.1，AIX 5L V5.2，AIX 5L V5.3）
R-1595D-13　 uCosminexus DocumentBroker Server Version 3　 03-70（適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，Windows Server 2012）

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。
※印の製品については，サポート時期をご確認ください。

■ 輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。
なお、不明な場合は、弊社担当営業にお問い合わせください。

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OLEは，米国Microsoft Corporationが開発したソフトウェア名称です。
TIFFは，米国Aldus Corp.が開発したフォーマットの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
活文，PDFstaffは，株式会社日立ソリューションズの登録商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。

■ 発行

2013年9月 3000-3-F11-20

■ 著作権

All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi Solutions, Ltd.

変更内容

変更内容（3000-3-F11-20）DocumentBroker Server Version 3　03-70（適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，Windows Server 2012）

追加・変更内容 | 変更個所
前提OSにWindows Server 2012をサポートしました。 | 3.2(2)

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，次に示すプログラムプロダクトで提供する統計解析ツールのユーザインターフェースであるコマンドおよびコマンドが出力する情報について説明したものです。

R-1M95D-13　uCosminexus DocumentBroker Server Version 3

R-1595D-13　uCosminexus DocumentBroker Server Version 3

対象読者

このマニュアルは，uCosminexus DocumentBrokerで構築した文書管理システムへのアクセス状況や，uCosminexus DocumentBrokerサーバおよびクライアントのプログラムの処理内容を把握することで，システムを管理・運用する方を対象にしています。なお，次の内容を理解されていることを前提としています。

uCosminexus DocumentBrokerに関する知識

UNIXまたはWindowsに関する知識

HiRDBに関する知識

SQL言語に関する知識

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　統計解析ツールの機能概要

統計解析ツールの機能概要と統計解析ツールが提供するEDMRptAclogコマンド，EDMRptTraceコマンドの機能概要について説明しています。

第2章　統計解析ツールの処理概要

EDMRptAclogコマンド，EDMRptTraceコマンドの処理概要について説明しています。

第3章　実行環境の設定

統計解析ツールの実行環境の設定について説明しています。

第4章　コマンドの実行に必要なファイル

EDMRptAclogコマンド，EDMRptTraceコマンドの実行に必要なファイルについて説明しています。

第5章　トラブルシュート機能

EDMRptAclogコマンド，EDMRptTraceコマンドを運用するためのトラブルシュート機能（コマンドの実行によって出力されるメッセージやエラー処理）について説明しています。

第6章　コマンドリファレンス

EDMRptAclogコマンド，EDMRptTraceコマンドの文法，機能の処理方式，実行結果の出力形式および出力例について説明しています。

付録A　用語解説

このマニュアルで使用している用語について説明しています。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。なお，本文に記載のマニュアル名称は，「uCosminexus DocumentBroker」を「DocumentBroker」と表記しています。

uCosminexus DocumentBrokerのマニュアル

DocumentBroker Version 3　システム導入・運用ガイド（3000-3-D01）

uCosminexus DocumentBroker Version 3　システム導入・運用ガイド（3020-3-U71）

uCosminexus DocumentBrokerを使用する環境を定義，管理および運用する場合に参照してください。

UNIXの場合は，資料番号が3000-3-D01のマニュアルを参照してください。

Windowsの場合は，資料番号が3020-3-U71のマニュアルを参照してください。

uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　解説（3000-3-F13）

uCosminexus DocumentBroker Development Kitが提供するクラスライブラリの機能と，クラスライブラリを使用するために必要なオブジェクトモデルについて知りたい場合に参照してください。

uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　リファレンス　基本機能編（3000-3-F14）

uCosminexus DocumentBroker Development Kitが提供するクラスライブラリのクラスの詳細とメソッドの文法について知りたい場合に参照してください。

uCosminexus DocumentBroker Version 3　オブジェクト操作ツール（3000-3-F15）

uCosminexus DocumentBroker Development KitまたはuCosminexus DocumentBroker Runtimeで提供するオブジェクト操作ツールの機能について知りたい場合に参照してください。

uCosminexus DocumentBroker Version 3　メッセージ（3000-3-F12）

uCosminexus DocumentBrokerが出力するメッセージについて知りたい場合に参照してください。

関連製品のマニュアル（HiRDB）

スケーラブルデータベースサーバ HiRDB Version 6　解説（UNIX(R)用）（3000-6-231）

スケーラブルデータベースサーバ HiRDB Version 6　解説（Windows(R)用）（3020-6-121）

スケーラブルデータベースサーバ HiRDB Version 7　解説（UNIX(R)用）（3000-6-271）

スケーラブルデータベースサーバ HiRDB Version 7　解説（Windows(R)用）（3020-6-271）

スケーラブルデータベースサーバ HiRDB Version 8　解説（UNIX(R)用）（3000-6-351）

スケーラブルデータベースサーバ HiRDB Version 8　解説（Windows(R)用）（3020-6-351）

スケーラブルデータベースサーバ HiRDB Version 6　システム導入・設計ガイド（UNIX(R)用）（3000-6-232）

スケーラブルデータベースサーバ HiRDB Version 6　システム導入・設計ガイド（Windows(R)用）（3020-6-122）

スケーラブルデータベースサーバ HiRDB Version 7　システム導入・設計ガイド（UNIX(R)用）（3000-6-272）

スケーラブルデータベースサーバ HiRDB Version 7　システム導入・設計ガイド（Windows(R)用）（3020-6-272）

スケーラブルデータベースサーバ HiRDB Version 8　システム導入・設計ガイド（UNIX(R)用）（3000-6-352）

スケーラブルデータベースサーバ HiRDB Version 8　システム導入・設計ガイド（Windows(R)用）（3020-6-352）

スケーラブルデータベースサーバ HiRDB Version 6　システム定義（UNIX(R)用）（3000-6-233）

スケーラブルデータベースサーバ HiRDB Version 6　システム定義（Windows(R)用）（3020-6-123）

スケーラブルデータベースサーバ HiRDB Version 7　システム定義（UNIX(R)用）（3000-6-273）

スケーラブルデータベースサーバ HiRDB Version 7　システム定義（Windows(R)用）（3020-6-273）

スケーラブルデータベースサーバ HiRDB Version 8　システム定義（UNIX(R)用）（3000-6-353）

スケーラブルデータベースサーバ HiRDB Version 8　システム定義（Windows(R)用）（3020-6-353）

スケーラブルデータベースサーバ HiRDB Version 6　システム運用ガイド（UNIX(R)用）（3000-6-234）

スケーラブルデータベースサーバ HiRDB Version 6　システム運用ガイド（Windows(R)用）（3020-6-124）

スケーラブルデータベースサーバ HiRDB Version 7　システム運用ガイド（UNIX(R)用）（3000-6-274）

スケーラブルデータベースサーバ HiRDB Version 7　システム運用ガイド（Windows(R)用）（3020-6-274）

スケーラブルデータベースサーバ HiRDB Version 8　システム運用ガイド（UNIX(R)用）（3000-6-354）

スケーラブルデータベースサーバ HiRDB Version 8　システム運用ガイド（Windows(R)用）（3020-6-354）

スケーラブルデータベースサーバ HiRDB Version 6　コマンドリファレンス（UNIX(R)用）（3000-6-235）

スケーラブルデータベースサーバ HiRDB Version 6　コマンドリファレンス（Windows(R)用）（3020-6-125）

スケーラブルデータベースサーバ HiRDB Version 7　コマンドリファレンス（UNIX(R)用）（3000-6-275）

スケーラブルデータベースサーバ HiRDB Version 7　コマンドリファレンス（Windows(R)用）（3020-6-275）

スケーラブルデータベースサーバ HiRDB Version 8　コマンドリファレンス（UNIX(R)用）（3000-6-355）

スケーラブルデータベースサーバ HiRDB Version 8　コマンドリファレンス（Windows(R)用）（3020-6-355）

スケーラブルデータベースサーバ HiRDB Version 6　UAP開発ガイド（UNIX(R)/Windows(R)用）（3000-6-236）

スケーラブルデータベースサーバ HiRDB Version 6　UAP開発ガイド（Windows(R)用）（3020-6-126）

スケーラブルデータベースサーバ HiRDB Version 7　UAP開発ガイド（UNIX(R)/Windows(R)用）（3000-6-276）

スケーラブルデータベースサーバ HiRDB Version 7　UAP開発ガイド（Windows(R)用）（3020-6-276）

スケーラブルデータベースサーバ HiRDB Version 8　UAP開発ガイド（3020-6-356）

スケーラブルデータベースサーバ HiRDB Version 6　SQLリファレンス（UNIX(R)/Windows(R)用）（3000-6-237）

スケーラブルデータベースサーバ HiRDB Version 6　SQLリファレンス（Windows(R)用）（3020-6-127）

スケーラブルデータベースサーバ HiRDB Version 7　SQLリファレンス（UNIX(R)/Windows(R)用）（3000-6-277）

スケーラブルデータベースサーバ HiRDB Version 7　SQLリファレンス（Windows(R)用）（3020-6-277）

スケーラブルデータベースサーバ HiRDB Version 8　SQLリファレンス（3020-6-357）

スケーラブルデータベースサーバ HiRDB Version 6　メッセージ（UNIX(R)/Windows(R)用）（3000-6-238）※

スケーラブルデータベースサーバ HiRDB Version 6　メッセージ（Windows(R)用）（3020-6-128）※

スケーラブルデータベースサーバ HiRDB Version 7　メッセージ（UNIX(R)/Windows(R)用）（3000-6-278）※

スケーラブルデータベースサーバ HiRDB Version 7　メッセージ（Windows(R)用）（3020-6-278）※

スケーラブルデータベースサーバ HiRDB Version 8　メッセージ（3020-6-358）※

注※

このマニュアルでは，これらのマニュアルを「HiRDB　メッセージ」と表記しています。

読書手順

このマニュアルは，利用目的に合わせて章を選択してお読みいただけます。利用目的別の流れに従ってお読みいただくことをお勧めします。

このマニュアルでの表記

このマニュアルでは，製品名称を次に示す略称で表記しています。

製品名称 | 略称
AIX 5L V5.1 | AIX
AIX 5L V5.2
AIX 5L V5.3
uCosminexus DocumentBroker Development Kit Version 3 | DocumentBroker
uCosminexus DocumentBroker Runtime Version 3
uCosminexus DocumentBroker Server Version 3
uCosminexus DocumentBroker Development Kit Version 3 | DocumentBroker Development Kit
uCosminexus DocumentBroker Runtime Version 3 | DocumentBroker Runtime
uCosminexus DocumentBroker Server Version 3 | DocumentBroker ServerまたはDocumentBrokerサーバ
uCosminexus DocumentBroker Development Kit Version 3 | DocumentBrokerクライアント
uCosminexus DocumentBroker Runtime Version 3
HiRDB/Single Server Version 6 | HiRDB
HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDB/Parallel Server Version 6
HiRDB/Parallel Server Version 7
HiRDB/Parallel Server Version 8
HiRDB/Run Time Version 6
HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
HiRDB/Single Server Version 6 | HiRDB/Single Server
HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDB/Parallel Server Version 6 | HiRDB/Parallel Server
HiRDB/Parallel Server Version 7
HiRDB/Parallel Server Version 8
HiRDB/Run Time Version 6 | HiRDB/Run Time
HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
HiRDB/Single Server Version 6 | HiRDBサーバ
HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDB /Parallel Server Version 6
HiRDB /Parallel Server Version 7
HiRDB /Parallel Server Version 8
Microsoft(R) Windows Server(R) 2003, Enterprise Edition 日本語版 | Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition 日本語版 | Windows Server 2003 R2
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition 日本語版 | Windows Server 2003 R2またはWindows Server 2003 R2 x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition 日本語版
Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit 日本語版 | Windows Server 2008 またはWindows Server 2008 x86
Microsoft(R) Windows Server(R) 2008 Standard 32-bit 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版 | Windows Server 2008 R2
Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版
Microsoft(R) Windows Server(R) 2012 Standard 日本語版 | Windows Server 2012
Microsoft(R) Windows Server(R) 2012 Datacenter 日本語版

このほか，このマニュアルでは，次に示す表記方法を使用しています。

AIXをUNIXと表記することがあります。

Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，およびWindows Server 2012を合わせてWindowsと表記することがあります。

説明に使用する用語として「XXXXログ」や「エントリ」（XXXXエントリも含む）を使用しています。原則として，ファイルに残された一つ一つの記録を指す場合は「XXXXログ」，ソフトウェアで扱う単位を指す場合は「エントリ」（XXXXエントリも含む）と表記します。

uCosminexus DocumentBrokerのマニュアルで使用する略語

uCosminexus DocumentBrokerのマニュアルで使用する英略語を次に示します。

英略語 | 英字での表記
ACE | Access Control Element
ACFlag | Access Control Flag
ACL | Access Control List
AIIM | Association for Information and Image Management International
API | Application Programming Interface
ASCII | American Standard Code for Information Interchange
BES | Back End Server
BLOB | Binary Large Object
BMP | Bit Map
BNF | Backus Normal Form
BOA | Basic Object Adapter
CD-ROM | Compact Disc Read Only Memory
CGI | Common Gateway Interface
CORBA | Common Object Request Broker Architecture
CPU | Central Processing Unit
CR | Carriage Return
CSV | Comma Separated Value
DAP | Directory Access Protocol
DAT | Digital Audio Tape
DB | Database
DBMS | Database Management System
DCD | Document Content Description
DDE | Dynamic Data Exchange
DIT | Directory Information Tree
DLL | Dynamic Linking Library
DMA | Document Management Alliance
DN | Distinguished Name
EOF | End of File
ESIS-B | Element Structure Information Set-Binary Format
EUC | Extended UNIX Code
FAM | File Access Module
GIF | Graphics Interchange Format
GUI | Graphical User Interface
GUID | Globally Unique Identifier
HTML | Hypertext Markup Language
HTTP | Hypertext Transfer Protocol
IANA | Internet Assigned Numbers Authority
ID | Identifier
IPF | Itanium(R) Processor Family
ISO | International Organization for Standardization
JIS | Japanese Industrial Standards
JPEG | Joint Photographic Expert Group
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
LF | Line Feed
MFC | Microsoft Foundation Class
MIME | Multipurpose Internet Mail Extensions
OCR | Optical Character Reader
OIID | Object Instance Identifier
OLE | Object Linking and Embedding
OMG | Object Management Group
ORB | Object Request Broker
ORDB | Object Relational Database
OS | Operating System
OTS | Object Transaction Service
PC | Personal Computer
PDF | Portable Document Format
RDB | Relational Database
RDN | Relative Distinguished Name
RFC | Request for Comment
RTF | Rich Text Format
SQL | Structured Query Language
TCP/IP | Transmission Control Protocol/Internet Protocol
TIFF | Tag Image File Format
UOC | User Own Coding
URL | Uniform Resource Locator
UTC | Universal Time Coordinated
W3C | World Wide Web Consortium
WWW | World Wide Web
XML | Extensible Markup Language

このマニュアルで使用する記号

このマニュアルで使用する記号を次に示します。

記号
意味

　｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A｜B
　AまたはBを指定することを示します。

　＿
括弧で囲まれた複数項目のうち1項目に対し使用され，括弧内のすべてを省略したときシステムが取る標準値を示します。
（例）　〔A｜B〕
　「何も指定しない」か「AまたはBを指定する」ことを示します。何も指定しない場合はAが仮定されます。

｛　｝
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝
　A，BまたはCのどれかを指定することを示します。

〔　〕
この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，記号｛ ｝と同じくどれか一つを選択します。
（例１）　〔A〕
　「何も指定しない」か「Aを指定する」ことを示します。
（例２）　〔B｜C〕
　「何も指定しない」か「BまたはCを指定する」ことを示します。

：：＝
この記号の左にあるものを右にあるもので定義することを示します。
（例）　A：：＝B
　「AとはBである」と定義することを示します。

　…
記述が省略されていることを示します。
（例）　ABC…
ABCの後ろに記述があり，その記述が省略されていることを示します。

<　>
この記号で囲まれている項目は，該当する要素を指定することを示します。
（例）　<プロパティ>
　プロパティを記述します。

(　)
この記号で囲まれている項目を省略しないで記述することを示します。
（例）　(<プロパティ>)
　項目<プロパティ>は省略しないで記述します。

　...
この記号の直前に示す記号を繰り返し，複数個指定できることを示します。
（例）　(<プロパティ>)...
　プロパティは一つ以上で複数個，繰り返して指定できます。

このマニュアルで使用する構文要素

このマニュアルで使用する構文要素の種類を次に示します。

種類 | 定義
英字 | A～Z　a～z
英小文字 | a～z
英大文字 | A～Z
数字 | 0～9
英数字 | A～Z　a～z　0～9
記号 | !　"　#　$　%　&　'　(　)　+　,　_　・　.　/　:　;　<　=　>　@　[　]　^　－　｛　｝　￣　タブ　空白

注　すべて半角文字を使用してください。

このマニュアルの図中で使用する記号

このマニュアルの図中で使用する記号を，次のように定義します。

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

個所（かしょ）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

DocumentBroker Version 2とuCosminexus DocumentBroker Version 3の製品体系の違い

uCosminexus DocumentBroker Version 3では次のように製品の統合を行いました。

DocumentBroker RepositoryをuCosminexus DocumentBroker Serverに統合しました。

DocumentBroker Web ComponentをuCosminexus DocumentBroker Development KitおよびuCosminexus DocumentBroker Runtimeに統合しました。

DocumentBroker Version 2とuCosminexus DocumentBroker Version 3の製品体系の違いを次に示します。

DocumentBroker Version 2とuCosminexus DocumentBroker Version 3のマニュアルの対応

バージョンアップおよび製品体系の変更に伴い，uCosminexus DocumentBroker Version 3では次に示すようにマニュアル名称を変更しました。

Version 2のマニュアル名称 | Version 3のマニュアル名称
DocumentBroker Version 2　システム導入・運用ガイド | uCosminexus DocumentBroker Version 3　システム導入・運用ガイド
DocumentBroker Version 2　クラスライブラリ　解説 | uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　解説
DocumentBroker Version 2　クラスライブラリ　リファレンス　基本機能編 | uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　リファレンス　基本機能編
DocumentBroker Version 2　クラスライブラリ　リファレンス　概念SGML文書管理機能編 | 廃版
DocumentBroker Version 2　オブジェクト操作ツール | uCosminexus DocumentBroker Version 3　オブジェクト操作ツール
DocumentBroker Version 2　統計解析ツール | uCosminexus DocumentBroker Version 3　統計解析ツール
DocumentBroker Version 2　メッセージ | uCosminexus DocumentBroker Version 3　メッセージ
DocumentBroker Web Component Version 2　解説 | uCosminexus DocumentBroker Version 3　クラスライブラリ　Java　解説
DocumentBroker Web Component Version 2　リファレンス | uCosminexus DocumentBroker Version 3　クラスライブラリ　Java　リファレンス
DocumentBroker Web Component Version 2　サンプルWebアプリケーション | uCosminexus DocumentBroker Version 3　クラスライブラリ　Java　サンプルWebアプリケーション
DocumentBroker Text Search Index Loader Version 2 | uCosminexus DocumentBroker Text Search Index Loader Version 3
DocumentBroker Rendering Option　システム導入・運用ガイド | uCosminexus DocumentBroker Rendering Option Version 3
DocumentBroker Object Loader Version 2 | uCosminexus DocumentBroker Object Loader Version 3

1.　統計解析ツールの機能概要

この章では，統計解析ツールの機能概要と統計解析ツールが提供するEDMRptAclogコマンド，EDMRptTraceコマンドの機能概要について説明します。

＜この章の構成＞

1.1　統計解析ツールとは

1.2　EDMRptAclogコマンドの機能概要

1.3　EDMRptTraceコマンドの機能概要

1.1　統計解析ツールとは

DocumentBrokerは，システムの管理・運用に有効な情報として，DocumentBrokerで構築した文書管理システムへのユーザのアクセスの履歴や，DocumentBrokerサーバおよびクライアントのプログラムの処理内容をファイルに出力しています。これらのファイルをそれぞれ，アクセスログファイルおよびトレースファイルといいます。

統計解析ツールは，DocumentBrokerが出力したアクセスログファイルおよびトレースファイルの内容を解析・分類・集計して，レポートを出力するプログラムです。DocumentBrokerの管理者は，統計解析ツールが出力するレポートを参照することによって，文書管理システムへのユーザのアクセス状況やDocumentBrokerサーバおよびクライアントのプログラムごとの処理内容を把握できます。

なお，トレースファイルは，サーバのプログラムの場合はサーバトレース，クライアントのプログラムの場合はクライアントトレースといいます。

アクセスログファイルについては，「4.1.1　アクセスログファイル」を参照してください。トレースファイルについては，「4.2.1　トレースファイル」を参照してください。

統計解析ツールは，解析対象の違いによってユーザインターフェースとして次の表に示すコマンドを提供しています。

表1-1　統計解析ツールが提供するコマンドの一覧

コマンド | 機能
EDMRptAclog | アクセスログファイルの内容の解析・分類・集計
EDMRptTrace | トレースファイルの内容の解析・分類・集計

各コマンドについて次に説明します。

1.2　EDMRptAclogコマンドの機能概要

この節では，EDMRptAclogコマンドの目的と機能について説明します。

＜この節の構成＞

(1)　EDMRptAclogコマンドの目的

(2)　EDMRptAclogコマンドの機能

(1)　EDMRptAclogコマンドの目的

EDMRptAclogコマンドは，DocumentBrokerで構築した文書管理システムへのユーザのアクセス状況を把握することで，システムの管理・運用に役立てていただくことを目的としています。このため，EDMRptAclogコマンドは，DocumentBrokerが出力したアクセスログファイルの内容を解析・分類・集計して，レポートを出力します。

(2)　EDMRptAclogコマンドの機能

EDMRptAclogコマンドは次に示す機能を提供しています。

集計機能

OIID変換機能

操作対象識別子変換機能

エントリ抽出機能

各機能の概要を次に示します。

(a)　集計機能

アクセスログファイルに残された記録を，アクセスログといいます。集計機能は，このアクセスログの内容を，ユーザ名およびオブジェクト名で分類・集計して，その結果を出力します。

集計機能の詳細については，「6.2.2(1)集計機能の処理方式（EDMRptAclogコマンドの集計方法）」を参照してください。また，集計機能の出力形式については，「6.2.3(1)　集計機能の出力形式」を参照してください。

なお，キーとなる項目で集計する場合，キーとなる項目を，集計キー定義ファイルにあらかじめ定義しておく必要があります。集計キー定義ファイルについては，「4.1.4　集計キー定義ファイル」を参照してください。

(b)　OIID変換機能，操作対象識別子変換機能

アクセスログには，アクセス対象となったオブジェクトの情報が，次に示すDocumentBroker内部で生成された識別子で出力されます。

OIID

バージョン識別子

リレーション識別子

リンク識別子

なお，このマニュアルでは，アクセスログに出力されるOIID以外の識別子を操作対象識別子と呼びます。

OIID変換機能は，アクセスログに出力されたOIIDを，そのOIIDが示すオブジェクトのプロパティの値（文書名など）に変換します。また，操作対象識別子変換機能は，アクセスログに出力された操作対象識別子を，その操作対象識別子が示すオブジェクトのプロパティの値（文書名など）に変換します。

OIIDや操作対象識別子はDocumentBroker内部で生成される識別子であるため，ユーザはOIIDや操作対象識別子を見ても，その識別子がどのオブジェクトを示しているかわかりません。OIID変換，操作対象識別子変換をすることで，アクセスログ中のアクセス対象となったオブジェクトがわかるようになります。

OIID変換，操作対象識別子変換の結果については，「表6-4　アクセスログ表の例」または「6.2.3(2)　OIID変換機能，操作対象識別子変換機能（-cオプション指定）の出力形式」を参照してください。

なお，一つのオブジェクトには，複数のプロパティが含まれているのが普通です。したがって，OIID変換，操作対象識別子変換をするためには，オブジェクトに含まれている複数のプロパティのうちOIID変換，操作対象識別子変換をするプロパティを，プロパティ拡張情報ファイルにあらかじめ定義しておく必要があります。プロパティ拡張情報ファイルついては，「4.1.2　プロパティ拡張情報ファイル」を参照してください。

また，OIID変換を実行するかどうか，どの操作対象識別子に対して操作対象識別子変換を実行するかどうかを，動作環境定義ファイルで定義します。動作環境定義ファイルについては，「4.1.6　動作環境定義ファイル」を参照してください。

(c)　エントリ抽出機能

エントリとは，ソフトウェアで扱う一つの単位となる情報です。EDMRptAclogコマンドは，アクセスログファイルに記録されている一つ一つのアクセスログをエントリとして扱います。

アクセスログエントリには，アクセスの内容を表すメソッド名と引数が含まれています。エントリ抽出機能は，メソッド名と引数によってアクセスログエントリを抽出して，その結果を出力します。

エントリ抽出機能の出力形式については，「6.2.3(3)　エントリ抽出機能の出力形式」を参照してください。

なお，エントリを抽出する場合，抽出するエントリのメソッド名と引数を，抽出エントリ定義ファイルにあらかじめ定義しておく必要があります。抽出エントリ定義ファイルについては，「4.1.5　抽出エントリ定義ファイル」を参照してください。

1.3　EDMRptTraceコマンドの機能概要

この節では，EDMRptTraceコマンドの目的と機能について説明します。

＜この節の構成＞

(1)　EDMRptTraceコマンドの目的

(2)　EDMRptTraceコマンドの機能

(1)　EDMRptTraceコマンドの目的

EDMRptTraceコマンドは，DocumentBrokerサーバおよびクライアントのプログラムの処理内容を把握することで，システムの管理・運用に役立てていただくことを目的としています。このため，EDMRptTraceコマンドは，DocumentBrokerが出力したトレースファイルの内容を解析・分類・集計して，レポートを出力します。

(2)　EDMRptTraceコマンドの機能

EDMRptTraceコマンドは次に示す機能を提供しています。

集計機能

トレースファイル分割機能

エントリ抽出機能

各機能の概要を次に示します。

(a)　集計機能

トレースファイルに残された記録を，トレースログといいます。集計機能は，このトレースログの内容を，ユーザプログラムのプログラム名，プロセスIDおよびスレッドIDで分類・集計して，その結果を出力します。

集計機能の出力形式については，「6.3.3(1)　集計機能の出力形式」を参照してください。

(b)　トレースファイル分割機能

トレースファイル分割機能は，トレースファイルの内容を，ユーザプログラムのプログラム名，プロセスIDおよびスレッドIDごとに分類し，分類された内容を分割して別々のファイルに出力します。したがって，プログラムごと，プロセスごと，スレッドIDごとの処理内容を把握できます。

トレースファイル分割機能の出力形式については，「6.3.3(2)　トレースファイル分割機能の出力形式」を参照してください。

(c)　エントリ抽出機能

EDMRptTraceコマンドは，トレースファイルに記録されている一つ一つのトレースログをエントリとして扱います。

トレースログエントリには，プログラムの処理内容を表す処理の種別が含まれています。エントリ抽出機能は，処理の種別によってトレースログエントリを抽出して，その結果を出力します。

エントリ抽出機能の出力形式については，「6.3.3(3)　エントリ抽出機能の出力形式」を参照してください。

なお，エントリを抽出する場合，抽出するエントリの処理の種別を，抽出エントリ定義ファイルにあらかじめ定義しておく必要があります。抽出エントリ定義ファイルについては，「4.1.5　抽出エントリ定義ファイル」を参照してください。

2.　統計解析ツールの処理概要

この章では，EDMRptAclogコマンド，EDMRptTraceコマンドの処理概要について説明します。

＜この章の構成＞

2.1　EDMRptAclogコマンドの処理概要

2.2　EDMRptTraceコマンドの処理概要

2.1　EDMRptAclogコマンドの処理概要

この節では，EDMRptAclogコマンドの処理概要について説明します。

EDMRptAclogコマンドは，DocumentBrokerが出力したアクセスログファイルを入力として，レポートを出力します。OIID，操作対象識別子をプロパティの値に変換するためにデータベース（HiRDB）にアクセスしますが，DocumentBrokerにはアクセスしません。

EDMRptAclogコマンドによる処理の概要を次の図に示します。

図2-1　EDMRptAclogコマンドによる処理の概要

EDMRptAclogコマンドによる処理の詳細については，「6.2.2　EDMRptAclogコマンドの機能の処理方式」を参照してください。

2.2　EDMRptTraceコマンドの処理概要

この節では，EDMRptTraceコマンドの処理概要について説明します。

EDMRptTraceコマンドは，DocumentBrokerが出力したトレースファイルを入力として，レポートを出力します。EDMRptAclogコマンドと異なり，データベース（HiRDB）にはアクセスしません。

EDMRptTraceコマンドによる処理の概要を次の図に示します。

図2-2　EDMRptTraceコマンドによる処理の概要

EDMRptTraceコマンドによる処理の詳細については，「6.3.2　EDMRptTraceコマンドの機能の処理方式」を参照してください。

3.　実行環境の設定

この章では，統計解析ツールの実行環境の設定について説明します。

＜この章の構成＞

3.1　実行環境設定の流れ

3.2　環境変数の設定

3.3　統計解析ツールのディレクトリ構成

3.1　実行環境設定の流れ

この節では，統計解析ツールの実行環境設定の流れについて説明します。

実行環境設定の流れを次の図に示します。

図3-1　実行環境設定の流れ

説明：

環境変数を設定します。
統計解析ツールでは，次の環境変数の設定が必要です。

AIXの場合

LANG

TZ

DOCBROKERDIR

LIBPATH

EDMARUMSG

Windowsの場合

TZ

DOCBROKERDIR

PATH

EDMARUMSG

なお，EDMARUMSGは，必要に応じて設定してください。
環境変数の設定については，「3.2　環境変数の設定」を参照してください。

統計解析ツールの実行環境を作成します。（UNIXの場合）
統計解析ツールの実行環境は，DocumentBrokerの実行環境作成コマンド（EDMSetup）で作成します。DocumentBrokerの実行環境作成コマンドについては，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。
統計解析ツールのディレクトリ構成については，「3.3　統計解析ツールのディレクトリ構成」を参照してください。

コマンドの実行に必要なファイルを設定します。
EDMRptAclogコマンド，EDMRptTraceコマンドの実行に必要なファイルを設定します。ファイルの設定については，「4.　コマンドの実行に必要なファイル」を参照してください。

3.2　環境変数の設定

この節では，統計解析ツールを使用するために必要な環境変数の設定について説明します。

設定する環境変数は，ご使用のOSごとに異なります。

＜この節の構成＞

(1)　環境変数の設定（AIXの場合）

(2)　環境変数の設定（Windowsの場合）

(1)　環境変数の設定（AIXの場合）

環境変数は，各サーバマシンのログインシェル環境に合わせて次のファイルに設定します。なお，「$HOME」は，ログインユーザのホームディレクトリを示します。

Bourneシェル環境のとき

$HOME/.profile

Cシェル環境のとき

$HOME/.cshrcまたは$HOME/.login

(a)　LANG

使用する文字コードセットを設定します。この環境変数に設定する値によって，メッセージの言語種別が変わります。使用できる文字コードセットを次に示します。

日本語の場合

使用できる文字コードセットは，Shift-JISコードです。設定する値は「Ja_JP」です。

英語の場合

使用できる文字コードセットは，ASCIIコードです。設定する値は「C」です。

(b)　TZ

マシン時間のタイムゾーンを設定します。設定する値は「JST-9」です。

(c)　DOCBROKERDIR

DocumentBrokerの実行環境を作成するディレクトリを設定します。

(d)　LIBPATH

関連プログラムのライブラリのインストールディレクトリを設定します。次の値を追加してください。

:/opt/hitachi/common/lib

また，EDMRptAclogコマンドを実行するには，HiRDBのライブラリのインストールディレクトリも設定しておく必要があります。次の値を追加してください。

:HiRDB/Run Timeインストールディレクトリ/client/lib

(e)　EDMARUMSG（メッセージトレースを出力する場合）

EDMRptAclogコマンドおよびEDMRptTraceコマンドのメッセージトレースを出力するディレクトリを設定します。この環境変数を設定しない場合，メッセージトレースは出力されません。

(2)　環境変数の設定（Windowsの場合）

環境変数は，コントロールパネルの［システム］－［詳細設定］タブの［環境変数］ボタンをクリックして表示される［環境変数］ダイアログ（Windows Server 2003，Windows Server 2003 R2の場合），またはコントロールパネルの［システム］－［システムの詳細設定］－［詳細設定］タブの［環境変数］ボタンをクリックして表示される［環境変数］ダイアログ（Windows Server 2008，Windows Server 2008 R2，Windows Server 2012の場合）で設定します。

(a)　TZ

マシン時間のタイムゾーンを設定します。設定する値は「JST-9」です。

(b)　DOCBROKERDIR

DocumentBrokerの実行環境を作成するディレクトリとして，DocumentBroker Serverのディレクトリが設定されていることを確認してください。

(c)　PATH

EDMRptAclogコマンドを実行するには，HiRDBのライブラリのインストールディレクトリを設定しておく必要があります。次の値のうちどれか一つが設定されていることを確認してください。

:HiRDB/Parallel Serverインストールディレクトリ¥client¥utl

:HiRDB/Single Serverインストールディレクトリ¥client¥utl

:HiRDB/Run Timeインストールディレクトリ¥client¥utl

(d)　EDMARUMSG（メッセージトレースを出力する場合）

EDMRptAclogコマンドおよびEDMRptTraceコマンドのメッセージトレースを出力するディレクトリを設定します。この環境変数を設定しない場合，メッセージトレースは出力されません。

3.3　統計解析ツールのディレクトリ構成

この節では，統計解析ツールのディレクトリ構成について説明します。

統計解析ツールのディレクトリ構成（UNIXの場合）を次の図に示します。

図3-2　統計解析ツールのディレクトリ構成（UNIXの場合）

統計解析ツールのディレクトリ構成（Windowsの場合）を次の図に示します。

図3-3　統計解析ツールのディレクトリ構成（Windowsの場合）

4.　コマンドの実行に必要なファイル

この章では，EDMRptAclogコマンド，EDMRptTraceコマンドの実行に必要なファイルについて説明します。

＜この章の構成＞

4.1　EDMRptAclogコマンドに必要なファイル

4.2　EDMRptTraceコマンドに必要なファイル

4.1　EDMRptAclogコマンドに必要なファイル

この節では，EDMRptAclogコマンドの実行に必要なファイルについて説明します。EDMRptAclogコマンドの実行に必要なファイルを次に示します。

アクセスログファイル

プロパティ拡張情報ファイル

DocumentSpace構成定義ファイル

集計キー定義ファイル

抽出エントリ定義ファイル

動作環境定義ファイル

＜この節の構成＞

4.1.1　アクセスログファイル

4.1.2　プロパティ拡張情報ファイル

4.1.3　DocumentSpace構成定義ファイル

4.1.4　集計キー定義ファイル

4.1.5　抽出エントリ定義ファイル

4.1.6　動作環境定義ファイル

4.1.1　アクセスログファイル

アクセスログファイルは，DocumentBrokerで構築された文書管理システムへのユーザのアクセスの履歴を記録したファイルです。EDMRptAclogコマンドは，アクセスログファイルに記録された内容を入力として，オプションで指定された処理を実行します。なお，アクセスログ取得機能の詳細については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

アクセスログファイルは，EDMRptAclogコマンドの引数で指定できます。指定を省略する場合は，EDMRptAclogコマンドのアクセスログファイル格納ディレクトリにあるファイルがコマンドの対象になります。

EDMRptAclogコマンドは，DocumentBrokerがアクセスログファイルを生成するディレクトリにあるファイルを対象にして実行できません。このため，EDMRptAclogコマンドを実行する前に，DocumentBrokerが生成したアクセスログファイルを，EDMRptAclogコマンドのアクセスログファイル格納ディレクトリにコピーして，コマンド引数でのアクセスログファイルの指定を省略することをお勧めします。

＜この項の構成＞

(1)　ファイルのコピー

(2)　出力形式

(3)　アクセスログファイルの出力例

(1)　ファイルのコピー

アクセスログファイルのコピー手順は，ご使用のOSごとに異なります。

(a)　UNIXの場合

DocumentBrokerは「DocumentBroker実行環境ディレクトリ/spool/aclog」に「EDMAccess_"NO".log」という名称でアクセスログファイルを生成します。ファイル名の"NO"は1～16の通し番号です。

このアクセスログファイルを，EDMRptAclogコマンドのアクセスログファイル格納ディレクトリ「DocumentBroker実行環境ディレクトリ/aru/input/spool/aclog」にコピーしてください。

cpコマンドを使用したコピー手順の例を次に示します。なお，$DOCBROKERDIRは，DocumentBroker実行環境ディレクトリです。

cp $DOCBROKERDIR/spool/aclog/* /$DOCBROKERDIR/aru/input/spool/aclog

(b)　Windowsの場合

DocumentBrokerは「DocumentBrokerインストールディレクトリ¥Server¥spool¥aclog」に「EDMAccess_"NO".log」という名称でアクセスログファイルを生成します。ファイル名の"NO"は1～16の通し番号です。

このアクセスログファイルを，EDMRptAclogコマンドのアクセスログファイル格納ディレクトリ「DocumentBrokerインストールディレクトリ¥Server¥aru¥input¥spool¥aclog」にコピーしてください。

(2)　出力形式

アクセスログの出力形式およびアクセスログの項目について説明します。

(a)　アクセスログの出力形式

アクセスログの出力形式について説明します。

アクセスログファイル中のアクセスログは，アクセスの情報を示す複数の項目で構成されます。アクセスログの出力形式を次に示します。

yyyy/mm/dd hh:mm:ss.sss UserID LogInformation

アクセスログファイルは，ASCIIコードで構成されます。

エントリは改行で区切られます。

なお，EDMRptAclogコマンドは，yyyy/mm/dd hh:mm:ss.sssで始まらないエントリを無視します。

(b)　アクセスログの項目

アクセスログの各項目について説明します。

yyyy/mm/dd

アクセスした日付（年/月/日）が出力されます。

hh:mm:ss.sss

アクセスした時刻（時:分:秒.ミリ秒）が出力されます。

UserID

アクセスしたユーザのユーザIDが8～32バイトで出力されます。8バイトに満たないユーザIDは，満たない部分に空白が出力されます。

LogInformation

アクセスの内容を表す複数の文字列が，半角空白で区切られて出力されます。

このアクセスの内容にはメソッド名と引数が含まれています。EDMRptAclogコマンドの集計機能は，そのメソッド名と引数を基に，次に示す七つの項目（アクセス種別）に分類して集計します。

connect
文書空間への接続

create
オブジェクトの生成

delete
オブジェクトの削除

error
エラー

refer
オブジェクトの参照

search
検索の実行（検索結果の取得も含む）

update
オブジェクトの更新

集計機能で分類されるアクセスの内容と集計項目（アクセス種別）の関係を次の表に示します。

表4-1　集計機能で分類されるアクセスの内容と集計項目（アクセス種別）の関係

アクセスの内容 | 集計項目（アクセス種別）
メソッド名※ | 引数 | connect | create | delete | error | refer | search | update
BIND | ACLS |  |  |  |  |  |  | ○
CHANGE | ACL MODE |  |  |  |  |  |  | ○
MASTER RENDITION
SEARCH MODE
CHECKIN | VERSION |  |  |  |  |  |  | ○
CHECKOUT | VERSION |  |  |  |  |  |  | ○
CONNECT | なし | ○ |  |  |  |  |  |
OBJECT | － | － | － | － | － | － | －
CREATE | OBJECT |  | ○ |  |  |  |  |
INDEX |  |  |  |  |  |  | ○
RELATION
RENDITION
DELETE | OBJECT |  |  | ○ |  |  |  |
INDEX |  |  |  |  |  |  | ○
RELATION
RENDITION
RESULT
VERSION
DISCONNECT | なし | － | － | － | － | － | － | －
DOWNLOAD | CONTENT |  |  |  |  | ○ |  |
ERROR | なし |  |  |  | ○ |  |  |
EXECUTE | SEARCH |  |  |  |  |  | ○ |
SEARCH & GET RESULT |  |  |  |  |  | ○ |
なし | － | － | － | － | － | ○ | －
GET | RESULT | － | － | － | － | － | － | －
ACL MODE |  |  |  |  | ○ |  |
PROPERTIES
RESERVATION
LINK | なし |  |  |  |  |  |  | ○
LIST | ACLS |  |  |  |  | ○ |  |
CHILDREN
OBJECTS
PARENTS
RELATIONS
RENDITIONS
VERSIONABLES
VERSIONS
PREPARE | なし | － | － | － | － | － | － | －
RELEASE | OBJECT | － | － | － | － | － | － | －
REVOKE | VERSION |  |  |  |  |  |  | ○
SET | MODE FIX |  |  |  |  |  |  | ○
MODE FLOATING
PROPERTIES
UNBIND | ACLS |  |  |  |  |  |  | ○
UNLINK | なし |  |  |  |  |  |  | ○
UPLOAD | CONTENT |  |  |  |  |  |  | ○

（凡例）

空欄：分類されない集計項目であることを示す。

○　：分類される集計項目であることを示す。

－　：分類・集計の対象ではないアクセスの内容であることを示す。

注※

個々のアクセスログを区別する場合，アクセスの内容に含まれるメソッド名（引数を含めることもあります）を使用して「CONNECTエントリ」と表記することがあります。

(3)　アクセスログファイルの出力例

アクセスログファイルの出力例を次に示します。

2000/06/19 02:18:19.388 ACUser6  CONNECT 673d2be0-d1fd-11d0-ab59-08002be29e1d
2000/06/19 02:18:52.261 ACUser6  DISCONNECT
2000/06/19 02:19:16.420 ACUser6  CONNECT 673d2be0-d1fd-11d0-ab59-08002be29e1d
2000/06/19 02:21:50.877 ACUser6  CREATE OBJECT dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/f5d8e3a1-284c-11d2-9177-0000e21303670000000000001216​
2000/06/19 02:22:37.607 ACUser6  GET PROPERTIES dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/f5d8e3a1-284c-11d2-9177-0000e21303670000000000001216​
2000/06/19 02:22:54.537 ACUser6  RELEASE OBJECT dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/f5d8e3a1-284c-11d2-9177-0000e21303670000000000001216​
2000/06/19 02:36:13.963 ACUser6  DISCONNECT

4.1.2　プロパティ拡張情報ファイル

プロパティ拡張情報ファイルは，DocumentBrokerの文書モデルを構成するクラスに定義されている複数のプロパティの中から，OIID変換，操作対象識別子変換の対象となるプロパティを特定するために使用するファイルです。

プロパティ拡張情報ファイルに，OIID変換，操作対象識別子変換の対象となるプロパティを指定しておきます。EDMRptAclogコマンドは，データベース（HiRDB）からアクセス対象のオブジェクトのプロパティの値を取得して，アクセスログ中のOIID，操作対象識別子をプロパティの値（文書名など）に変換する際に，プロパティ拡張情報ファイルを参照します。プロパティ拡張情報ファイルがない場合，EDMRptAclogコマンドの実行時に標準エラー出力（stderr）にメッセージが出力されます。

プロパティ拡張情報ファイルは，ユーザが作成する必要があります。

＜この項の構成＞

(1)　記述規則

(2)　記述形式

(3)　プロパティ拡張情報ファイルの記述例

(1)　記述規則

プロパティ拡張情報ファイルの記述規則は次のとおりです。

次のディレクトリに次のファイル名で作成してください。
ディレクトリ

UNIXの場合
DocumentBroker実行環境ディレクトリ/etc

Windowsの場合
DocumentBrokerインストールディレクトリ¥Server¥etc

ファイル名

propex.ini

テキストファイルとして作成してください。

ASCIIコードで記述してください。ただし，コメント行ではShift-JISコードも使用できます。

シャープ（#）およびセミコロン（；）で始まる行はコメント行として扱われます。記述内容を説明する場合やプロパティ拡張情報ファイルを修正した場合のコメントなど，必要に応じて記述してください。

先頭や末尾の空白・タブは無視されます。

空白・改行だけの行は無視されます。

ファイルの先頭の行（コメント行を除く）には，セクションを記述してください。

(2)　記述形式

プロパティ拡張情報ファイルの記述形式を次に示します。

# property extension information File                         ‥‥コメント

[<クラス名>]                                                  ‥‥セクション
ClassId=<GUID文字列>                                          ‥‥エントリ
PrepresentProperties=<プロパティ名,プロパティ名,プロパティ名> ‥‥エントリ
：
[<クラス名>]                                                  ‥‥セクション
ClassId=<GUID文字列>                                         ‥‥エントリ
PrepresentProperties=<プロパティ名>                           ‥‥エントリ

プロパティ拡張情報ファイルは，複数のクラス名セクションと，各セクションに指定するClassIdエントリ，PrepresentPropertiesエントリで構成されます。

各セクションとエントリの記述について説明します。

(a)　セクション

OIID変換，操作対象識別子変換をするプロパティを定義しているDocumentBrokerのクラスまたはそのサブクラスのクラス名を，次に示す形式で記述してください。

　[<クラス名>]

クラス名セクションは，次に示す文法に従って記述してください。

クラス名は角括弧（[　]）で囲んでください。
なお，次の行は不正データとして扱われます。コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

角括弧（[）で始まり，角括弧（]）で終わらない行

角括弧（[）で始まらないで，角括弧（]）で終わる行

クラス名の英字の大文字，小文字は区別されるので，クラス名にはDocumentBrokerのクラスまたはそのサブクラスとして定義されているとおりの文字列を記述してください。

(b)　エントリ

クラス名セクションを構成するClassIdエントリ，PrepresentPropertiesエントリの記述について説明します。

ClassIdエントリ

OIID変換，操作対象識別子変換をするプロパティのクラス識別子を表すGUID文字列を，次に示す形式で記述してください。

　ClassId=<GUID文字列>

なお，GUID文字列は，「XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX（8けた-4けた-4けた-4けた-12けた）」という形式の文字列で，xは16進数の0～9，a～fです。クラス識別子を表すGUID文字列は，クラス定義情報ファイルに出力されるので，クラス定義情報ファイルを参照して指定することをお勧めします。クラス定義情報ファイルについては，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

PrepresentPropertiesエントリ

OIID変換，操作対象識別子変換をするプロパティのプロパティ名を，次に示す形式で記述してください。複数のプロパティ名を指定する場合，コンマ（,）で区切って指定します。プロパティ名は3個まで指定できます。4個以上指定した場合，EDMRptAclogコマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

　PrepresentProperties=<プロパティ名,プロパティ名,プロパティ名>

ここで指定したプロパティの値がOIID変換，操作対象識別子変換の結果として出力されます。したがって，OIID変換，操作対象識別子変換をするプロパティとしては，クラスを代表するプロパティを選択することをお勧めします。

プロパティ名の英字の大文字，小文字は区別されるので，プロパティ名にはDocumentBrokerのクラスまたはそのサブクラスのプロパティとして定義されているとおりの文字列を記述してください。

各エントリは，次に示す文法に従って記述してください。

エントリは「エントリ名=値」の形式で，1行で記述してください。

エントリ名の英字の大文字，小文字は区別されるので，エントリ名には「ClassId」または「PrepresentProperties」と記述してください。

ClassIdエントリは，クラス名セクションの次の行に記述してください。クラス名セクションの次の行にClassIdエントリがない場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

PrepresentPropertiesエントリは，ClassIdエントリの次の行に記述してください。ClassIdエントリの次の行にPrepresentPropertiesエントリがない場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

(3)　プロパティ拡張情報ファイルの記述例

プロパティ拡張情報ファイルの記述例を次に示します。

# property extension information

[usrClass_Folder]
ClassId=01a3a8c2-7aec-11d1-a31b-0020af9fbb1c
PrepresentProperties=usrProp_Name

[usrClass_Document]
ClassId=01a3a8c2-7aec-11d1-a31b-0020af9fbb1d
PrepresentProperties=usrProp_Title,usrProp_Author

この例では，DocumentBrokerで用意しているクラスのサブクラスとしてusrClass_FolderとusrClass_Documentというクラスが定義されていると仮定しています。また，usrClass_FolderクラスのプロパティとしてusrProp_Name，usrClass_DocumentクラスのプロパティとしてusrProp_TitleとusrProp_Authorが定義されていると仮定しています。

4.1.3　DocumentSpace構成定義ファイル

DocumentSpace構成定義ファイルは，文書空間の構成を定義するためのファイルで，EDMRptAclogコマンドのデータベース（HiRDB）への接続に使用します。

DocumentSpace構成定義ファイルに，データベースへの接続に必要な情報を指定しておきます。EDMRptAclogコマンドは，データベースに接続する際に，DocumentSpace構成定義ファイルを参照します。DocumentSpace構成定義ファイルにデータベースへの接続に必要な情報が指定されていない場合，コマンドの実行時にデータベースに接続できないため，標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

DocumentSpace構成定義ファイルは，次のディレクトリに次のファイル名で格納されています。

ディレクトリ

UNIXの場合
DocumentBroker実行環境ディレクトリ/etc

Windowsの場合
DocumentBrokerインストールディレクトリ¥Server¥etc

ファイル名

docspace.ini

DocumentSpace構成定義ファイルの［Entry0001］セクションを構成する次の三つのエントリに，データベースへの接続に必要な情報を指定してください。

PdHostエントリ
データベースを構築しているサーバ（HiRDBサーバ）のホスト名を指定します。

PdNamePortエントリ
データベースを構築しているサーバ（HiRDBサーバ）のポート番号を指定します。

PdUserエントリ
データベースに接続するユーザのユーザ名とパスワードを指定します。

ファイル内で同じセクションまたはエントリを重複して指定した場合，最初のセクションまたはエントリが有効になります。

各エントリに指定する内容の詳細については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

4.1.4　集計キー定義ファイル

集計キー定義ファイルは，EDMRptAclogコマンドの集計機能で，-kオプションを指定してキーとなる項目によって集計する場合に，キーとなる項目を指定しておくファイルです。EDMRptAclogコマンドの-kオプションで，集計キー定義ファイルのファイル名を指定します。

集計キー定義ファイルは，ユーザが作成する必要があります。

なお，集計キー定義ファイルの内容と抽出エントリ定義ファイルの内容を，一つのファイルにまとめて記述してもかまいません。一つのファイルにまとめて記述する場合の記述規則については，「4.1.5(4)　集計キー定義ファイルと抽出エントリ定義ファイルを一つのファイルに記述する場合の記述規則」を参照してください。

＜この項の構成＞

(1)　記述規則

(2)　記述形式

(3)　集計キー定義ファイルの記述例

(1)　記述規則

集計キー定義ファイルの記述規則は次のとおりです。

作成先のディレクトリおよびファイル名は任意です。

テキストファイルとして作成してください。

ASCIIコードで記述してください。ただし，コメント行ではShift-JISコードも使用できます。

シャープ（#）およびセミコロン（；）で始まる行はコメント行として扱われます。記述内容を説明する場合や集計キー定義ファイルを修正した場合のコメントなど，必要に応じて記述してください。

先頭や末尾の空白・タブは無視されます。

空白・改行だけの行は無視されます。

ファイルの先頭の行（コメント行を除く）には，セクションを記述してください。

(2)　記述形式

集計キー定義ファイルの記述形式を次に示します。

# Extract Key Definition File                      ‥‥コメント

[Key User]                                         ‥‥セクション
<ユーザ名>                                         ‥‥エントリ
<ユーザ名>                                         ‥‥エントリ

[Key Object]                                       ‥‥セクション
<オブジェクト名>                                   ‥‥エントリ
<オブジェクト名>                                   ‥‥エントリ

集計キー定義ファイルは，［Key User］セクション，［Key Object］セクションと，各セクションに指定するエントリで構成されます。

各セクションとエントリの記述について説明します。

(a)　セクション

［Key User］セクション，［Key Object］セクションの記述について説明します。

［Key User］セクション

集計対象のユーザ名を定義する［Key User］セクションを，次に示す形式で記述してください。

　[Key User]

［Key Object］セクション

集計対象のオブジェクト名を定義する［Key Object］セクションを，次に示す形式で記述してください。

　[Key Object]

各セクションは，次に示す文法に従って記述してください。

セクション名は角括弧（[　]）で囲んでください。
なお，次の行は不正データとして扱われます。コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

角括弧（[）で始まり，角括弧（]）で終わらない行

角括弧（[）で始まらないで，角括弧（]）で終わる行

［Key User］セクション，［Key Object］セクション以外のセクション名は指定しないでください。不正なセクション名を指定した場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

［Key User］セクション，［Key Object］セクションは省略できます。ただし，［Key User］セクション，［Key Object］セクションをどちらも省略した場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

ファイル内で同じセクションを重複して指定した場合，最初のセクションのエントリが有効になり，2回目以降のセクションのエントリは不正データとして扱われて無視されます。

(b)　エントリ

［Key User］セクションに定義するユーザ名，［Key Object］セクションに定義するオブジェクト名の記述について説明します。

ユーザ名

集計対象のユーザ名を，次に示す形式で記述してください。

　[Key User]
　<ユーザ名>
　<ユーザ名>

ユーザ名は，次に示す文法に従って記述してください。

ユーザ名の指定は省略できます。省略した場合，すべてのユーザが集計対象になります。

複数のユーザ名を指定する場合，改行で区切って指定します。指定できるバイト数は32バイトまでです。指定できる個数の上限はありません。

同じユーザ名を重複して指定した場合，最初のユーザ名が有効になり，2回目以降のユーザ名は不正データとして扱われて無視されます。

オブジェクト名

集計対象のオブジェクト名を，次に示す形式で記述してください。

　[Key Object]
　<オブジェクト名>
　<オブジェクト名>

オブジェクト名は，次に示す文法に従って記述してください。

オブジェクト名の指定は省略できます。省略した場合，すべてのオブジェクトが集計対象になります。

複数のオブジェクト名を指定する場合，改行で区切って指定します。指定できるバイト数および個数の上限はありません。

オブジェクト名をダブルクォーテーション（"）で囲んだ場合，ダブルクォーテーション（"）は無視されます。例えば，「"Plan"」と指定した場合，オブジェクト名は「Plan」になります。

同じオブジェクト名を重複して指定した場合，最初のオブジェクト名が有効になり，2回目以降のオブジェクト名は不正データとして扱われて無視されます。

プロパティ拡張情報ファイルのPrepresentPropertiesエントリに複数の値を指定している場合，オブジェクト名としてPrepresentPropertiesエントリの値の一部を指定できます。指定例を次に示します。

(3)　集計キー定義ファイルの記述例

集計キー定義ファイルの記述例を次に示します。

すべてのユーザを集計対象とする場合の例

[Key User]

この例では，集計結果に出力される項目は，user，access，timesです。

ユーザ「ACUser1」のすべてのオブジェクトを集計対象とする場合の例

[Key User]
ACUser1
[Key Object]

この例では，集計結果に出力される項目は，user，object，access，timesです。

ユーザ「ACUser1」と「ACUser2」のオブジェクト「Object1」と「Object2」を集計対象とする場合の例

[Key User]
ACUser1
ACUser2
[Key Object]
Object1
Object2

この例では，集計結果に出力される項目は，user，object，access，timesです。

4.1.5　抽出エントリ定義ファイル

抽出エントリ定義ファイルは，EDMRptAclogコマンド，EDMRptTraceコマンドのエントリ抽出機能で，-xオプションを指定してエントリを抽出する場合に，抽出するエントリのメソッド名，引数および処理の種別を指定しておくファイルです。EDMRptAclogコマンド，EDMRptTraceコマンドの-xオプションで，抽出エントリ定義ファイルのファイル名を指定します。

抽出エントリ定義ファイルは，ユーザが作成する必要があります。

なお，集計キー定義ファイルの内容と抽出エントリ定義ファイルの内容を，一つのファイルにまとめて記述してもかまいません。一つのファイルにまとめて記述する場合の記述規則については，「4.1.5(4)　集計キー定義ファイルと抽出エントリ定義ファイルを一つのファイルに記述する場合の記述規則」を参照してください。

＜この項の構成＞

(1)　記述規則

(2)　記述形式

(3)　抽出エントリ定義ファイルの記述例

(4)　集計キー定義ファイルと抽出エントリ定義ファイルを一つのファイルに記述する場合の記述規則

(1)　記述規則

抽出エントリ定義ファイルの記述規則は次のとおりです。

作成先のディレクトリおよびファイル名は任意です。

テキストファイルとして作成してください。

ASCIIコードで記述してください。ただし，コメント行ではShift-JISコードも使用できます。

シャープ（#）およびセミコロン（；）で始まる行はコメント行として扱われます。記述内容を説明する場合や抽出エントリ定義ファイルを修正した場合のコメントなど，必要に応じて記述してください。

先頭や末尾の空白・タブは無視されます。

空白・改行だけの行は無視されます。

ファイルの先頭の行（コメント行を除く）には，セクションを記述してください。

(2)　記述形式

抽出エントリ定義ファイルの記述形式を次に示します。

# Extract Entry Definition File                    ‥‥コメント

[Extract Aclog]                                    ‥‥セクション
<メソッド名 引数>                                  ‥‥エントリ
<メソッド名 引数>                                  ‥‥エントリ

[Extract Trace]                                    ‥‥セクション
<処理の種別>                                       ‥‥エントリ
<処理の種別>                                       ‥‥エントリ

抽出エントリ定義ファイルは，［Extract Aclog］セクション，［Extract Trace］セクションと，各セクションに指定するエントリで構成されます。

各セクションとエントリの記述について説明します。

(a)　セクション

［Extract Aclog］セクション，［Extract Trace］セクションの記述について説明します。

［Extract Aclog］セクション

［Extract Aclog］セクションには，EDMRptAclogコマンドのエントリ抽出機能で抽出するエントリのメソッド名と引数を指定します。［Extract Aclog］セクションは，次に示す形式で記述してください。

　[Extract Aclog]

［Extract Trace］セクション

［Extract Trace］セクションには，EDMRptTraceコマンドのエントリ抽出機能で抽出するエントリの処理の種別を指定します。［Extract Trace］セクションは，次に示す形式で記述してください。

　[Extract Trace]

各セクションは，次に示す文法に従って記述してください。

セクション名は角括弧（[　]）で囲んでください。
なお，次の行は不正データとして扱われます。コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

角括弧（[）で始まり，角括弧（]）で終わらない行

角括弧（[）で始まらないで，角括弧（]）で終わる行

［Extract Aclog］セクション，［Extract Trace］セクション以外のセクション名は指定しないでください。不正なセクション名を指定した場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

［Extract Aclog］セクション，［Extract Trace］セクションは省略できます。ただし，［Extract Aclog］セクション，［Extract Trace］セクションをどちらも省略した場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

ファイル内で同じセクションを重複して指定した場合，最初のセクションのエントリが有効になり，2回目以降のセクションのエントリは不正データとして扱われて無視されます。

セクション名だけを指定してエントリを指定しなかった場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

(b)　エントリ

［Extract Aclog］セクションに指定するメソッド名と引数，［Extract Trace］セクションに指定する処理の種別の記述について説明します。

メソッド名と引数

EDMRptAclogコマンドのエントリ抽出機能で抽出するエントリのメソッド名と引数を，次に示す形式で記述してください。

　[Extract Aclog]
　<メソッド名 引数>
　<メソッド名 引数>

指定できるメソッド名と引数については，「表4-1　集計機能で分類されるアクセスの内容と集計項目（アクセス種別）の関係」を参照してください。不正なメソッド名と引数を指定した場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

メソッド名と引数は，次に示す文法に従って記述してください。

メソッド名と引数の間は，半角空白で区切ります。

複数のメソッド名と引数を指定する場合，改行で区切って指定します。

同じメソッド名と引数を重複して指定した場合，最初のメソッド名と引数が有効になり，2回目以降のメソッド名と引数は不正データとして扱われて無視されます。

処理の種別

EDMRptTraceコマンドのエントリ抽出機能で抽出するエントリの処理の種別を，次に示す形式で記述してください。

　[Extract Trace]
　<処理の種別>
　<処理の種別>

指定できる処理の種別を次に示します。

enter

arg

call

return

error

warn

mark

msg

exit

処理の種別は，次に示す文法に従って記述してください。

複数の処理の種別を指定する場合，改行で区切って指定します。

同じ処理の種別を重複して指定した場合，最初の処理の種別が有効になり，2回目以降の処理の種別は不正データとして扱われて無視されます。

(3)　抽出エントリ定義ファイルの記述例

抽出エントリ定義ファイルの記述例を次に示します。

# Extract Entry Definition File

[Extract Aclog]
CREATE OBJECT
GET RESULT

[Extract Trace]
enter
msg

この例では，EDMRptAclogコマンドのエントリ抽出機能で，「CREATE OBJECT」と「GET RESULT」のエントリが抽出されます。また，EDMRptTraceコマンドのエントリ抽出機能で，「enter」と「msg」のエントリが抽出されます。

(4)　集計キー定義ファイルと抽出エントリ定義ファイルを一つのファイルに記述する場合の記述規則

集計キー定義ファイルと抽出エントリ定義ファイルを一つのファイルに記述する場合，集計キー定義ファイルおよび抽出エントリ定義ファイルの記述規則に加えて，次に示す記述規則に従ってください。

作成先のディレクトリおよびファイル名は任意です。

ファイルに指定できるセクション名は次のとおりです。

［Key User］

［Key Object］

［Extract Aclog］

［Extract Trace］

セクション名の指定順序に規則はありません。どのような順序でも指定できます。
すべてのセクションを省略した場合または不正なセクション名を指定した場合，コマンド実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。
ファイル内で同じセクションまたはエントリを重複して指定した場合，最初のセクションまたはエントリが有効になります。

コマンド実行時にどのオプションを指定したかによってチェック対象のセクションが異なります。

-ｋオプションを指定した場合

［Key User］セクションおよび［Key Object］セクションのエントリはチェック対象になります。［Extract Aclog］セクションおよび［Extract Trace］セクションのエントリはチェック対象になりません。

-xオプションを指定した場合

［Extract Aclog］セクションおよび［Extract Trace］セクションのエントリはチェック対象になります。［Key User］セクションおよび［Key Object］セクションのエントリはチェック対象になりません。

なお，-ｋオプションまたはxオプションで指定したファイルがない場合，コマンド実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

4.1.6　動作環境定義ファイル

動作環境定義ファイルは，統計解析ツールが動作する時に参照する情報を定義するファイルです。動作環境定義ファイルには，次に示す情報が定義されています。

ユーザIDの集計方法に関する情報
アクセスログファイルを解析するときに，アクセスログ中のユーザIDの大文字，小文字を区別して集計するかどうかを指定します。

OIID変換，操作対象識別子変換の実行に関する情報
EDMRptAclogコマンドの実行結果として，アクセス対象オブジェクトの情報を出力するときに，アクセスログに出力されたOIID，操作対象識別子を，プロパティの値（文書名など）に変換するかどうかを指定します。操作対象識別子を変換する場合は，対象となる操作対象識別子の種類を指定します。
なお，集計キーを指定してEDMRptAclogコマンドを実行した場合，このファイルで指定した変換対象を含むアクセスログエントリが集計対象になります。

動作環境定義ファイルは，インストール時に，次のディレクトリに次のファイル名で格納されます。なお，必要に応じてユーザが編集できます。

ディレクトリ

UNIXの場合
DocumentBrokerの実行環境ディレクトリ/etc

Windowsの場合
DocumentBrokerインストールディレクトリ¥Server¥etc

ファイル名

edmrpt.ini

＜この項の構成＞

(1)　記述規則

(2)　記述形式

(3)　記述例

(1)　記述規則

動作環境定義ファイルの記述規則は次のとおりです。

テキストファイルとして作成してください。

ASCIIコードで記述してください。ただし，コメント行ではShift-JISコードも使用できます。

シャープ（#）およびセミコロン（；）で始まる行はコメント行として扱われます。記述内容を説明する場合や抽出エントリ定義ファイルを修正した場合のコメントなど，必要に応じて記述してください。

先頭や末尾の空白・タブは無視されます。

空白・改行だけの行は無視されます。

ファイルの先頭の行（コメント行を除く）には，セクションを記述してください。

(2)　記述形式

動作環境定義ファイルの記述形式を次に示します。

[UserCountingMode]                        ‥‥セクション
<ユーザ名集計モード>                      ‥‥エントリ

[ObjectConvertingMode]                    ‥‥セクション
<オブジェクト変換モード>                  ‥‥エントリ
<オブジェクト変換モード>                  ‥‥エントリ

動作環境定義ファイルは，[UserCountingMode]セクション，[ObjectConvertingMode]セクションと，各セクションに指定するエントリで構成されます。

各セクションとエントリの記述について説明します。

(a)　セクション

[UserCountingMode]セクション，[ObjectConvertingMode]セクションの記述について説明します。

［UserCountingMode］セクション

[UserCountingMode]セクションには，ユーザIDの集計方法に関する情報を指定します。[UserCountingMode]セクションは，次に示す形式で記述してください。

　[UserCountingMode]

［ObjectConvertingMode］セクション

[ObjectConvertingMode]セクションは，OIID変換，操作対象識別子変換の実行に関する情報を指定します。[ObjectConvertingMode]セクションは，次に示す形式で記述してください。

　[ObjectConvertingMode]

各セクションは，次に示す文法に従って記述してください。

セクション名は角括弧（[　]）で囲んでください。
なお，次の行は不正データとして扱われます。コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

角括弧（[）で始まり，角括弧（]）で終わらない行

角括弧（[）で始まらないで，角括弧（]）で終わる行

[UserCountingMode]セクション，[ObjectConvertingMode]セクション以外のセクション名は指定しないでください。不正なセクション名を指定した場合，コマンドの実行時に標準エラー出力（stderr）にメッセージが出力されて，処理が中止されます。

ファイル内で同じセクションを重複して指定した場合，最初のセクションのエントリが有効になり，2回目以降のセクションのエントリは不正データとして扱われて無視されます。

(b)　エントリ

[UserCountingMode]セクションに指定するユーザ名集計モード，[ObjectConvertingMode]セクションに指定するオブジェクト変換モードの記述について説明します。

ユーザ名集計モード

アクセスログファイルを解析するときに，アクセスログに含まれるユーザIDの大文字，小文字を区別するかどうかを次に示す形式で記述してください。

　[UserCountingMode]
　〈ユーザ名集計モード〉

指定できるユーザ名集計モードと集計方法を次の表に示します。

表4-2　ユーザ名集計モードと集計方法

ユーザ名集計モード | 集計方法
0 | 大文字，小文字を区別する。
1 | 大文字，小文字を区別しない。

なお，デフォルトでは，「0」が指定されています。

オブジェクト変換モード

EDMRptAclogコマンドの実行結果として，アクセス対象オブジェクトの情報を出力するときに，OIID変換，操作対象識別子変換を実行するかどうかを次に示す形式で指定してください。なお，操作対象識別子変換を実行する場合は，対象となる操作対象識別子の種類を指定してください。

　[ObjectConvertingMode]
　〈オブジェクト変換モード〉
　〈オブジェクト変換モード〉

指定できるオブジェクト変換モードと変換方法を次の表に示します。

表4-3　オブジェクト変換モードと変換方法

オブジェクト変換モード | 変換方法
OIID | OIID変換を実行する。
VD | バージョン識別子に対して，操作対象識別子変換を実行する。
RL | リレーション識別子に対して，操作対象識別子変換を実行する。
LD | 直接型のリンク識別子に対して，操作対象識別子変換を実行する。
LR | 参照型のリンク識別子に対して，操作対象識別子変換を実行する。
LV | 構成管理型のリンク識別子に対して，操作対象識別子変換を実行する。

なお，デフォルトでは「OIID」が指定されています。

変換対象は，次に示す文法に従って記述してください。

複数の変換対象を指定する場合，改行で区切って指定します。

同じ変換対象を重複して指定した場合，最初の変換対象が有効になり，2回目以降の変換対象は無視されます。

(3)　記述例

動作環境定義ファイルの記述例を次に示します。

[UserCountingMode]
1

[ObjectConvertingMode]
OIID
VD

この例では，アクセスログに含まれるユーザIDの大文字，小文字を区別しないで集計が実行されます。また，EDMRptAclogコマンドの実行結果にオブジェクト名を出力するとき，OIID変換が実行され，バージョン識別子に対して操作対象識別子変換が実行されます。なお，集計キーを指定してEDMRptAclogコマンドを実行した場合，OIIDまたはバージョン識別子を含むアクセスログエントリが集計対象になります。

4.2　EDMRptTraceコマンドに必要なファイル

この節では，EDMRptTraceコマンドの実行に必要なファイルについて説明します。EDMRptTraceコマンドの実行に必要なファイルを次に示します。

トレースファイル

抽出エントリ定義ファイル

＜この節の構成＞

4.2.1　トレースファイル

4.2.2　抽出エントリ定義ファイル

4.2.1　トレースファイル

トレースファイルは，DocumentBrokerサーバおよびクライアントのプログラムの処理内容の履歴（トレース）を記録したファイルです。EDMRptTraceコマンドは，トレースファイルに記録された内容を入力として，オプションで指定された処理を実行します。なお，トレース出力機能の詳細については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

トレースファイルは，EDMRptTraceコマンドの引数で指定できます。指定を省略する場合は，EDMRptTraceコマンドのトレースファイル格納ディレクトリにあるファイルがコマンドの対象になります。

EDMRptTraceコマンドは，DocumentBrokerがトレースファイルを生成するディレクトリにあるファイルを対象にして実行できません。このため，EDMRptTraceコマンドを実行する前に，DocumentBrokerが生成したトレースファイルを，EDMRptTraceコマンドのトレースファイル格納ディレクトリにコピーして，コマンド引数でのトレースファイルの指定を省略することをお勧めします。

＜この項の構成＞

(1)　ファイルのコピー

(2)　出力形式

(3)　トレースファイルの出力例

(1)　ファイルのコピー

トレースファイルのコピー手順は，ご使用のOSごとに異なります。

(a)　UNIXの場合

サーバトレース

DocumentBrokerは「DocumentBroker実行環境ディレクトリ/spool/server」に「EDMRasTrace"PID"_"NO".log」という名称でサーバトレースを生成します。ファイル名の"PID"はプロセスID，"NO"は1～16の通し番号です。ただし，環境変数「_HIEDMS_TRACE_DIR」が設定されている場合は，「_HIEDMS_TRACE_DIR」に設定されたディレクトリに生成します。

このサーバトレースを，EDMRptTraceコマンドのサーバトレース格納ディレクトリ「DocumentBroker実行環境ディレクトリ/aru/input/spool/server」にコピーしてください。

cpコマンドを使用したコピー手順の例を次に示します。なお，$DOCBROKERDIRは，DocumentBroker実行環境ディレクトリです。

cp $DOCBROKERDIR/spool/server/* /$DOCBROKERDIR/aru/input/spool/server

クライアントトレース

DocumentBrokerは「DocumentBroker実行環境ディレクトリ/spool/client」に「EDMRasTraceCL"PID"_"NO".log」という名称でクライアントトレースを生成します。ファイル名の"PID"はプロセスID，"NO"は1～16の通し番号です。ただし，環境変数「_HIEDMS_TRACE_DIR」が設定されている場合は，「_HIEDMS_TRACE_DIR」に設定されたディレクトリに生成します。

このクライアントトレースを，EDMRptTraceコマンドのクライアントトレース格納ディレクトリ「DocumentBroker実行環境ディレクトリ/aru/input/spool/client」にコピーしてください。

cpコマンドを使用したコピー手順の例を次に示します。なお，$DOCBROKERDIRは，DocumentBroker実行環境ディレクトリです。

cp $DOCBROKERDIR/spool/client/* /$DOCBROKERDIR/aru/input/spool/client

(b)　Windowsの場合

サーバトレース

DocumentBrokerは「DocumentBrokerインストールディレクトリ¥Server¥spool¥server」に「EDMRasTrace"PID"_"NO".log」という名称でサーバトレースを生成します。ファイル名の"PID"はプロセスID，"NO"は1～16の通し番号です。ただし，環境変数「_HIEDMS_TRACE_DIR」が設定されている場合は，「_HIEDMS_TRACE_DIR」に設定されたディレクトリに生成します。

このサーバトレースを，EDMRptTraceコマンドのサーバトレース格納ディレクトリ「DocumentBrokerインストールディレクトリ¥Server¥aru¥input¥spool¥server」にコピーしてください。

クライアントトレース

DocumentBrokerは「DocumentBrokerインストールディレクトリ¥Server¥spool¥client」に「EDMRasTraceCL"PID"_"NO".log」という名称でクライアントトレースを生成します。ファイル名の"PID"はプロセスID，"NO"は1～16の通し番号です。ただし，環境変数「_HIEDMS_TRACE_DIR」が設定されている場合は，「_HIEDMS_TRACE_DIR」に設定されたディレクトリに生成します。

このクライアントトレースを，EDMRptTraceコマンドのクライアントトレース格納ディレクトリ「DocumentBrokerインストールディレクトリ¥Server¥aru¥input¥spool¥client」にコピーしてください。

(2)　出力形式

トレースログの出力形式およびトレースログの項目について説明します。

(a)　トレースログの出力形式

トレースログの出力形式について説明します。

トレースファイル中のトレースログは，サーバまたはクライアントのプログラムの処理内容を示す複数の項目で構成されます。トレースログの出力形式を次に示します。

nnnn yyyy/mm/dd hh:mm:ss.sss system_name pid tid message-id message

トレースファイルは，ASCIIコードとShift-JISコードで構成されます。ただし，enterエントリおよびmsgエントリはASCIIコードで構成されます。

エントリは改行で区切られます。

なお，EDMRptTraceコマンドは，nnnn yyyy/mm/dd hh:mm:ss.sssで始まらないエントリを無視します。

(b)　トレースログの項目

トレースログの各項目について説明します。

nnnn

行番号が出力されます。

yyyy/mm/dd

サーバまたはクライアントのプログラムが処理を実行した日付（年/月/日）が出力されます。

hh:mm:ss.sss

サーバまたはクライアントのプログラムが処理を実行した時刻（時:分:秒.ミリ秒）が出力されます。

system_name

システム名が出力されます。システム名は「DocumentBroker」固定です。

pid

プロセスIDが出力されます。なお，サーバトレースかクライアントトレースかによって，次に示す違いがあります。

サーバトレースの場合

サーバプロセスのプロセスID

クライアントトレースの場合

ユーザプログラムのプロセスID

tid

スレッドIDが出力されます。なお，サーバトレースかクライアントトレースかによって，次に示す違いがあります。

サーバトレースの場合

サーバプロセスのスレッドID

クライアントトレースの場合

ユーザプログラムのスレッドID

message-id

メッセージIDが出力されます。ほとんどの場合，11個の半角空白が出力されます。

message

サーバまたはクライアントのプログラムの処理内容として，実行された処理の種別と処理の内容が出力されます。処理の種別と処理の内容の間は半角空白で区切られます。EDMRptTraceコマンドは，処理の種別を基にトレースログを分類して集計します。

messageに出力される処理の種別と処理の内容を次の表に示します。

表4-4　messageに出力される処理の種別と処理の内容

処理の種別※
処理の内容

enter
実行された処理の内容が次に示す形式で出力されます。

"クラス名::メソッド名（または関数名）"  "ユーザプログラム情報"

ユーザプログラム情報は，次に示す形式でサーバトレースだけに出力される情報です。

"ユーザプログラムのホスト名"  "ユーザプログラムのプログラム名"  "ユーザプログラムのプロセスID"  "ユーザプログラムのセッションID"  "プログラム識別子"

msg
メッセージ（SQL文などの保守情報）が出力されます。

注※

処理の種別には，exitやargなど，表4-4で説明していない種別もありますが，EDMRptTraceコマンドの集計対象ではないので説明を省略しています。なお，個々のトレースログを区別する場合，処理の種別を使用して「enterエントリ」，「msgエントリ」と表記することがあります。

注意事項

プログラム識別子がないenterエントリもあります。

サーバトレースのenterエントリのうち，ユーザプログラム情報が出力されないenterエントリは，その前に同じスレッドIDのenterエントリがあるかないかによって，次に示すように処理されます。

同じスレッドIDのenterエントリが前にある場合

前にある同じスレッドIDのenterエントリのユーザプログラム情報（ユーザプログラムのプログラム名，ユーザプログラムのプロセスID）を持つものとして処理されます。

同じスレッドIDのenterエントリが前にない場合

集計されません。

なお，ユーザプログラム情報がないenterエントリもトレース表には出力されます。トレース表については，「6.3.2(1)　集計機能の処理方式（EDMRptTraceコマンドの集計方法）」を参照してください。

(3)　トレースファイルの出力例

トレースファイルの出力例を次に示します。

サーバトレースの出力例

**** Microsoft WindowsNT5.2(Build:3790) Service Pack 2            TEST-SERV        TZ=(local)-9:00                  2009/02/08 13:43:42.562
    yyyy/mm/dd hh:mm:ss.sss                      pid      tid      message-id            message(LANG=0x0411)
2063 2009/02/08 13:43:42.562     DocumentBroker   00005282​ 0000179​B                       enter CdbrDMA::GetPropertyValuesAndLock()  sis01  WETG2J0  12491  000052823906310000040​a0d(userdoc)  EDMS000021122​  ()
2064 2009/02/08 13:43:42.562     DocumentBroker   00005282​ 0000179​B                       msg SELECT P9FFOR71O0OFC9972P521A2HD56,P9FFOR71O00GC99727V7140CF56,P9FFOR71O0OFC9972VM01ESQF56,P9FFOR71O00GC9972E061CD0LM5 FROM T9FFOR71O0OFC9972O521IUPU96 WHERE PI29HEI0K08PBO872DLUUMRGB4='00000000​ABC42239'
2065 2009/02/08 13:43:42.562     DocumentBroker   00005282​ 0000179​B                       exit CdbrDMA::GetPropertyValuesAndLock()  sis01  WETG2J0  12491  000052823906310000040​a0d(userdoc)  EDMS000021122​  ()

下線で示したトレースログでは，ユーザプログラム情報は次のようになります。

ユーザプログラムのホスト名：sis01

ユーザプログラムのプログラム名：WETG2J0

ユーザプログラムのプロセスID：12491

ユーザプログラムのセッションID：000052823906310000040a0d(userdoc)

プログラム識別子：EDMS000021122

クライアントトレースの出力例

**** Microsoft WindowsNT5.2(Build:3790) Service Pack 2            TEST-CL          TZ=(local)-9:00                  2009/02/08 13:43:42.562
    yyyy/mm/dd hh:mm:ss.sss                      pid      tid      message-id            message(LANG=0x0411)
0000 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       enter CedmRasMsg::cs_setMsgFormatter()
0001 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       exit CedmRasMsg::cs_setMsgFormatter()
0002 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       enter CedmCmdClassDescriptionForMulti::Initialize()
0003 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       arg EDMCLASSDEFPATH "NULL"
0004 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       exit CedmCmdClassDescriptionForMulti::Initialize()
0005 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       enter dbrgetprop::main()
0006 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       arg argv[ 0 ] "dbrgetprop"
0007 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       arg argv[ 1 ] "D:¥test¥objtool¥file¥tmp¥ipoiid"
0008 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       arg argv[ 2 ] "D:¥test¥objtool¥file¥ipgetprop"
0009 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       enter CedmOotTools::initialize()
0010 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       arg DBRTOOLSDIR "D:¥test¥objtool"
0011 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       enter CedmCmdClassDescription::InitializeForCache()
0012 2009/02/08 13:43:42.562     DocumentBroker   00006AF8 00000001​                       arg pClassDescriptionPath "D:¥test¥objtool¥etc¥673d2be0-d1fd-11d0-ab59-08002be29e1d.

4.2.2　抽出エントリ定義ファイル

抽出エントリ定義ファイルは，EDMRptAclogコマンド，EDMRptTraceコマンドのエントリ抽出機能で，-xオプションを指定してエントリを抽出する場合に，抽出するエントリのメソッド名，引数および処理の種別を指定しておくファイルです。EDMRptAclogコマンド，EDMRptTraceコマンドの-xオプションで，抽出エントリ定義ファイルのファイル名を指定します。

抽出エントリ定義ファイルは，ユーザが作成する必要があります。

抽出エントリ定義ファイルの作成については，「4.1.5　抽出エントリ定義ファイル」を参照してください。

5.　トラブルシュート機能

この章では，EDMRptAclogコマンド，EDMRptTraceコマンドを運用するためのトラブルシュート機能（コマンドの実行によって出力されるメッセージやエラー処理）について説明します。

＜この章の構成＞

5.1　EDMRptAclogコマンドのトラブルシュート機能

5.2　EDMRptTraceコマンドのトラブルシュート機能

5.1　EDMRptAclogコマンドのトラブルシュート機能

この節では，EDMRptAclogコマンドのメッセージおよびOIID変換，操作対象識別子変換時のエラー処理について説明します。

＜この節の構成＞

5.1.1　メッセージ

5.1.2　OIID変換，操作対象識別子変換時のエラー処理

5.1.1　メッセージ

EDMRptAclogコマンドのメッセージの出力先およびメッセージの言語種別について説明します。

＜この項の構成＞

(1)　メッセージの出力先

(1)　メッセージの出力先

EDMRptAclogコマンドのメッセージの出力先を次に示します。

標準エラー出力（stderr）

syslogファイル（UNIXの場合）またはイベントログ（Windowsの場合）

メッセージトレース

出力されるメッセージについては，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。なお，データベース（HiRDB）への接続でエラーが発生した場合，出力されるメッセージの中にHiRDBからのリターンコードとHiRDBのメッセージ（SQLERRMC）が含まれていますので，必要に応じてマニュアル「HiRDB　メッセージ」を参照してください。

メッセージトレースについて

環境変数「EDMARUMSG」を設定している場合，「EDMARUMSG」で設定したディレクトリに「aclog_msg.log」という名称でEDMRptAclogコマンドのメッセージトレースが出力されます。

ファイル名の規則を次に示します。

すでに同名のファイルがある場合，そのファイル名に"_n"（nは通し番号。最大値は179）を付加した形式で出力されます。

"_n"を付加した形式のファイルがある場合，最終更新ファイルのnに1を足したファイルが出力または更新されます。なお，nが179のファイルが最終更新ファイルの場合，"_n"が付いてないファイルが更新されます。
例えば，nが5のファイルが最終更新ファイルの場合，nが6のファイルが更新されます。また，nが9のファイルしかない場合，nが10のファイルが出力されます。

ファイル名の例を次に示します。

例1：同名のファイルがない場合

「aclog_msg.log」というファイルが出力されます。

例2：同名のファイル「aclog_msg.log」がある場合

「aclog_msg_1.log」というファイルが出力されます。

例3：ファイル「aclog_msg_5.log」が最終更新ファイルの場合

「aclog_msg_6.log」というファイルが出力されます。

例4：ファイル「aclog_msg_9.log」しかない場合

「aclog_msg_10.log」というファイルが出力されます。

5.1.2　OIID変換，操作対象識別子変換時のエラー処理

OIID変換，操作対象識別子変換でエラーが発生した場合に考えられるエラーの要因と統計解析ツールの処理内容を次の表に示します。

表5-1　OIID変換，操作対象識別子変換時のエラーの要因と統計解析ツールの処理内容

要因 | 処理内容
プロパティ拡張情報ファイルがない | 標準出力（stdout）に処理結果としてOIIDの末尾16バイトを出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。
プロパティ拡張情報ファイルの形式が間違っている | 標準エラー出力（stderr）にメッセージを出力して，処理を中止します。
プロパティ拡張情報ファイルに変換対象のプロパティのクラス識別子が指定されていない | 標準出力（stdout）に処理結果としてOIIDの末尾16バイトを出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。
プロパティ拡張情報ファイルに指定されている変換対象のプロパティがデータベース（HiRDB）で見つからない | 標準出力（stdout）に処理結果として「(deleted)」を出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。
データベース（HiRDB）への接続，検索に失敗した | 標準出力（stdout）に処理結果としてOIIDの末尾16バイトを出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。
プロパティ拡張情報ファイルに指定されている変換対象のプロパティの値のデータ型がMVARCHAR，INTEGERまたはCHAR以外である | 標準エラー出力（stderr）にメッセージを出力して，処理を中止します。
DocumentSpace構成定義ファイルのPdUserエントリに指定されているユーザにデータベース（HiRDB）の表に対するアクセス権がない | 標準出力（stdout）に処理結果として「(deleted)」を出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。
OIIDの末尾16バイトがデータベース（HiRDB）で見つからない | 標準出力（stdout）に処理結果として「(deleted)」を出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。
プロパティ拡張情報ファイルに指定されている変換対象のプロパティを定義しているクラスがデータベース（HiRDB）で見つからない | 標準出力（stdout）に処理結果として「(deleted)」を出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。
操作対象識別子変換時，カラムの値が見つからない | 標準出力（stdout）に処理結果として「(deleted)」を出力して，標準エラー出力（stderr）にメッセージを出力します。処理は継続します。

5.2　EDMRptTraceコマンドのトラブルシュート機能

この節では，EDMRptTraceコマンドのメッセージについて説明します。

＜この節の構成＞

5.2.1　メッセージ

5.2.1　メッセージ

EDMRptTraceコマンドのメッセージの出力先およびメッセージの言語種別について説明します。

＜この項の構成＞

(1)　メッセージの出力先

(1)　メッセージの出力先

EDMRptTraceコマンドのメッセージの出力先を次に示します。

標準エラー出力（stderr）

syslogファイル（UNIXの場合）またはイベントログ（Windowsの場合）

メッセージトレース

出力されるメッセージについては，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。

メッセージトレースについて

環境変数「EDMARUMSG」を設定している場合，「EDMARUMSG」で設定したディレクトリに「trace_msg.log」という名称でEDMRptTraceコマンドのメッセージトレースが出力されます。ファイル名の規則を次に示します。

すでに同名のファイルがある場合，そのファイル名に"_n"（nは通し番号。最大値は179）を付加した形式で出力されます。

"_n"を付加した形式のファイルがある場合，最終更新ファイルのnに1を足したファイルが出力または更新されます。なお，nが179のファイルが最終更新ファイルの場合，"_n"が付いてないファイルが更新されます。
例えば，nが5のファイルが最終更新ファイルの場合，nが6のファイルが更新されます。また，nが9のファイルしかない場合，nが10のファイルが出力されます。

ファイル名の例を次に示します。

例1：同名のファイルがない場合

「trace_msg.log」というファイルが出力されます。

例2：同名のファイル「trace_msg.log」がある場合

「trace_msg_1.log」というファイルが出力されます。

例3：ファイル「trace_msg_5.log」が最終更新ファイルの場合

「trace_msg_6.log」というファイルが出力されます。

例4：ファイル「trace_msg_9.log」しかない場合

「trace_msg_10.log」というファイルが出力されます。

6.　コマンドリファレンス

この章では，EDMRptAclogコマンド，EDMRptTraceコマンドの文法，機能の処理方式，実行結果の出力形式および出力例について説明します。

＜この章の構成＞

6.1　コマンドの記述形式

6.2　EDMRptAclogコマンドの詳細

6.3　EDMRptTraceコマンドの詳細

6.1　コマンドの記述形式

この節では，統計解析ツールで使用するコマンドの入力形式，使用方法および注意事項について説明します。

＜この節の構成＞

(1)　入力形式

(2)　入出力

(1)　入力形式

コマンドの入力形式を次に示します。

コマンド名　オプション　コマンド引数

コマンドの要素について示します。

コマンド名

コマンド名は実行するコマンドのファイル名です。

オプション

オプションの入力形式の規則を次に示します。なお，説明文で使用する「$」は，UNIXの場合はシェルプロンプト，Windowsの場合はコマンドプロンプトを表します。「cmd」はコマンド名を表します。

オプションの入力形式

オプションはマイナス記号（-）で始まる文字列で，コマンド行には一つまたは複数のオプションを指定できます。オプションの形式は，次に示すように引数を取らないかまたは1個の引数を取ります。

　形式1：-オプションフラグ
　形式2：-オプションフラグ＜空白またはタブ＞フラグ引数

オプションフラグ
1文字または2文字の英字です。大文字と小文字は区別されます。

フラグ引数
オプションフラグに対する引数です。

オプションの指定規則

フラグ引数を指定しないオプションフラグを，一つのマイナス記号（-）のあとにまとめて指定できません。

　　誤った指定例：$ cmd -abc
　　正しい指定例：$ cmd -a -b -c

フラグ引数を必要とするオプションフラグのフラグ引数は省略できません。オプションフラグとフラグ引数の間には空白またはタブが必要です。

　　誤った指定例：$ cmd -afile
　　正しい指定例：$ cmd -a file

同じオプションフラグを2回以上指定できません。

　　誤った指定例：$ cmd -a 1 -a 2

マイナス記号（-）だけのオプションは入力できません。次に示す例では「-」はコマンド引数とみなされます。

　　誤った指定例：$ cmd -

コマンド引数

コマンド引数は，コマンド操作の直接の対象となるものを指定します。指定する内容は，コマンドによって異なります。詳細は各コマンドの説明を参照してください。

(2)　入出力

入力

入力は，すべてコマンドのオプション，引数の並びです。

出力

コマンド処理が正常に終了したときの出力は，標準出力（stdout）またはoオプションで指定したファイルに対して実行します。また，終了コードの一覧を次の表に示します。

表6-1　終了コード一覧

終了コード | 意味
0 | 正常終了
1 | 警告付き正常終了
2 | 引数エラー
それ以外 | そのほかのエラー

6.2　EDMRptAclogコマンドの詳細

この節では，EDMRptAclogコマンドの文法，機能の処理方式，実行結果の出力形式および出力例について説明します。

＜この節の構成＞

6.2.1　EDMRptAclogコマンド（アクセスログの解析）

6.2.2　EDMRptAclogコマンドの機能の処理方式

6.2.3　EDMRptAclogコマンドの出力形式

6.2.4　EDMRptAclogコマンドの出力例

6.2.1　EDMRptAclogコマンド（アクセスログの解析）

＜この項の構成＞

(1)　機能

(2)　形式

(3)　オプション

(4)　コマンド引数

(5)　注意事項

(1)　機能

EDMRptAclogコマンドは，指定されたアクセスログファイルを解析し，指定された項目でアクセス回数を分類・集計して結果を出力します。また，結果を出力する際，アクセスログ中のOIID，操作対象識別子をオブジェクトのプロパティの値に変換します。

(2)　形式

EDMRptAclog
      〔-k 集計キー定義ファイル名〕
      〔-s '開始時刻'〕
      〔-e '終了時刻'〕
      〔-d 集計間隔〕
      〔-c〕
      〔-t〕
      〔-v〕
      〔-vt〕
      〔-o 出力ファイル名〕
      〔-x 抽出エントリ定義ファイル名〕
      〔アクセスログファイル名 ...〕
      〔ディレクトリ名 ...〕

(3)　オプション

-k 集計キー定義ファイル名

キーとなる項目によってアクセス回数を集計する場合に，キーとなる項目を指定した集計キー定義ファイルのファイル名を指定します。集計キー定義ファイルについては，「4.1.4　集計キー定義ファイル」を参照してください。

このオプションは，次に示す事項に留意して指定してください。

ファイルパスは，フルパスまたは相対パスのどちらでも指定できます。フルパスで指定されていない場合は，カレントディレクトリ下を探します。

ハイフン（-）で始まるファイル名は指定できません。ただし，フルパスで指定された場合は処理できます。

ファイル名に空白が含まれている場合，次に示す記号でファイル名全体を囲めば指定できます。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

指定されたファイルがない場合や指定されたファイルがディレクトリの場合，エラーになります。

-s '開始時刻'

アクセス回数を集計する期間の開始時刻を指定します。指定した時刻以降のアクセスログエントリが集計対象になります。指定した時刻は，集計期間の対象になります。例えば，12:00:00.000と指定した場合，12:00:00.000からが集計期間になります。

開始時刻は次に示す形式で指定してください。

'yyyy/mm/dd hh:mm〔:ss.sss〕'

yyyy

日付の年の値を指定します。

mm

日付の月の値を指定します。指定できる値の範囲は，1月を1として01～12です。範囲外の値を指定するとエラーになります。

dd

日付の日にちの値を指定します。指定できる値の範囲は01～31です。範囲外の値を指定するとエラーになります。

hh

時間の時の単位の値を指定します。指定できる値の範囲は00～23です。範囲外の値を指定するとエラーになります。

mm

時間の分の単位の値を指定します。指定できる値の範囲は00～59です。範囲外の値を指定するとエラーになります。

ss

時間の秒の単位の値を指定します。指定できる値の範囲は00～59です。範囲外の値を指定するとエラーになります。

sss

時間のミリ秒の単位の値を指定します。指定できる値の範囲は000～999です。範囲外の値を指定するとエラーになります。

このオプションは，次に示す事項に留意して指定してください。

開始時刻は次に示す記号で囲んで指定します。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

指定を省略した場合，集計対象は最も古いアクセスログエントリからになります。

指定した時刻が-eオプションで指定した終了時刻以降の場合，エラーになります。

年/月/日および時:分は省略できません。秒.ミリ秒は省略できますが，秒だけやミリ秒だけは省略できません。秒.ミリ秒を省略した場合，デフォルト値として00.000が仮定されます。

-e '終了時刻'

アクセス回数を集計する期間の終了時刻を指定します。指定した時刻より前のアクセスログエントリが集計対象になります。指定した時刻は，集計期間の対象になりません。例えば，12:45:00.000と指定した場合，12:44:59.999までが集計期間になります。

終了時刻の指定形式は-sオプションの開始時刻と同じです。-sオプションの開始時刻の説明を参照してください。

このオプションは，次に示す事項に留意して指定してください。

終了時刻は次に示す記号で囲んで指定します。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

指定を省略した場合，集計対象は最も新しいアクセスログエントリまでになります。

指定した時刻が-sオプションで指定した開始時刻以前の場合，エラーになります。

指定した時刻を満たさないアクセスログエントリは，集計対象から外されます。
例えば，アクセスログファイル中の最初のアクセスログエントリの時刻が12:00:00.000で，最後のアクセスログエントリの時刻が13:00:00.000だとします。このとき，-eオプションに12:45:00.000を指定してEDMRptAclogコマンドを実行した場合，12:00:00.000から 12:44:59.999までのアクセスログエントリは集計・出力対象になります。しかし，12:45:00.000から13:00:00.000までのアクセスログエントリは集計・出力対象になりません。

-d 集計間隔

アクセス回数を集計する時間の幅を，分単位の整数で指定します。指定できる値の範囲は1～43200です。例えば，-d 15と指定すると，15分間ごとのアクセス回数が集計されます。

このオプションは，次に示す事項に留意して指定してください。

整数以外を指定した場合，および0以下の値を指定した場合はエラーになります。

集計・出力対象のアクセスログエントリは，-sオプション，-eオプションとの組み合わせによって変わります。
例えば，アクセスログファイル中の最初のアクセスログエントリの時刻が12:00:00.000で，最後のアクセスログエントリの時刻が13:00:00.000だとします。
このとき，-dオプションに45，-eオプションに12:45:00.000を指定してEDMRptAclogコマンドを実行した場合，12:00:00.000から12:44:59.999までのアクセスログエントリが集計・出力対象になります。しかし，12:45:00.000から13:00:00.000までのアクセスログエントリは集計・出力対象になりません。
また，このとき，-dオプションに45を指定し，-eオプションを省略してEDMRptAclogコマンドを実行した場合，12:00:00.000から12:44:59.999までのアクセスログエントリが最初のインターバルの集計・出力対象になり，12:45:00.000から13:00:00.000までのアクセスログエントリは次のインターバルの集計・出力対象になります。

-c

集計はしないで，アクセスした時間順にアクセスログを並べて出力する場合に指定します。このとき，動作環境定義ファイルで指定されているオブジェクト変換モードに応じて，アクセスログ中のOIID，操作対象識別子がオブジェクトのプロパティの値に置き換えられます。

-t

アクセス回数のSUBTOTAL（-kオプションで指定した集計キー定義ファイルの第1キーごとの小計）とTOTAL（総計）を出力する場合に指定します。

なお，このオプションの指定は，アクセス回数を集計する際のキー項目が二つある場合（集計キー定義ファイルの[Key User]セクションと[Key Object]セクションを指定した場合）に有効です。

例えば，集計キー定義ファイルで，[Key User]セクションと[Key Object]セクションを指定した場合，[Key User]セクションが第1キーになり，ユーザごとのSUBTOTALとTOTALが出力されます。

次の場合には，SUBTOTALとTOTALは出力されません。

-kオプションを省略する場合

キー項目が一つの場合（集計キー定義ファイルで，[Key User]セクション，[Key Object]セクションのどちらかを指定した場合）

-v

結果をCSV形式で出力する場合に指定します。

-vt

アクセスログ表を出力する場合に指定します。アクセスログ表については，「6.2.2(1)　集計機能の処理方式（EDMRptAclogコマンドの集計方法）」を参照してください。

アクセスログ表は，-vオプションを指定しなくても，CSV形式で出力されます。

-o 出力ファイル名

結果をファイルに出力する場合に，出力するファイル名を指定します。ファイルパスは，フルパス，相対パスまたはファイル名だけのどの方法でも指定できます。ファイル名だけを指定した場合，カレントディレクトリに出力されます。

指定を省略する場合，結果は標準出力（stdout）に出力されます。

-x 抽出エントリ定義ファイル名

エントリを抽出する場合に，抽出するエントリのメソッド名と引数を指定した抽出エントリ定義ファイルのファイル名を指定します。抽出エントリ定義ファイルについては，「4.1.5　抽出エントリ定義ファイル」を参照してください。

このオプションを-cオプションと同時に指定した場合，エントリが抽出されると同時に，アクセスログ中のOIIDは，オブジェクトのプロパティの値に変換されます。

このオプションは，次に示す事項に留意して指定してください。

ファイルパスは，フルパスまたは相対パスのどちらでも指定できます。フルパスで指定されていない場合は，カレントディレクトリ下を探します。

ハイフン（-）で始まるファイル名は指定できません。ただし，フルパスで指定された場合は処理できます。

ファイル名に空白が含まれている場合，次に示す記号でファイル名全体を囲めば指定できます。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

指定されたファイルがない場合や指定されたファイルがディレクトリの場合，エラーになります。

(4)　コマンド引数

アクセスログファイル名

解析対象のアクセスログファイルを指定します。

ディレクトリ名

解析対象のディレクトリを指定します。ただし，サブディレクトリ下のファイルは解析対象に含まれません。ディレクトリパスは，1023バイト以内で指定してください。指定したディレクトリの下にファイルがある場合は，そのファイル名も含めたパスが，1023バイト以内になるようにしてください。

コマンド引数は，次に示す事項に留意して指定してください。

ファイルパスおよびディレクトリパスは，フルパスまたは相対パスのどちらでも指定できます。フルパスで指定されていない場合は，カレントディレクトリ下を探します。

ハイフン（-）で始まるファイル名およびディレクトリ名は指定できません。ただし，フルパスで指定された場合は処理できます。

ファイル名またはディレクトリ名に空白が含まれている場合，次に示す記号でファイル名全体またはディレクトリ名全体を囲めば指定できます。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

ファイル名およびディレクトリ名の最後のパスの区切り（UNIXの場合「/」，Windowsの場合「¥」）がある場合，標準エラー出力（stderr）にメッセージが出力されます。

次の場合，標準エラー出力（stderr）にメッセージが出力されます。
・指定したファイルまたはディレクトリがない場合
・指定したディレクトリが一つで，そのディレクトリに処理対象のファイルがない場合
・指定したディレクトリが複数で，すべてのディレクトリに処理対象のファイルがない場合

アクセスログファイルを指定する場合，アクセスログファイルを160個まで指定できます。なお，複数のファイルを指定した場合，その中にアクセスできないファイルが一つでもあるときは，処理を中止してメッセージを出力します。また，同じファイルを重複して指定しても，そのファイルに対する処理は1回だけになります。

ディレクトリを指定する場合，複数のディレクトリを指定できます。なお，指定したディレクトリ下のファイル総数が160を超えた場合，および指定したディレクトリ下にアクセスできないファイルが一つでもある場合は，処理を中止してメッセージを出力します。また，同じディレクトリを重複して指定しても，そのディレクトリ下のファイルに対する処理は1回だけになります。

アクセスログファイルは，ASCIIコードで構成されています。

この指定を省略する場合，EDMRptAclogコマンドのアクセスログファイル格納ディレクトリ（UNIXの場合「DocumentBroker実行環境ディレクトリ/aru/input/spool/aclog」，Windowsの場合「DocumentBrokerインストールディレクトリ¥Server¥aru¥input¥spool¥aclog」）にある「EDMAccess_"NO".log」（"NO"は1～16の通し番号）という名称のファイルが対象になります。
このとき，処理できるファイルの数は160個ではなく，上記のファイル名に該当するファイルの数になります。

EDMRptAclogコマンドは，DocumentBrokerがアクセスログファイルを生成するディレクトリにあるファイルを対象にして実行できません。EDMRptAclogコマンドを実行する前に，DocumentBrokerが生成したアクセスログファイルを，EDMRptAclogコマンドのアクセスログファイル格納ディレクトリにコピーして，コマンド引数でのアクセスログファイルの指定を省略することをお勧めします。アクセスログファイルのコピーについては，「4.1.1　アクセスログファイル」を参照してください。

(5)　注意事項

EDMRptAclogコマンドに関するそのほかの注意事項を次に示します。

オプションの指定順序に規則はありません。どのような順序でも指定できます。

オプションには，指定できない組み合わせがあります。
オプションの指定の組み合わせを次の表に示します。

表6-2　オプションの指定の組み合わせ（EDMRptAclogコマンド）

指定するオプション | 組み合わせるオプション
-k | -s | -e | -d | -c | -t | -v | -vt | -o | -x
-k | × |  |  |  | × |  |  | × |  | ×
-s |  | × |  |  |  |  |  |  |  |
-e |  |  | × |  |  |  |  |  |  |
-d |  |  |  | × | × |  |  | × |  | ×
-c | × |  |  | × | × | × |  | × |  |
-t |  |  |  |  | × | × |  | × |  | ×
-v |  |  |  |  |  |  | × |  |  |
-vt | × |  |  | × | × | × |  | × |  | ×
-o |  |  |  |  |  |  |  |  | × |
-x | × |  |  | × |  | × |  | × |  | ×

（凡例）

空欄：指定できる組み合わせであることを示す。

×　：指定できない組み合わせであることを示す。

6.2.2　EDMRptAclogコマンドの機能の処理方式

EDMRptAclogコマンドの次に示す機能の処理方式について説明します。

集計機能

OIID変換機能

操作対象識別子変換機能

エントリ抽出機能

＜この項の構成＞

(1)　集計機能の処理方式（EDMRptAclogコマンドの集計方法）

(2)　OIID変換機能，操作対象識別子変換機能の処理方式

(3)　エントリ抽出機能の処理方式

(1)　集計機能の処理方式（EDMRptAclogコマンドの集計方法）

EDMRptAclogコマンドの集計機能では，まず，アクセスログファイル中のアクセスログを解析して，アクセスログエントリごとにアクセスログ表を作成します。その上で，動作環境定義ファイルの内容や，コマンドに指定するオプションに従って，アクセス種別（アクセスログの集計項目）で分類・集計して，結果を標準出力（stdout）またはファイルに出力します。

(a)　アクセスログ表作成時の処理方式

アクセスログ表には，動作環境定義ファイルに指定されているOIIDまたは操作対象識別子（OIID変換，操作対象識別子変換の変換対象）を含むアクセスログエントリだけでなく，アクセス種別で分類できるすべてのアクセスログエントリが出力されます。例えば，次のようなアクセスログエントリも出力されます。

動作環境定義ファイルに指定されていないOIIDまたは操作対象識別子を含むアクセスログエントリ

統計解析ツールの対象ではないOIIDまたは操作対象識別子を含むアクセスログエントリ

OIIDまたは操作対象識別子を含んでいないアクセスログエントリ

これらのアクセスログエントリには，メソッド名の後ろに付加情報が付いている場合があります。アクセスログ表には，アクセスログエントリに含まれる付加情報の個数分の行が出力されます。OIIDおよび操作対象識別子は付加情報の一種であり，例えば，OIIDが2個含まれているアクセスログエントリに対して，アクセスログ表は2行出力されます。

アクセスログ表の項目を次の表に示します。

表6-3　アクセスログ表の項目

項目名
説明

日付
アクセスした日付（年/月/日）。

時刻
アクセスした時刻（時:分:秒.ミリ秒）。

ユーザ名
アクセスしたユーザのユーザ名。

アクセス種別
connect，create，delete，error，refer，searchまたはupdateのどれか。アクセス種別については，「表4-1　集計機能で分類されるアクセスの内容と集計項目（アクセス種別）の関係」を参照してください。

OIIDの末尾16バイト
アクセス対象オブジェクトを示す16進数の数値。アクセス対象オブジェクトが登録された時に，文書空間内で割り当てられたオブジェクト番号です。

OIIDに対応するプロパティ
アクセス対象オブジェクトのプロパティの値/クラス名。
ただし，プロパティ拡張情報ファイルに変換対象のプロパティのクラス識別子が指定されていない場合は，アクセス対象オブジェクトを示す16進数の数値が出力されます。

なお，動作環境定義ファイルに指定されているOIIDまたは操作対象識別子を含むアクセスログエントリのアクセスログ表を作成する場合，そのOIIDまたは操作対象識別子は，OIID変換機能，操作対象識別子変換機能によって対応するプロパティの値に置き換えられます。それ以外の場合，アクセスログ表のOIIDの末尾16バイトおよびOIIDに対応するプロパティの値は空白になります。アクセスログ表の例を次の表に示します。

表6-4　アクセスログ表の例

日付 | 時刻 | ユーザ名 | アクセス種別 | OIIDの末尾16バイト | OIIDに対応するプロパティ
2000/06/19 | 02:18:19.388 | ACUser6 | connect | 0000000000001216​ | 設計書/usrClass
2000/06/19 | 02:18:52.261 | ACUser6 | create | 0000000000001216​ | 設計書/usrClass
2000/06/19 | 02:19:16.420 | ACUser6 | refer | 0000000000001216​ | 設計書/usrClass
2000/06/19 | 02:19:16.420 | ACUser6 | refer | 0000000000001221​ | 企画書/usrClass

アクセスログ表は，EDMRptAclogコマンド実行時に-vtオプションを指定することによって出力できます。

(b)　アクセスログエントリ集計時の処理方式

アクセスログエントリを集計するときの集計対象は次の二つです。

OIID変換または操作対象識別子変換の変換対象を含むアクセスログエントリ
OIID変換，操作対象識別子変換の変換対象は，動作環境定義ファイルの[ObjectConvertingMode]セクションに指定されています。なお，動作環境定義ファイルについては，「4.1.6　動作環境定義ファイル」を参照してください。

OIIDおよび操作対象識別子を含まないアクセスログエントリ
OIIDおよび操作対象識別子を含まないアクセスログエントリの例を次に示します。

2000/06/19 02:18:52.261 ACUser6  DISCONNECT

ただし，-kオプションに集計キー定義ファイルを指定したときの集計対象は，集計キー定義ファイルで指定された項目によって異なります。集計キー定義ファイルで指定された項目別の集計対象を次の表に示します。

表6-5　集計キー定義ファイルで指定された項目別の集計対象

集計キー定義ファイルで指定された項目 | 集計対象
OIIDおよび操作対象識別子を含まないアクセスログエントリ | OIID変換または操作対象識別子変換の変換対象を含むアクセスログエントリ
ユーザ | ○ | ○
オブジェクト | × | ○
ユーザおよびオブジェクト | × | ○

（凡例）

○：集計する。

×：集計しない。

なお，OIID変換，操作対象識別子変換の変換対象を含むアクセスログエントリで，一つのアクセスログエントリにOIIDまたは操作対象識別子が二つ出現したとき，それぞれのOIIDまたは操作対象識別子の変換後の値によって集計のしかたが異なります。

変換後の値が同じ場合
そのアクセスログエントリは，1件として集計します。

変換後の値が異なる場合
そのアクセスログエントリは，2件として集計します。

(2)　OIID変換機能，操作対象識別子変換機能の処理方式

EDMRptAclogコマンドのOIID変換機能，操作対象識別子変換機能では，プロパティ拡張情報ファイルを参照し，アクセスログ中のOIIDおよび操作対象識別子に置き換えるプロパティの値をデータベースから取得して変換します。

(a)　OIID変換機能の処理の流れ

OIID変換機能の処理の流れを次の図に示します。

図6-1　OIID変換機能の処理の流れ

図6-1の1～4について説明します。

アクセスログのOIIDから，クラス識別子およびOIID末尾16バイトを抽出する。
アクセスログのOIIDから，クラス識別子（例：f5d8ae3a1-284c-11d2-9177-0000e210367）およびOIID末尾16バイト（例：0000000000001216）を抽出します。

プロパティ拡張情報ファイルを検索して，手順1で抽出したクラス識別子が示すクラス名，およびOIID変換後の値となるプロパティのプロパティ名を取得する。
プロパティ拡張情報ファイル（propex.ini）で，手順1で抽出したクラス識別子と一致するClassIDエントリを検索して，そのクラス識別子が示すクラス名（例：usrClass_Document），およびOIID変換後の値となるプロパティのプロパティ名（例：usrProp_Title，usrProp_Author）を取得します。

データベースを検索して，OIID変換後の値となるプロパティの値を取得する。
手順2で取得したクラス名のテーブルで，手順1で抽出したOIID末尾16バイトとdmaProp_OIIDカラムの値が一致するレコードを検索して，OIID変換後の値となるプロパティのプロパティ名のカラム（例：usrProp_Title，usrProp_Author）に格納されている値（例：機能仕様書.藤井/usrClass_Document）を取得します。

アクセスログのOIIDを，プロパティの値に置き換える。
アクセスログのOIIDを，手順3で取得したプロパティの値（例：機能仕様書.藤井/usrClass_Document）に置き換えます。

(b)　操作対象識別子変換機能の処理の流れ

操作対象識別子変換機能の処理の流れを次の図に示します。なお，次の図では，バージョン識別子に対して操作対象識別子変換を実行する場合の処理の流れを示しています。

図6-2　操作対象識別子変換機能の処理の流れ（バージョン識別子の場合）

図6-2の1～6について説明します。

アクセスログから操作対象識別子の一部を抽出する。
アクセスログから操作対象識別子の一部（例：000000000000080F）を抽出します。

データベースを検索して，操作対象識別子の値をプロパティとして持つオブジェクトのOIIDを取得する。
dmaClass_VerDescriptionテーブル※で，手順1で抽出した操作対象識別子の一部とdmaProp_OIIDカラムの値が一致するレコードを検索して，操作対象識別子の値をプロパティとして持つオブジェクトのOIID（dmaProp_Versionカラム※の値）を取得します。

手順2で取得したOIIDから，クラス識別子およびOIID末尾16バイトを抽出する。
手順2で取得したOIIDから，クラス識別子（例：f5d8ae3a1-284c-11d2-9177-0000e210367）およびOIID末尾16バイト（例：0000000000000851）を抽出します。

プロパティ拡張情報ファイルを検索して，手順3で抽出したクラス識別子が示すクラス名，および操作対象識別子変換後の値となるプロパティのプロパティ名を取得する。
プロパティ拡張情報ファイル（propex.ini）で，手順3で抽出したクラス識別子と一致するClassIDエントリの値を検索して，そのクラス識別子が示すクラス名（例：usrClass_Document），および操作対象識別子変換後の値となるプロパティのプロパティ名（例：usrProp_Title，usrProp_Author）を取得します。

データベースを検索して，操作対象識別子変換後の値となるプロパティの値を取得する。
手順4で取得したクラス名のテーブルで，手順3で抽出したOIID末尾16バイトとdmaProp_OIIDカラムの値が一致するレコードを検索して，操作対象識別子変換後の値となるプロパティのプロパティ名のカラム（例：usrProp_Title，usrProp_Author）に格納されている値（例：設計仕様書.藤井/usrClass_Document）を取得します。

アクセスログの操作対象識別子を，プロパティの値に置き換える。
アクセスログの操作対象識別子を，手順5で取得したプロパティの値（例：設計仕様書.藤井/usrClass_Document）に置き換えます。

注※

データベースで検索するテーブル，および操作対象識別子の値をプロパティとして持つオブジェクトのOIIDが格納されているカラムは，操作対象識別子の種類によって異なります。操作対象識別子別のデータベースで検索するテーブル名およびカラム名を次の表に示します。

表6-6　操作対象識別子別のデータベースで検索するテーブル名およびカラム名

操作対象識別子名
（オブジェクト変換モード）
テーブル名
カラム名

バージョン識別子（VD）
dmaClass_VerDescription
dmaProp_Version

リレーション識別子（RL）
edmClass_Relationship
dmaProp_Head

リンク識別子（LD）
dmaClass_DCRelationship
dmaProp_Head

リンク識別子（LR）
dmaClass_RCRelationship
dmaProp_Head

リンク識別子（LV）
edmClass_VTCRelationship
dmaProp_Head

OIID変換，操作対象識別子変換でエラーが発生した場合に考えられるエラーの要因については，「5.1.2　OIID変換，操作対象識別子変換時のエラー処理」を参照してください。

(3)　エントリ抽出機能の処理方式

アクセスログエントリには，アクセスの内容を表すメソッド名と引数が含まれています。EDMRptAclogコマンドのエントリ抽出機能では，抽出エントリ定義ファイルに指定されたメソッド名と引数によって，アクセスログエントリを抽出して，結果を標準出力（stdout）またはファイルに出力します。

6.2.3　EDMRptAclogコマンドの出力形式

EDMRptAclogコマンド実行結果の出力形式について説明します。

＜この項の構成＞

(1)　集計機能の出力形式

(2)　OIID変換機能，操作対象識別子変換機能（-cオプション指定）の出力形式

(3)　エントリ抽出機能の出力形式

(1)　集計機能の出力形式

EDMRptAclogコマンドの集計機能の出力例を次の図に示します。

図6-3　EDMRptAclogコマンドの集計機能の出力例

図6-3の要素(a)～(e)について説明します。

(a)　共通情報

集計結果に関する共通情報が出力されます。COUNT STARTからINTERVALまでの共通情報の出力形式を次に示します。

# <共通情報名> = <値>

出力される共通情報の内容は，EDMRptAclogコマンドのオプションの指定によって変わります。共通情報の内容およびオプションの指定との関係を次に示します。

# EDMRptAclog <オプション><引数>

実行したコマンドラインが出力されます。

# COUNT START = yyyy/mm/dd hh:mm:ss.sss

開始エントリの時刻が出力されます。-sオプションで開始時刻を指定している場合，その指定値が出力されます。-sオプションで開始時刻を指定していない場合，ログ開始時刻（LOG START）が出力されます。

COUNT STARTに該当するエントリは，集計対象になります。

# COUNT END = yyyy/mm/dd hh:mm:ss.sss

終了エントリの時刻が出力されます。-eオプションで終了時刻を指定している場合，その指定値が出力されます。-eオプションで終了時刻を指定していない場合，ログ終了時刻（LOG END）に1ミリ秒を足した時刻が出力されます。

COUNT ENDに該当するエントリは，集計対象になりません。

# LOG START = yyyy/mm/dd hh:mm:ss.sss

ログ開始時刻（ログ内の最も古いアクセスログエントリの時刻）が出力されます。

# LOG END = yyyy/mm/dd hh:mm:ss.sss

ログ終了時刻（ログ内の最も新しいアクセスログエントリの時刻）が出力されます。

# INTERVAL = mm minutes

-dオプションの指定値（アクセス回数の集計間隔）が出力されます。-dオプションを指定していない場合は出力されません。

(b)　分類項目

分類項目が出力され，その下に各項目の内容が出力されます。集計のキーとなる項目は，-kオプションで指定した集計キー定義ファイルに指定された項目です。分類項目とその内容を次に示します。

user

ユーザ名が14バイトまで出力されます。14バイトを超える場合，15バイト以降は出力されません。CSV形式では15バイト以降も出力されます。

userはアクセスログに出現した順に出力されます。

object

アクセス対象オブジェクトのプロパティの値とクラス名が，次に示す形式で出力されます。プロパティが二つ以上ある場合，ピリオド（.）を区切り文字として並べて出力されます。

　プロパティの値/クラス名

プロパティの値とクラス名は48バイトまで出力されます。48バイトを超える場合，49バイト以降は出力されません。CSV形式では49バイト以降も出力されます。

objectはアクセスログに出現した順に出力されます。

なお，プロパティ拡張情報ファイルに変換対象のプロパティが指定されていても，データベース上に該当するレコードがない場合は，「(deleted)」が出力されます。また，プロパティ拡張情報ファイルに変換対象のプロパティが指定されていないため，データベースからプロパティの値を取得できない場合は，OIIDの末尾16バイトが出力されます。

(c)　集計結果

集計結果の項目が出力され，その下に各項目の内容が出力されます。集計結果の項目とその内容を次に示します。

access

アクセス種別が出力されます。アクセス種別とその意味を次の表に示します。

表6-7　アクセス種別とその意味

アクセス種別 | 意味
connect | 文書空間への接続
create | オブジェクトの生成
delete | オブジェクトの削除
error | エラー
refer | オブジェクトの参照
search | 検索の実行（検索結果の取得も含む）
update | オブジェクトの更新

なお，アクセス種別は，アクセスログに含まれるメソッド名に基づいた集計項目で，メソッド名そのものではありません。アクセス種別とメソッド名の関係については，「表4-1　集計機能で分類されるアクセスの内容と集計項目（アクセス種別）の関係」を参照してください。

times

アクセスの回数を示す数字が，アクセス種別ごとに7バイトまで出力されます。7バイトを超える場合，8バイト以降は出力されません。CSV形式では8バイト以降も出力されます。

(d)　SUBTOTAL

-tオプションを指定した場合，-kオプションで指定した集計キー定義ファイルの第1キーごとのアクセス回数の小計が，アクセス種別ごとに出力されます。

(e)　TOTAL

-tオプションを指定した場合，アクセス回数の総計がアクセス種別ごとに出力されます。

(2)　OIID変換機能，操作対象識別子変換機能（-cオプション指定）の出力形式

-cオプションを指定した場合，集計はされないで，アクセスした時間順にアクセスログが出力されます。このとき，動作環境定義ファイルに指定された変換モードに応じて，OIID，操作対象識別子がオブジェクトのプロパティの値に置き換えられます。

OIID変換機能，操作対象識別子変換機能の出力例を次の図に示します。太字で示す部分が置き換わります。なお，OIIDまたは操作対象識別子がプロパティの値（プロパティの値/クラス名）に置き換わる以外は，元のアクセスログファイルと同じ形式になります。

図6-4　EDMRptAclogコマンドのOIID変換機能，操作対象識別子変換機能の出力例

(3)　エントリ抽出機能の出力形式

-xオプションを指定した場合，抽出エントリ定義ファイルに指定したメソッド名と引数によって，アクセスログエントリが抽出されて出力されます。

エントリ抽出機能の出力例を次の図に示します。この例では，抽出エントリ定義ファイルにメソッド名「CREATE」と引数「OBJECT」を指定して，CREATE OBJECTエントリを抽出しています。

図6-5　EDMRptAclogコマンドのエントリ抽出機能の出力例

-xオプションと-cオプションを同時に指定した場合は，エントリが抽出されると同時に，アクセスログ中のOIIDは，オブジェクトのプロパティの値に変換されます。

6.2.4　EDMRptAclogコマンドの出力例

EDMRptAclogコマンド実行結果の出力例を次に示します。

なお，次に示す出力例では，集計されたアクセスログエントリには，動作環境定義ファイルで指定した，OIID変換または操作対象識別子変換の変換対象が含まれていることが前提になっています。また，EDMRptAclogコマンドで-kオプションを指定した場合，集計キー定義ファイルに指定した項目によって集計対象になるアクセスログエントリが異なっています。集計キー定義ファイルに指定した項目別の集計対象については，「6.2.2(1)　集計機能の処理方式（EDMRptAclogコマンドの集計方法）」を参照してください。

＜この項の構成＞

(1)　オプション指定なしの出力例

(2)　CSV形式での出力例（-v 指定）

(3)　ユーザごとのアクセス回数の出力例（-k 集計キー定義ファイル 指定）

(4)　ユーザごとのアクセス回数のCSV形式での出力例（-k 集計キー定義ファイル -v 指定）

(5)　オブジェクトごとのアクセス回数の出力例（-k 集計キー定義ファイル 指定）

(6)　ユーザ，オブジェクトごとのアクセス回数の出力例（-k 集計キー定義ファイル 指定）

(7)　ユーザ，オブジェクトごとのアクセス回数のCSV形式での出力例（-k 集計キー定義ファイル -v 指定）

(8)　OIID変換，操作対象識別子変換の出力例（-c 指定）

(9)　OIID変換，操作対象識別子変換のCSV形式での出力例（-c -v 指定）

(10)　SUBTOTAL，TOTALの出力例（-k 集計キー定義ファイル -t指定）

(11)　SUBTOTAL，TOTALのCSV形式での出力例（-k 集計キー定義ファイル -t -v指定）

(12)　エントリの抽出例（-x 抽出エントリ定義ファイル 指定）

(13)　アクセスログ表の出力例（-vt指定）

(14)　集計間隔を指定した出力例（-k 集計キー定義ファイル -s '開始時刻' -e '終了時刻' -d 集計間隔 指定）

(15)　集計間隔を指定したCSV形式での出力例（-k 集計キー定義ファイル s '開始時刻' -e '終了時刻' -d 集計間隔 -v 指定）

(1)　オプション指定なしの出力例

オプションを指定しないでコマンドを実行した例を次に示します。

# EDMRptAclog
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

access    times
--------  --------
connect          1
search           2
create           3
delete           4
refer            5
update           6
error            7
--------  --------

(2)　CSV形式での出力例（-v 指定）

-vオプションだけを指定して，CSV形式で出力した例を次に示します。

"#","EDMRptAclog -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"access","times"
"connect",1
"search",2
"create",3
"delete",4
"refer",5
"update",6
"error",7

(3)　ユーザごとのアクセス回数の出力例（-k 集計キー定義ファイル 指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。すべてのユーザが集計対象になります。

[Key User]

すべてのユーザごとのアクセス回数を出力した例を次に示します。

# EDMRptAclog -k count.def
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

user           access    times
-------------- -------- --------
user01         connect         1
              search          2
              create          3
              delete          4
              refer           5
              update          6
              error           7
-------------- -------- --------
user02         connect         8
              search          9
              create         10
              delete         11
              refer          12
              update         13
              error          14
-------------- -------- --------
user03         connect        15
              search         16
              create         17
              delete         18
              refer          19
              update         20
              error          21
-------------- -------- --------

(4)　ユーザごとのアクセス回数のCSV形式での出力例（-k 集計キー定義ファイル -v 指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。特定のユーザ（user01とuser03）が集計対象になります。

[Key User]
user01
user03

特定のユーザごとのアクセス回数をCSV形式で出力した例を次に示します。なお，CSV形式での出力では，-ｋオプションで指定したキー項目の内容（この例ではユーザ名）は，集計結果の行数分，繰り返し出力されます。

"#","EDMRptAclog -k count.def -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"user","access","times"
"user01","connect",1
"user01","search",2
"user01","create",3
"user01","delete",4
"user01","refer",5
"user01","update",6
"user01","error",7
"user03","connect",15
"user03","search",16
"user03","create",17
"user03","delete",18
"user03","refer",19
"user03","update",20
"user03","error",21

(5)　オブジェクトごとのアクセス回数の出力例（-k 集計キー定義ファイル 指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。すべてのオブジェクトが集計対象になります。

[Key Object]

すべてのオブジェクトごとのアクセス回数を出力した例を次に示します。

プロパティ拡張情報ファイルに変換対象のプロパティは指定されていても，データベース上に該当するレコードがない場合は，「(deleted)」が出力されます。

# EDMRptAclog -k count.def
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

object                                           access   times
------------------------------------------------ -------- -------
機能仕様書/usrClass_Document                     create         1
                                                refer          2
                                                update         3
------------------------------------------------ -------- -------
マニュアル.藤井/usrClass_Manual                  refer          3
                                                update         4
------------------------------------------------ ------- --------
(deleted)                                        refer          5
                                                update         6
------------------------------------------------ ------- --------

(6)　ユーザ，オブジェクトごとのアクセス回数の出力例（-k 集計キー定義ファイル 指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。すべてのユーザのすべてのオブジェクトが集計対象になります。

[Key User]
[Key Object]

すべてのユーザ，オブジェクトごとのアクセス回数を出力した例を次に示します。

プロパティ拡張情報ファイルに変換対象のプロパティが指定されていても，データベース上に該当するレコードがない場合は，「(deleted)」が出力されます。また，プロパティ拡張情報ファイルに変換対象のプロパティが指定されていないため，データベースからプロパティの値を取得できない場合は，OIIDの末尾16バイトが出力されます。

# EDMRptAclog -k count.def
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

user           object                                           access  times
-------------- ------------------------------------------------ ------- --------
user01         機能仕様書/usrClass_Document                     refer          1
                                                               update         2
              ------------------------------------------------ ------- --------
              マニュアル.藤井/usrClass_Manual                  refer          3
                                                               update         4
-------------- ------------------------------------------------ ------- --------
user02         (deleted)                                        refer          5
                                                               update         6
              ------------------------------------------------ ------- --------
              0000000000001216​                                 refer          7
                                                               update         8
-------------- ------------------------------------------------ ------- --------

(7)　ユーザ，オブジェクトごとのアクセス回数のCSV形式での出力例（-k 集計キー定義ファイル -v 指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。特定のユーザ（user01）の特定のオブジェクト（マニュアル）が集計対象になります。

[Key User]
user01
[Key Object]
マニュアル

特定のユーザ，オブジェクトごとのアクセス回数をCSV形式で出力した例を次に示します。なお，CSV形式での出力では，-ｋオプションで指定したキー項目の内容（この例ではユーザ名とプロパティの値/クラス名）は，集計結果の行数分，繰り返し出力されます。

"#","EDMRptAclog -k count.def -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"user","object","access","times"
"user01","マニュアル.藤井/usrClass_Manual","refer",3
"user01","マニュアル.藤井/usrClass_Manual","update",4

(8)　OIID変換，操作対象識別子変換の出力例（-c 指定）

アクセスログ中のOIID，操作対象識別子をプロパティの値に変換して出力した例を次に示します。

# EDMRptAclog -c
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

2000/06/19 15:00:00.000 ACUser6  CREATE OBJECT 機能仕様書/usrClass_Document
2000/06/19 15:10:00.000 ACUser6  GET PROPERTIES 機能仕様書/usrClass_Document (nil)
2000/06/19 15:20:00.000 ACUser6  RELEASE OBJECT 設計仕様書/usrClass_Document
2000/06/19 18:00:00.000 ACUser6  DISCONNECT

(9)　OIID変換，操作対象識別子変換のCSV形式での出力例（-c -v 指定）

アクセスログ中のOIID，操作対象識別子をプロパティの値に変換してCSV形式で出力した例を次に示します。

"#","EDMRptAclog -c -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"2000/06/19","15:00:00.000","ACUser6","CREATE OBJECT","機能仕様書/usrClass_Document"
"2000/06/19","15:10:00.000","ACUser6","GET PROPERTIES","機能仕様書/usrClass_Document (nil)"
"2000/06/19","15:20:00.000","ACUser6","RELEASE OBJECT","設計仕様書/usrClass_Document"
"2000/06/19","18:00:00.000","ACUser6","DISCONNECT"

(10)　SUBTOTAL，TOTALの出力例（-k 集計キー定義ファイル -t指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。

[Key User]
[Key Object]

SUBTOTALおよびTOTALを出力した例を次に示します。

プロパティ拡張情報ファイルに変換対象のプロパティが指定されていても，データベース上に該当するレコードがない場合は，「(deleted)」が出力されます。

# EDMRptAclog -k count.def -t
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

user           object                                           access  times  
-------------- ------------------------------------------------ ------- --------
user01         機能仕様書/usrClass_Document                     refer          1
                                                               update         3
              ------------------------------------------------ ------- --------
              マニュアル.藤井/usrClass_Manual                  refer          1
                                                               update         3
-------------- ------------------------------------------------ ------- --------
SUBTOTAL                                                        refer          2
                                                               update         6
-------------- ------------------------------------------------ ------- --------
user02         (deleted)                                        refer          1
                                                               update         2
-------------- ------------------------------------------------ ------- --------
SUBTOTAL                                                        refer          1
                                                               update         2
-------------- ------------------------------------------------ ------- --------
TOTAL                                                           refer          3
                                                               update         8
-------------- ------------------------------------------------ ------- --------

(11)　SUBTOTAL，TOTALのCSV形式での出力例（-k 集計キー定義ファイル -t -v指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。

[Key User]
[Key Object]

SUBTOTALおよびTOTALをCSV形式で出力した例を次に示します。なお，CSV形式での出力では，-ｋオプションで指定したキー項目の内容（この例ではユーザ名とプロパティの値/クラス名）と-ｔオプションのSUBTOTALおよびTOTALは，集計結果の行数分，繰り返し出力されます。

プロパティ拡張情報ファイルに変換対象のプロパティが指定されていても，データベース上に該当するレコードがない場合は，「(deleted)」が出力されます。

"#","EDMRptAclog -k count.def -t -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"user","object","access","times"
"user01","機能仕様書/usrClass_Document","refer",1
"user01","機能仕様書/usrClass_Document","update",3
"user01"," マニュアル.藤井/usrClass_Manual","refer",1
"user01"," マニュアル.藤井/usrClass_Manual","update",3
"SUBTOTAL","","refer",2
"SUBTOTAL","","update",6
"user02","(deleted)","refer",1
"user02","(deleted)","update",2
"SUBTOTAL","","refer",1
"SUBTOTAL","","update",2
"TOTAL","","refer",3
"TOTAL","","update",8

(12)　エントリの抽出例（-x 抽出エントリ定義ファイル 指定）

この例では，-xオプションで，次の抽出エントリ定義ファイルを指定したと仮定します。

[Extract Aclog]
CREATE OBJECT

また，この例では，コマンド引数で，次のアクセスログファイルを指定したと仮定します。

Input.log:
2000/06/19 02:05:00.000 ACUser6  CREATE OBJECT dma:///07a17526-11d0-b11f-00…
2000/06/19 02:25:00.000 ACUser6  GET PROPERTIES  dma:///07a626-11d0-b11f-00…
2000/06/19 02:40:00.000 ACUser6  RELEASE OBJECT  dma:///07-a626-11d0-b11f-00…
2000/06/19 02:50:00.000 ACUser6  DISCONNECT

アクセスログファイルからCREATE OBJECTエントリを抽出して出力した例を次に示します。

# EDMRptAclog -x extract.def Input.log
# COUNT START = 2000/06/19 02:05:00.000
# COUNT END   = 2000/06/19 02:50:00.001
# LOG START   = 2000/06/19 02:05:00.000
# LOG END     = 2000/06/19 02:50:00.000

2000/06/19 02:05:00.000 ACUser6  CREATE OBJECT dma:///07a17526-11d0-b11f-00…

(13)　アクセスログ表の出力例（-vt指定）

アクセスログ表を出力した例を次に示します。アクセスログ表は，-vオプションを指定しなくても，CSV形式で出力されます。

"#","EDMRptAclog -vt"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"date","time","user","access","end 16 bytes of OIID","property corresponding to OIID"
"2000/06/19","15:00:00.000","ACUser6","connect","0000000000001216​","Design document/usrClass_Folder"
"2000/06/19","15:10:00.000","ACUser6","create","0000000000001216​","Design document/usrClass_Folder"
"2000/06/19","15:20:00.000","ACUser6","refer","0000000000001216​","Design document/usrClass_Folder"
"2000/06/19","18:00:00.000","ACUser6","refer","0000000000001221​","Plan document.Tanaka/usrClass_Folder"

(14)　集計間隔を指定した出力例（-k 集計キー定義ファイル -s '開始時刻' -e '終了時刻' -d 集計間隔 指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。

[Key Object]
機能仕様書

特定のオブジェクト（機能仕様書），集計の開始時刻（2000/06/19 14:30:00.000）と終了時刻（2000/06/19 16:30:00.000）に加えて，集計間隔（20）を指定して出力した例を次に示します。

# EDMRptAclog -k count.def -s '2000/06/19 14:30:00.000' -e '2000/06/19 16:30:00.000' -d 20
# COUNT START = 2000/06/19 14:30:00.000
# COUNT END   = 2000/06/19 16:30:00.000
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 16:00:00.000
# INTERVAL    = 20 minutes

# COUNT START = 2000/06/19 14:30:00.000

# No entry found.

# COUNT START = 2000/06/19 14:50:00.000

object                                           access   times
------------------------------------------------ -------- -------
機能仕様書/usrClass_Document                     create         1
                                                refer          2
                                                update         3
------------------------------------------------ -------- -------

# COUNT START = 2000/06/19 15:10:00.000

object                                           access   times
------------------------------------------------ -------- -------
機能仕様書/usrClass_Document                     refer          4
                                                update         5
------------------------------------------------ -------- -------

# COUNT START = 2000/06/19 15:30:00.000

object                                           access   times
------------------------------------------------ -------- -------
機能仕様書/usrClass_Document                     refer          6
                                                update         7
------------------------------------------------ -------- -------

# COUNT START = 2000/06/19 15:50:00.000

object                                           access   times
------------------------------------------------ -------- -------
機能仕様書/usrClass_Document                     refer          8
                                                update         9
------------------------------------------------ -------- -------

# COUNT START = 2000/06/19 16:10:00.000

# No entry found.

この例では，集計対象となるのは，2000/06/19 14:30:00.000から2000/06/19 16:29:59.999までのアクセスログエントリです。2000/06/19 14:30:00.000から20分間隔で集計しています。

ログ終了時刻2000/06/19 16:00:00.000を超えて2000/06/19 16:10:00.000に集計したときには，該当するエントリがない，つまりオブジェクトに対するアクセスがなかったため「No entry found.」という結果が出力されています。

(15)　集計間隔を指定したCSV形式での出力例（-k 集計キー定義ファイル s '開始時刻' -e '終了時刻' -d 集計間隔 -v 指定）

この例では，-kオプションで，次の集計キー定義ファイルを指定したと仮定します。

[Key Object]
機能仕様書

特定のオブジェクト（機能仕様書），集計の開始時刻（2000/06/19 14:30:00.000）と終了時刻（2000/06/19 16:30:00.000）に加えて，集計間隔（20）を指定してCSV形式で出力した例を次に示します。なお，CSV形式での出力では，-ｋオプションで指定したキー項目の内容（この例ではプロパティの値/クラス名）は，集計結果の行数分，繰り返し出力されます。

"#","EDMRptAclog -k count.def -s '2000/06/19 14:30:00.000' -e '2000/06/19 16:30:00.000' -d 20 -v"
"#","COUNT START","2000/06/19","14:30:00.000"
"#","COUNT END","2000/06/19","16:30:00.000"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","16:00:00.000"
"#"INTERVAL",20,"minutes"
"#","COUNT START","2000/06/19","14:30:00.000"
"#","No entry found."
"#","COUNT START","2000/06/19","14:50:00.000"
"object","access","times"
"機能仕様書/usrClass_Document","create",1
"refer",2
"update",3
"#","COUNT START","2000/06/19","15:10:00.000"
"object","access","times"
"機能仕様書/usrClass_Document","refer",4
"update",5
"#","COUNT START","2000/06/19","15:30:00.000"
"object","access","times"
"機能仕様書/usrClass_Document","refer",6
"update",7
"#","COUNT START","2000/06/19","15:50:00.000"
"object","access","times"
"機能仕様書/usrClass_Document","refer",8
"update",9
"#","COUNT START","2000/06/19","16:10:00.000"
"#","No entry found."

6.3　EDMRptTraceコマンドの詳細

この節では，EDMRptTraceコマンドの文法，機能の処理方式，実行結果の出力形式および出力例について説明します。

＜この節の構成＞

6.3.1　EDMRptTraceコマンド（トレースの解析）

6.3.2　EDMRptTraceコマンドの機能の処理方式

6.3.3　EDMRptTraceコマンドの出力形式

6.3.4　EDMRptTraceコマンドの出力例

6.3.1　EDMRptTraceコマンド（トレースの解析）

＜この項の構成＞

(1)　機能

(2)　形式

(3)　オプション

(4)　コマンド引数

(5)　注意事項

(1)　機能

EDMRptTraceコマンドは，指定されたトレースファイルを解析し，DocumentBrokerのサーバおよびクライアントのプログラムの処理内容を集計して結果を出力したり，分割してファイルに出力したりします。サーバトレース解析の場合は，ユーザプログラムのプログラム名とユーザプログラムのプロセスIDごとに集計・分割します。クライアントトレース解析の場合は，ユーザプログラムのプロセスIDとユーザプログラムのスレッドIDごとに集計し，ユーザプログラムのスレッドIDごとに分割します。

(2)　形式

EDMRptTrace
      ｛-sv｜-cl｝
      〔-s '開始時刻'〕
      〔-e '終了時刻'〕
      〔-d 集計間隔〕
      〔-w〕
      〔-t〕
      〔-v〕
      〔-vt〕
      〔-o 出力ファイル名〕
      〔-x 抽出エントリ定義ファイル名〕
      〔トレースファイル名 ...〕
      〔ディレクトリ名 ...〕

(3)　オプション

｛-sv｜-cl｝

解析するトレースファイルの種別を指定します。指定できるのは次に示すどちらかです。なお，このオプションの指定は省略できません。

-sv

サーバトレースを解析する場合に指定します。

-cl

クライアントトレースを解析する場合に指定します。

-s '開始時刻'

ユーザプログラムの処理内容を集計する期間の開始時刻を指定します。指定した時刻以降のトレースログエントリが集計対象になります。指定した時刻は，集計期間の対象になります。例えば，12:00:00.000と指定した場合，12:00:00.000からが集計期間になります。

開始時刻は次に示す形式で指定してください。

'yyyy/mm/dd hh:mm〔:ss.sss〕'

yyyy

日付の年の値を指定します。

mm

日付の月の値を指定します。指定できる値の範囲は，1月を1として01～12です。範囲外の値を指定するとエラーになります。

dd

日付の日にちの値を指定します。指定できる値の範囲は01～31です。範囲外の値を指定するとエラーになります。

hh

時間の時の単位の値を指定します。指定できる値の範囲は00～23です。範囲外の値を指定するとエラーになります。

mm

時間の分の単位の値を指定します。指定できる値の範囲は00～59です。範囲外の値を指定するとエラーになります。

ss

時間の秒の単位の値を指定します。指定できる値の範囲は00～59です。範囲外の値を指定するとエラーになります。

sss

時間のミリ秒の単位の値を指定します。指定できる値の範囲は000～999です。範囲外の値を指定するとエラーになります。

このオプションは，次に示す事項に留意して指定してください。

開始時刻は次に示す記号で囲んで指定します。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

指定を省略した場合，集計対象は最も古いトレースログエントリからになります。

指定した時刻が-eオプションで指定した終了時刻以降の場合，エラーになります。

年/月/日および時:分は省略できません。秒.ミリ秒は省略できますが，秒だけやミリ秒だけは省略できません。秒.ミリ秒を省略した場合，デフォルト値として00.000が仮定されます。

-e '終了時刻'

ユーザプログラムの処理内容を集計する期間の終了時刻を指定します。指定した時刻より前のトレースログエントリが集計対象になります。指定した時刻は，集計期間の対象になりません。例えば，12:45:00.000と指定した場合，12:44:59.999までが集計期間になります。

終了時刻の指定形式は-sオプションの開始時刻と同じです。-sオプションの開始時刻の説明を参照してください。

このオプションは，次に示す事項に留意して指定してください。

終了時刻は次に示す記号で囲んで指定します。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

指定を省略した場合，集計対象は最も新しいトレースログエントリまでになります。

指定した時刻が-sオプションで指定した開始時刻以前の場合，エラーになります。

指定した時刻を満たさないトレースログエントリは，集計対象から外されます。
例えば，トレースファイル中の最初のトレースログエントリの時刻が12:00:00.000で，最後のトレースログエントリの時刻が13:00:00.000だとします。このとき，-eオプションに12:45:00.000を指定してEDMRptTraceコマンドを実行した場合，12:00:00.000から 12:44:59.999までのトレースログエントリは集計・出力対象になります。しかし，12:45:00.000から13:00:00.000までのトレースログエントリは集計・出力対象になりません。

-d 集計間隔

ユーザプログラムの処理内容を集計する時間の幅を，分単位の整数で指定します。指定できる値の範囲は1～43200です。例えば，-d 15と指定すると，15分間ごとのユーザプログラムの処理内容が集計されます。

このオプションは，次に示す事項に留意して指定してください。

整数以外を指定した場合，および0以下の値を指定した場合はエラーになります。

集計・出力対象のトレースログエントリは，-sオプション，-eオプションとの組み合わせによって変わります。
例えば，トレースファイル中の最初のトレースログエントリの時刻が12:00:00.000で，最後のトレースログエントリの時刻が13:00:00.000だとします。
このとき，-dオプションに45，-eオプションに12:45:00.000を指定してEDMRptTraceコマンドを実行した場合，12:00:00.000から12:44:59.999までのトレースログエントリが集計・出力対象になります。しかし，12:45:00.000から13:00:00.000までのトレースログエントリは集計・出力対象になりません。
また，このとき，-dオプションに45を指定し，-eオプションを省略してEDMRptTraceコマンドを実行した場合，12:00:00.000から12:44:59.999までのトレースログエントリが最初のインターバルの集計・出力対象になり，12:45:00.000から13:00:00.000までのトレースログエントリは次のインターバルの集計・出力対象になります。

-w

トレースファイルの内容を分割して出力する場合に指定します。

サーバトレース解析の場合はユーザプログラムのプログラム名とユーザプログラムのプロセスIDごとに，クライアントトレース解析の場合はユーザプログラムのスレッドIDごとに，トレースファイルの内容を分割して別々のファイルに出力します。その際，出力されるすべてのエントリは，分類項目のtidでソートされます。同じtidのエントリが複数ある場合は，その中でdateの昇順にソートされます。出力先のディレクトリとファイル名を次に示します。

ディレクトリ

UNIXの場合
DocumentBroker実行環境ディレクトリ/aru/output

Windowsの場合
DocumentBrokerインストールディレクトリ¥Server¥aru¥output

ファイル名

サーバトレース解析の場合
"ユーザプログラムのプログラム名"_"ユーザプログラムのプロセスID".txt

クライアントトレース解析の場合
"ユーザプログラムのスレッドID".txt

なお，このオプションの対象エントリは，enterエントリとmsgエントリです。トレースファイル分割機能の詳細については，「6.3.2(2)　トレースファイル分割機能の処理方式」を参照してください。トレースファイル分割の分類項目については，「6.3.3(2)　トレースファイル分割機能の出力形式」を参照してください。

-t

ユーザプログラムの処理内容のSUBTOTAL（小計）とTOTAL（総計）を出力する場合に指定します。

サーバトレース解析の場合は，ユーザプログラムのプログラム名ごとにSUBTOTALとTOTALが出力されます。クライアントトレース解析の場合は，ユーザプログラムのプロセスIDごとにSUBTOTALとTOTALが出力されます。

なお，このオプションの対象エントリは，enterエントリです。

-v

結果をCSV形式で出力する場合に指定します。

-vt

トレース表を出力する場合に指定します。トレース表については，「6.3.2(1)　集計機能の処理方式（EDMRptTraceコマンドの集計方法）」を参照してください。なお，このオプションの対象エントリは，enterエントリとmsgエントリです。また，ユーザプログラム情報のないサーバトレースのenterエントリも，トレース表に出力されます。

トレース表は，-vオプションを指定しなくても，CSV形式で出力されます。

-o 出力ファイル名

結果をファイルに出力する場合に，出力するファイル名を指定します。ファイルパスは，フルパス，相対パスまたはファイル名だけのどの方法でも指定できます。ファイル名だけを指定した場合，カレントディレクトリに出力されます。

指定を省略する場合，結果は標準出力（stdout）に出力されます。

-x 抽出エントリ定義ファイル名

エントリを抽出する場合に，抽出するエントリの処理の種別を指定した抽出エントリ定義ファイルのファイル名を指定します。抽出エントリ定義ファイルについては，「4.1.5　抽出エントリ定義ファイル」を参照してください。

このオプションは，次に示す事項に留意して指定してください。

ファイルパスは，フルパスまたは相対パスのどちらでも指定できます。フルパスで指定されていない場合は，カレントディレクトリ下を探します。

ハイフン（-）で始まるファイル名は指定できません。ただし，フルパスで指定された場合は処理できます。

ファイル名に空白が含まれている場合，次に示す記号でファイル名全体を囲めば指定できます。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

指定されたファイルがない場合や指定されたファイルがディレクトリの場合，エラーになります。

(4)　コマンド引数

トレースファイル名

解析対象のトレースファイルを指定します。

ディレクトリ名

解析対象のディレクトリを指定します。ただし，サブディレクトリ下のファイルは解析対象に含まれません。ディレクトリパスは，1023バイト以内で指定してください。指定したディレクトリの下にファイルがある場合は，そのファイル名も含めたパスが，1023バイト以内になるようにしてください。

コマンド引数は，次に示す事項に留意して指定してください。

ファイルパスおよびディレクトリパスはフルパスまたは相対パスのどちらでも指定できます。フルパスで指定されていない場合は，カレントディレクトリ下を探します。

ハイフン（-）で始まるファイル名およびディレクトリ名は指定できません。ただし，フルパスで指定された場合は処理できます。

ファイル名およびディレクトリ名に空白が含まれている場合，次に示す記号でファイル名全体を囲めば指定できます。
・UNIXの場合：シングルクォーテーション（'）またはダブルクォーテーション（"）
・Windowsの場合：ダブルクォーテーション（"）

ファイル名およびディレクトリ名の最後のパスの区切り（UNIXの場合「/」，Windowsの場合「¥」）がある場合，標準エラー出力（stderr）にメッセージが出力されます。

次の場合，標準エラー出力（stderr）にメッセージが出力されます。
・指定したファイルまたはディレクトリがない場合
・指定したディレクトリが一つで，そのディレクトリに処理対象のファイルがない場合
・指定したディレクトリが複数で，すべてのディレクトリに処理対象のファイルがない場合

トレースファイルを指定する場合，トレースファイルを160個まで指定できます。なお，複数のファイルを指定した場合，その中にアクセスできないファイルが一つでもあるときは，処理を中止してメッセージを出力します。また，同じファイルを重複して指定しても，そのファイルに対する処理は1回だけになります。

ディレクトリを指定する場合，複数のディレクトリを指定できます。なお，指定したディレクトリ下のファイル総数が160を超えた場合，および指定したディレクトリ下にアクセスできないファイルが一つでもある場合は，処理を中止してメッセージを出力します。また，同じディレクトリを重複して指定しても，そのディレクトリ下のファイルに対する処理は1回だけになります。

トレースファイルは，ASCIIコードとShift-JISコードで構成されています。ただし，enterエントリおよびmsgエントリはASCIIコードで構成されます。

この指定を省略する場合，サーバトレース解析では，EDMRptTraceコマンドのサーバトレース格納ディレクトリ（UNIXの場合「DocumentBroker実行環境ディレクトリ/aru/input/spool/server」，Windowsの場合「DocumentBrokerインストールディレクトリ¥Server¥aru¥input¥spool¥server」）にある「EDMRasTrace"PID"_"NO".log」（"PID"はプロセスID，"NO"は1～16の通し番号）という名称のファイルが対象になります。
このとき，処理できるファイルの数は160個ではなく，上記のファイル名に該当するファイルの数になります。

この指定を省略する場合，クライアントトレース解析では，EDMRptTraceコマンドのクライアントトレース格納ディレクトリ（UNIXの場合「DocumentBroker実行環境ディレクトリ/aru/input/spool/client」，Windowsの場合「DocumentBrokerインストールディレクトリ¥Server¥aru¥input¥spool¥client」）にある「EDMRasTraceCL"PID"_"NO".log」（"PID"はプロセスID，"NO"は1～16の通し番号）という名称のファイルが対象になります。
このとき，処理できるファイルの数は160個ではなく，上記のファイル名に該当するファイルの数になります。

EDMRptTraceコマンドは，DocumentBrokerがトレースファイルを生成するディレクトリにあるファイルを対象にして実行できません。EDMRptTraceコマンドを実行する前に，DocumentBrokerが生成したサーバトレースおよびクライアントトレースを，EDMRptTraceコマンドのサーバトレースまたはクライアントトレース格納ディレクトリにコピーして，コマンド引数でのトレースファイルの指定を省略することをお勧めします。トレースファイルのコピーについては，「4.2.1　トレースファイル」を参照してください。

(5)　注意事項

EDMRptTraceコマンドに関するそのほかの注意事項を次に示します。

オプションの指定順序に規則はありません。どのような順序でも指定できます。

オプションには，指定できない組み合わせがあります。
オプションの指定の組み合わせを次の表に示します。

表6-8　オプションの指定の組み合わせ（EDMRptTraceコマンド）

指定するオプション | 組み合わせるオプション
-sv | -cl | -s | -e | -d | -w | -t | -v | -vt | -o | -x
-sv | × | × |  |  |  |  |  |  |  |  |
-cl | × | × |  |  |  |  |  |  |  |  |
-s |  |  | × |  |  |  |  |  |  |  |
-e |  |  |  | × |  |  |  |  |  |  |
-d |  |  |  |  | × | × |  |  | × |  | ×
-w |  |  |  |  | × | × | × |  | × | × | ×
-t |  |  |  |  |  | × | × |  | × |  | ×
-v |  |  |  |  |  |  |  | × |  |  |
-vt |  |  |  |  | × | × | × |  | × |  | ×
-o |  |  |  |  |  | × |  |  |  | × |
-x |  |  |  |  | × | × | × |  | × |  | ×

（凡例）

空欄：指定できる組み合わせであることを示す。

×　：指定できない組み合わせであることを示す。

機能ごとに処理対象のエントリが異なります。
機能と処理対象のエントリを次の表に示します。

表6-9　機能と処理対象のエントリ

エントリ名 | 集計機能 | トレースファイル分割機能 | エントリ抽出機能
enterエントリ | ○ | ○ | ○
argエントリ | － | － | ○
callエントリ | － | － | ○
returnエントリ | － | － | ○
errorエントリ | － | － | ○
warnエントリ | － | － | ○
markエントリ | － | － | ○
msgエントリ | ○※ | ○ | ○
exitエントリ | － | － | ○

（凡例）

○：処理対象になることを示す。

－：処理対象にならないことを示す。

注※

-tオプションを指定する場合，msgエントリは処理対象になりません。enterエントリだけが処理対象になります。

6.3.2　EDMRptTraceコマンドの機能の処理方式

EDMRptTraceコマンドの次に示す機能の処理方式について説明します。

集計機能

トレースファイル分割機能

エントリ抽出機能

＜この項の構成＞

(1)　集計機能の処理方式（EDMRptTraceコマンドの集計方法）

(2)　トレースファイル分割機能の処理方式

(3)　エントリ抽出機能の処理方式

(1)　集計機能の処理方式（EDMRptTraceコマンドの集計方法）

EDMRptTraceコマンドの集計機能では，まず，トレースファイル中のトレースログを解析して，トレースログエントリごとにトレース表を作成します。その上で，サーバおよびクライアントのプログラムによる処理内容を，ユーザプログラムのプログラム名，プロセスIDおよびスレッドIDで分類・集計して，結果を標準出力（stdout）またはファイルに出力します。

トレース表の項目を次の表に示します。

表6-10　トレース表の項目

項目名
説明

日付
サーバまたはクライアントのプログラムが処理を実行した日付（年/月/日）。

時刻
サーバまたはクライアントのプログラムが処理を実行した時刻（時:分:秒.ミリ秒）。

プロセスID
解析対象によって，プロセスIDが異なります。

サーバトレース解析の場合

サーバプロセスのプロセスID

クライアントトレース解析の場合

ユーザプログラムのプロセスID

スレッドID
解析対象によって，スレッドIDが異なります。

サーバトレース解析の場合

サーバプロセスのスレッドID

クライアントトレース解析の場合

ユーザプログラムのスレッドID

処理の種別
enterまたはmsg。enterまたはmsgについては，「表4-4　messageに出力される処理の種別と処理の内容」を参照してください。

ユーザプログラムのホスト名
トレースログに含まれるユーザプログラム情報の項目。クライアントトレースにはありません。

ユーザプログラムのプログラム名

ユーザプログラムのプロセスID

ユーザプログラムのセッションID

プログラム識別子

処理内容またはメッセージ
処理の種別によって異なります。

enterの場合

クラス名::メソッド名（または関数名）

msgの場合

メッセージ（SQL文など）

トレース表の例を表6-11および表6-12に示します。なお，実際には，表6-11の右側に表6-12が続く形式の一つのトレース表として作成されます。クライアントトレースの場合，ユーザプログラム情報の項目を除いた形式のトレース表になります。

表6-11　トレース表の例（1/2）

日付 | 時刻 | プロセスID | スレッドID | 処理の種別 | ユーザプログラムのホスト名※ | ユーザプログラムのプログラム名※
2000/06/19 | 02:18:19.388 | 00002541​ | 00005488​ | enter | ht01 | UAP01
2000/06/19 | 02:18:52.261 | 00002541​ | 00005488​ | enter | ht01 | UAP01
2000/06/19 | 02:19:16.420 | 00002541​ | 00005488​ | msg | － | －
2000/06/19 | 02:19:16.420 | 00002541​ | 00005488​ | enter | ht01 | UAP01

（凡例）

－：該当する内容がないことを示す。

注※

ユーザプログラム情報の項目です。クライアントトレースのトレース表にはありません。

表6-12　トレース表の例（2/2）

ユーザプログラムのプロセスID※ | ユーザプログラムのセッションID※ | プログラム識別子※ | 処理内容またはメッセージ
14455 | 545421asd(usr) | EDMS2225 | CedmRasMsg::cs_setMsgFormatter()
14455 | 545421asd(usr) | EDMS2225 | CedmRasMsg::cs_setMsgFormatter()
－ | － | － | SELECT "dmaProp_OIID" FROM "mdmClass_CfgH"
14455 | 545421asd(usr) | EDMS2225 | Edm_sys_open_directory()

（凡例）

－：該当する内容がないことを示す。

注※

ユーザプログラム情報の項目です。クライアントトレースのトレース表にはありません。

なお，トレース表は，EDMRptTraceコマンド実行時に-vtオプションを指定することによって出力できます。

(2)　トレースファイル分割機能の処理方式

トレースファイルには，複数のユーザプログラム情報が含まれています。EDMRptTraceコマンドのトレースファイル分割機能では，トレースファイルの内容を分割して別々のファイルに出力します。サーバトレース解析の場合はユーザプログラムのプログラム名とユーザプログラムのプロセスIDごとに，クライアントトレース解析の場合はユーザプログラムのスレッドIDごとに分割して出力します。その際，出力されるすべてのエントリは，出力結果の分類項目であるtidでソートされます。同じtidのエントリが複数ある場合は，その中でdateの昇順にソートされます。出力結果の分類項目のtidおよびdateについては，「6.3.3(2)　トレースファイル分割機能の出力形式」を参照してください。

トレースファイル分割の概念を図6-6および図6-7に示します。

図6-6　トレースファイル分割の概念（サーバトレース解析の場合）

図6-7　トレースファイル分割の概念（クライアントトレース解析の場合）

トレースファイル分割機能で出力されるファイルの出力先のディレクトリとファイル名を次に示します。

ディレクトリ

UNIXの場合

DocumentBroker実行環境ディレクトリ/aru/output

Windowsの場合

DocumentBrokerインストールディレクトリ¥Server¥aru¥output

ファイル名

サーバトレース解析の場合

"ユーザプログラムのプログラム名"_"ユーザプログラムのプロセスID".txt

クライアントトレース解析の場合

"ユーザプログラムのスレッドID".txt

ファイル名の規則を次に示します。

すでに同名のファイルがある場合，そのファイル名に"_n"（nは通し番号。最大値は15）を付加した形式で出力されます。

"_n"を付加した形式のファイルがある場合，最終更新ファイルのnに1を足したファイルが出力または更新されます。なお，nが15のファイルが最終更新ファイルの場合，"_n"が付いてないファイルが更新されます。
例えば，nが5のファイルが最終更新ファイルの場合，nが6のファイルが更新されます。また，nが9のファイルしかない場合，nが10のファイルが出力されます。

ファイル名の例を次に示します。

サーバトレース解析の場合のファイル名の例

例1：同名のファイルがない場合

「UP01_0134.txt」というファイルが出力されます。

例2：同名のファイル「UP01_0134.txt」がある場合

「UP01_0134_1.txt」というファイルが出力されます。

例3：ファイル「UP01_0134_5.txt」が最終更新ファイルの場合

「UP01_0134_6.txt」というファイルが出力されます。

例4：ファイル「UP01_0134_9.txt」しかない場合

「UP01_0134_10.txt」というファイルが出力されます。

クライアントトレース解析の場合のファイル名の例

例1：同名のファイルがない場合

「0001.txt」というファイルが出力されます。

例2：同名のファイル「0001.txt」がある場合

「0001_1.txt」というファイルが出力されます。

例3：ファイル「0001_5.txt」が最終更新ファイルの場合

「0001_6.txt」というファイルが出力されます。

例4：ファイル「0001_9.txt」しかない場合

「0001_10.txt」というファイルが出力されます。

(3)　エントリ抽出機能の処理方式

トレースログエントリには，プログラムの処理内容を表す処理の種別が含まれています。EDMRptTraceコマンドのエントリ抽出機能では，抽出エントリ定義ファイルに指定された処理の種別によって，トレースログエントリを抽出して，結果を標準出力（stdout）またはファイルに出力します。

6.3.3　EDMRptTraceコマンドの出力形式

EDMRptTraceコマンド実行結果の出力形式について説明します。

＜この項の構成＞

(1)　集計機能の出力形式

(2)　トレースファイル分割機能の出力形式

(3)　エントリ抽出機能の出力形式

(1)　集計機能の出力形式

EDMRptTraceコマンドの集計機能の出力例を次の図に示します。

図6-8　EDMRptTraceコマンドの集計機能の出力例

図6-8の要素(a)～(e)について説明します。

(a)　共通情報

集計結果に関する共通情報が出力されます。COUNT STARTからINTERVALまでの共通情報の出力形式を次に示します。

# <共通情報名> = <値>

出力される共通情報の内容は，EDMRptTraceコマンドのオプションの指定によって変わります。共通情報の内容およびオプションの指定との関係を次に示します。

# EDMRptTrace <オプション><引数>

実行したコマンドラインが出力されます。

# COUNT START = yyyy/mm/dd hh:mm:ss.sss

開始エントリの時刻が出力されます。-sオプションで開始時刻を指定している場合，その指定値が出力されます。-sオプションで開始時刻を指定していない場合，ログ開始時刻（LOG START）が出力されます。

COUNT STARTに該当するエントリは，集計対象になります。

# COUNT END = yyyy/mm/dd hh:mm:ss.sss

終了エントリの時刻が出力されます。-eオプションで終了時刻を指定している場合，その指定値が出力されます。-eオプションで終了時刻を指定していない場合，ログ終了時刻（LOG END）に1ミリ秒を足した時刻が出力されます。

COUNT ENDに該当するエントリは，集計対象になりません。

# LOG START = yyyy/mm/dd hh:mm:ss.sss

ログ開始時刻（ログ内の最も古いトレースログエントリの時刻）が出力されます。

# LOG END = yyyy/mm/dd hh:mm:ss.sss

ログ終了時刻（ログ内の最も新しいトレースログエントリの時刻）が出力されます。

# INTERVAL = mm minutes

-dオプションの指定値（ユーザプログラムの処理内容の集計間隔）が出力されます。-dオプションを指定していない場合は出力されません。

(b)　分類項目

分類項目が出力され，その下に各項目の内容が出力されます。分類項目とその内容は，サーバトレース解析（-svオプション指定）かクライアントトレース解析（-clオプション指定）かによって，次に示す違いがあります。

サーバトレース解析の場合の分類項目

program name

ユーザプログラムのプログラム名が14バイトまで出力されます。14バイトを超える場合，15バイト以降は出力されません。CSV形式では15バイト以降も出力されます。

program nameはトレースログに出現した順に出力されます。

pid

ユーザプログラムのプロセスIDが8バイトで出力されます。

pidは昇順にソートされて出力されます。

クライアントトレース解析の場合の分類項目

pid

ユーザプログラムのプロセスIDが8バイトで出力されます。

pidはトレースログに出現した順に出力されます。

tid

ユーザプログラムのスレッドIDが8バイトで出力されます。

tidは昇順にソートされて出力されます。

(c)　集計結果

集計結果の項目が出力され，その下に各項目の内容が出力されます。集計結果の項目とその内容を次に示します。

message

ユーザプログラムの処理内容が，47バイトまで出力されます。47バイトを超える場合，48バイト以降は出力されません。CSV形式では48バイト以降も出力されます。

messageはトレースログに出現した順に出力されます。

なお，ユーザプログラムの処理内容とは，トレースログ中のmessageという項目に含まれる，実行されたメソッド名または関数名です。ユーザプログラムの処理内容は次に示す形式で出力されます。

　クラス名::メソッド名（または関数名）

トレースログ中のmessageについては，「4.2.1(2)(b)　トレースログの項目」を参照してください。

times

メソッドまたは関数の実行回数を示す数字が，7バイトまで出力されます。7バイトを超える場合，8バイト以降は出力されません。CSV形式では8バイト以降も出力されます。

(d)　SUBTOTAL

-tオプションを指定した場合，サーバトレース解析では分類項目のprogram nameごとに，クライアントトレース解析では分類項目のpidごとに，メソッドまたは関数の実行回数の小計が出力されます。

(e)　TOTAL

-tオプションを指定した場合，メソッドまたは関数の実行回数の総計が出力されます。

(2)　トレースファイル分割機能の出力形式

EDMRptTraceコマンドのトレースファイル分割機能の出力例を次の図に示します。なお，次の図では1エントリは複数行にわたって見えますが，実際には1エントリは1行で出力されます。

図6-9　EDMRptTraceコマンドのトレースファイル分割機能の出力例

図6-9の要素(a)，(b)について説明します。

(a)　共通情報

集計結果に関する共通情報が出力されます。COUNT STARTからLOG ENDまでの共通情報の出力形式を次に示します。

# <共通情報名> = <値>

出力される共通情報の内容は，EDMRptTraceコマンドのオプションの指定によって変わります。共通情報の内容およびオプションの指定との関係を次に示します。

# EDMRptTrace <オプション><引数>

実行したコマンドラインが出力されます。

# COUNT START = yyyy/mm/dd hh:mm:ss.sss

開始エントリの時刻が出力されます。-sオプションで開始時刻を指定している場合，その指定値が出力されます。-sオプションで開始時刻を指定していない場合，ログ開始時刻（LOG START）が出力されます。

COUNT STARTに該当するエントリは，集計対象になります。

# COUNT END = yyyy/mm/dd hh:mm:ss.sss

終了エントリの時刻が出力されます。-eオプションで終了時刻を指定している場合，その指定値が出力されます。-eオプションで終了時刻を指定していない場合，ログ終了時刻（LOG END）に1ミリ秒を足した時刻が出力されます。

COUNT ENDに該当するエントリは，集計対象になりません。

# LOG START = yyyy/mm/dd hh:mm:ss.sss

ログ開始時刻（ログ内の最も古いトレースログエントリの時刻）が出力されます。

# LOG END = yyyy/mm/dd hh:mm:ss.sss

ログ終了時刻（ログ内の最も新しいトレースログエントリの時刻）が出力されます。

(b)　分類項目

分類項目が出力され，その下に各項目の内容が出力されます。分類項目とその内容を次に示します。

date

トレースログの出力日付と時間が23バイトで出力されます。

同じtidのエントリが複数ある場合は，その中でdateの昇順にソートされて出力されます。

tid

スレッドIDが8バイトで出力されます。ただし，サーバトレース解析（-svオプション指定）かクライアントトレース解析（-clオプション指定）かによって，次に示す違いがあります。

サーバトレース解析の場合

サーバプロセスのスレッドID

クライアントトレース解析の場合

ユーザプログラムのスレッドID

tidは昇順にソートされて出力されます。

message

トレースログのmessageという項目の内容がそのまま出力されます。トレースログのmessageという項目については，「4.2.1(2)(b)　トレースログの項目」を参照してください。

(3)　エントリ抽出機能の出力形式

-xオプションを指定した場合，抽出エントリ定義ファイルに指定した処理の種別によって，トレースログエントリが抽出されて出力されます。

エントリ抽出機能の出力例を次の図に示します。この例では，抽出エントリ定義ファイルに処理の種別「msg」を指定して，msgエントリを抽出しています。

図6-10　EDMRptTraceコマンドのエントリ抽出機能の出力例

6.3.4　EDMRptTraceコマンドの出力例

EDMRptTraceコマンド実行結果の出力例を次に示します。

＜この項の構成＞

(1)　サーバトレースの集計結果の出力例（-sv 指定）

(2)　サーバトレースの集計結果のCSV形式での出力例（-sv -v 指定）

(3)　クライアントトレースの集計結果の出力例（-cl 指定）

(4)　クライアントトレースの集計結果のCSV形式での出力例（-cl -v 指定）

(5)　エントリの抽出例（-sv -x 抽出エントリ定義ファイル 指定）

(6)　トレースファイル分割の出力例（-cl -w 指定）

(7)　トレースファイル分割のCSV形式での出力例（-sv -w -v 指定）

(8)　SUBTOTAL，TOTALの出力例（-sv -t 指定）

(9)　SUBTOTAL，TOTALのCSV形式での出力例（-sv -t -v 指定）

(10)　トレース表の出力例（-sv -vt 指定）

(11)　集計間隔を指定した出力例（-sv -s '開始時刻' -e '終了時刻' -d 集計間隔 指定）

(12)　集計間隔を指定したCSV形式での出力例（-sv -s '開始時刻' -e '終了時刻' -d 集計間隔 -v 指定）

(1)　サーバトレースの集計結果の出力例（-sv 指定）

サーバトレースを解析して，ユーザプログラムの処理内容の集計結果を出力した例を次に示します。

# EDMRptTrace -sv
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

program name   pid      message                                         times
-------------- -------- ----------------------------------------------- --------
prog01         00005124​ CdbrSession::Commit()                                  2
                       CdbrSession::Begin()                                   3
                       CdbrSession::GetSearchResult()                         5
              -------- ----------------------------------------------- --------
              00005132​ CdbrSession::Commit()                                 21
                       CdbrSession::Begin()                                  32
                       CdbrEqlStatement::Execute()                           18
                       CdbrSession::GetSearchResult()                        18
-------------- -------- ----------------------------------------------- --------
prog02         00009588​ CdbrSession::Commit()                                  7
                       CdbrSession::Begin()                                   8
                       CdbrSession::GetSearchResult()                         4
-------------- -------- ----------------------------------------------- --------

(2)　サーバトレースの集計結果のCSV形式での出力例（-sv -v 指定）

サーバトレースを解析して，ユーザプログラムの処理内容の集計結果をCSV形式で出力した例を次に示します。なお，CSV形式での出力では，分類項目の内容（この例ではユーザプログラムのプログラム名とユーザプログラムのプロセスID）は，集計結果の行数分，繰り返し出力されます。

"#","EDMRptTrace -sv -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"program name","pid","message","times"
"prog01","00005124​","CdbrSession::Commit()",2
"prog01","00005124​","CdbrSession::Begin()",3
"prog01","00005124​","CdbrSession::GetSearchResult()",5
"prog01","00005132​","CdbrSession::Commit()",21
"prog01","00005132​","CdbrSession::Begin()",32
"prog01","00005132​","CdbrEqlStatement::Execute()",18
"prog01","00005132​","CdbrSession::GetSearchResult()",18
"prog02","00009588​","CdbrSession::Commit()",7
"prog02","00009588​","CdbrSession::Begin()",8
"prog02","00009588​","CdbrSession::GetSearchResult()",4

(3)　クライアントトレースの集計結果の出力例（-cl 指定）

クライアントトレースを解析して，ユーザプログラムの処理内容の集計結果を出力した例を次に示します。

# EDMRptTrace -cl
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

pid      tid      message                                         times
-------- -------- ----------------------------------------------- --------
00002365​ 00005124​ CdbrSession::Commit()                                  2
                 CdbrSession::Begin()                                   3
                 CdbrSession::GetSearchResult()                         5
        -------- ----------------------------------------------- --------
        00005132​ CdbrSession::Commit()                                 21
                 CdbrSession::Begin()                                  32
                 CdbrEqlStatement::Execute()                           18
                 CdbrSession::GetSearchResult()                        18
-------- -------- ----------------------------------------------- --------
00007845​ 00009588​ CdbrSession::Commit()                                  7
                 CdbrSession::Begin()                                   8
                 CdbrSession::GetSearchResult()                         4
-------- -------- ----------------------------------------------- --------

(4)　クライアントトレースの集計結果のCSV形式での出力例（-cl -v 指定）

クライアントトレースを解析して，ユーザプログラムの処理内容の集計結果をCSV形式で出力した例を次に示します。なお，CSV形式での出力では，分類項目の内容（この例ではユーザプログラムのプロセスIDとユーザプログラムのスレッドID）は，集計結果の行数分，繰り返し出力されます。

"#","EDMRptTrace -cl -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"pid","tid","message","times"
"00002365​","00005124​","CdbrSession::Commit()",2
"00002365​","00005124​","CdbrSession::Begin()",3
"00002365​","00005124​","CdbrSession::GetSearchResult()",5
"00002365​","00005132​","CdbrSession::Commit()",21
"00002365​","00005132​","CdbrSession::Begin()",32
"00002365​","00005132​","CdbrEqlStatement::Execute()",18
"00002365​","00005132​","CdbrSession::GetSearchResult()",18
"00007845​","00009588​","CdbrSession::Commit()",7
"00007845​","00009588​","CdbrSession::Begin()",8
"00007845​","00009588​","CdbrSession::GetSearchResult()",4

(5)　エントリの抽出例（-sv -x 抽出エントリ定義ファイル 指定）

この例では，-xオプションで，次の抽出エントリ定義ファイルを指定したと仮定します。

[Extract Trace]
msg

また，この例では，コマンド引数で，次のサーバトレースを指定したと仮定します。

Input_trace.log:
0000 2000/07/05 14:27:04.727   DocumentBroker   00006A41 00000001​    enter abc_enter()
0001 2000/07/05 14:27:04.728   DocumentBroker   00006A41 00000001​    exit abc_exit()
0002 2000/07/05 14:27:04.730   DocumentBroker   00006A41 00000001​    arg argc 9
0003 2000/07/05 14:27:04.731   DocumentBroker   00006A41 00000001​    msg msg_SELECT
0004 2000/07/05 14:27:04.732   DocumentBroker   00006A41 00000001​    call abc_call()
0005 2000/07/05 14:27:04.733   DocumentBroker   00006A41 00000001​    return abc_return()

サーバトレースからmsgエントリを抽出して出力した例を次に示します。

# EDMRptTrace -sv -x extract.def Input_trace.log
# COUNT START = 2000/07/05 14:27:04.727
# COUNT END   = 2000/07/05 14:27:04.734
# LOG START   = 2000/07/05 14:27:04.727
# LOG END     = 2000/07/05 14:27:04.733

0003 2000/07/05 14:27:04.731    DocumentBroker   00006A41 00000001​    msg msg_SELECT

(6)　トレースファイル分割の出力例（-cl -w 指定）

クライアントトレースを分割して出力した例を次に示します。

# EDMRptTrace -cl -w
# COUNT START = 2000/07/24 19:00:00.000
# COUNT END   = 2000/07/24 19:00:00.028
# LOG START   = 2000/07/24 19:00:00.000
# LOG END     = 2000/07/24 19:00:00.027

date                    tid      message
----------------------- -------- -----------------------------------------------
2000/07/24 19:00:00.000 00000001​ enter CdbrEqlStatement::CdbrEqlStatement()
2000/07/24 19:00:00.002 00000001​ enter CdbrEqlStatement::Initialize()
2000/07/24 19:00:00.004 00000001​ enter CdbrCoreImp::SetObjectID()
2000/07/24 19:00:00.006 00000001​ enter CdbrEqlStatement::Set()
2000/07/24 19:00:00.008 00000001​ enter CdbrEqlStatement::ChangeGetObjCount()
2000/07/24 19:00:00.010 00000001​ enter CdbrEqlStatement::Execute()
2000/07/24 19:00:00.012 00000001​ enter CdbrEqlStatement::GetResult()
2000/07/24 19:00:00.014 00000001​ enter dbrDelete(SDBR_QUERYRESULT*)()
2000/07/24 19:00:00.015 00000001​ enter CdbrEqlStatement::GetACLMode()
2000/07/24 19:00:00.017 00000001​ enter CdbrEqlStatement::DeleteResult()
2000/07/24 19:00:00.019 00000001​ enter CdbrEqlStatement::Terminate()
2000/07/24 19:00:00.021 00000001​ enter CdbrCoreImp::ResetObjectID()
2000/07/24 19:00:00.023 00000001​ enter CdbrEqlStatement::~CdbrEqlStatement()
2000/07/24 19:00:00.025 00000001​ enter CdbrCoreImp::ResetObjectID()
2000/07/24 19:00:00.027 00000001​ enter CdbrSession::Commit()

(7)　トレースファイル分割のCSV形式での出力例（-sv -w -v 指定）

サーバトレースを分割してCSV形式で出力した例を次に示します。

"#","EDMRptTrace -sv -w -v"
"#","COUNT START","2000/06/05","12:27:48.506"
"#","COUNT END","2000/06/05","12:27:48.516"
"#","LOG START","2000/06/05","12:27:48.506"
"#","LOG END","2000/06/05","12:27:48.515"
"date","time","tid","message"
"2000/06/05","12:27:48.506","00000001​","enter","CedmRasMsg::cs_setMsgFormatter()","sis01","WETG2J0","12491","000052823906310000040​a0d(userdoc)","EDMS000021122​","()"
"2000/06/05","12:27:48.506","00000001​","enter","CedmRasMsg::cs_setMsgFormatter()","sis01","WETG2J0","12491","000052823906310000040​a0d(userdoc)","EDMS000021122​","()"
"2000/06/05","12:27:48.507","00000002​","enter","CedmCmdClassDescriptionForMulti::Initialize()"
"2000/06/05","12:27:48.507","00000002​","msg","SELECT P9FFOR71O0OFC9972P521A2HD56,P9FFOR71O00GC99727V7140CF56,P9FFOR71O0OFC9972VM01ESQF56,P9FFOR71O00GC9972E061CD0LM5 FROM T9FFOR71O0OFC9972O521IUPU96 WHERE PI29HEI0K08PBO872DLUUMRGB4='00000000​ABC42239'"
"2000/06/05","12:27:48.507","00000002​","enter","Edm_sys_open_directory()"
"2000/06/05","12:27:48.514","00000002​","enter","Edm_sys_open_directory()"
"2000/06/05","12:27:48.514","00000003​","enter","CdbrSession::Commit()","sis01","WETG2J0","12491","000052823906310000040​a0d(userdoc)","EDMS000021122​","()"
"2000/06/05","12:27:48.514","00000003​","enter","CdbrSession::Begin()","sis01","WETG2J0","12491","000052823906310000040​a0d(userdoc)","EDMS000021122​","()"
"2000/06/05","12:27:48.514","00000003​","enter","CdbrEqlStatement::Execute()","sis01","WETG2J0","12491","000052823906310000040​a0d(userdoc)","EDMS000021122​","()"
"2000/06/05","12:27:48.515","00000003​","enter","CdbrSession::GetSearchResult()","sis01","WETG2J0","12491","000052823906310000040​a0d(userdoc)","EDMS000021122​","()"

(8)　SUBTOTAL，TOTALの出力例（-sv -t 指定）

SUBTOTALおよびTOTALを出力した例を次に示します。

# EDMRptTrace -sv -t
# COUNT START = 2000/06/19 15:00:00.000
# COUNT END   = 2000/06/19 18:00:00.001
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 18:00:00.000

program name  pid      message                                         times
------------- -------- ----------------------------------------------- --------
prog01        00005124​ CdbrSession::Commit()                                  2
                      CdbrSession::Begin()                                   3
                      CdbrSession::GetSearchResult()                         5
             -------- ----------------------------------------------- --------
             00005132​ CdbrSession::Commit()                                 21
                      CdbrSession::Begin()                                  32
                      CdbrEqlStatement::Execute()                           18
                      CdbrSession::GetSearchResult()                        18
------------- -------- ----------------------------------------------- --------
SUBTOTAL               CdbrSession::Commit()                                 23
                      CdbrSession::Begin()                                  35
                      CdbrEqlStatement::Execute()                           18
                      CdbrSession::GetSearchResult()                        23
------------- -------- ----------------------------------------------- --------
prog02        00009588​ CdbrSession::Commit()                                  7
                      CdbrSession::Begin()                                   8
                      CdbrSession::GetSearchResult()                         4
------------- -------- ----------------------------------------------- --------
SUBTOTAL               CdbrSession::Commit()                                  7
                      CdbrSession::Begin()                                   8
                      CdbrSession::GetSearchResult()                         4
------------- -------- ----------------------------------------------- --------
TOTAL                  CdbrSession::Commit()                                 30
                      CdbrSession::Begin()                                  43
                      CdbrEqlStatement::Execute()                           18
                      CdbrSession::GetSearchResult()                        27
------------- -------- ----------------------------------------------- --------

(9)　SUBTOTAL，TOTALのCSV形式での出力例（-sv -t -v 指定）

SUBTOTALおよびTOTALをCSV形式で出力した例を次に示します。なお，CSV形式での出力では，分類項目の内容（この例ではユーザプログラムのプログラム名とユーザプログラムのプロセスID）と-tオプションのSUBTOTALおよびTOTALは，集計結果の行数分，繰り返し出力されます。

"#","EDMRptTrace -sv -t -v"
"#","COUNT START","2000/06/19","15:00:00.000"
"#","COUNT END","2000/06/19","18:00:00.001"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","18:00:00.000"
"program name","pid","message","times"
"prog01","00005124​","CdbrSession::Commit()",2
"prog01","00005124​","CdbrSession::Begin()",3
"prog01","00005124​","CdbrSession::GetSearchResult()",5
"prog01","00005132​","CdbrSession::Commit()",21
"prog01","00005132​","CdbrSession::Begin()",32
"prog01","00005132​","CdbrEqlStatement::Execute()",18
"prog01","00005132​","CdbrSession::GetSearchResult()",18
"SUBTOTAL","","CdbrSession::Commit()",23
"SUBTOTAL","","CdbrSession::Begin()",35
"SUBTOTAL","","CdbrEqlStatement::Execute()",18
"SUBTOTAL","","CdbrSession::GetSearchResult()",23
"prog02","00009588​","CdbrSession::Commit()",7
"prog02","00009588​","CdbrSession::Begin()",8
"prog02","00009588​","CdbrSession::GetSearchResult()",4
"SUBTOTAL","","CdbrSession::Commit()",7
"SUBTOTAL","","CdbrSession::Begin()",8
"SUBTOTAL","","CdbrSession::GetSearchResult()",4
"TOTAL","","CdbrSession::Commit()",30
"TOTAL","","CdbrSession::Begin()",43
"TOTAL","","CdbrEqlStatement::Execute()",18
"TOTAL","","CdbrSession::GetSearchResult()"27

(10)　トレース表の出力例（-sv -vt 指定）

サーバトレースのトレース表を出力した例を次に示します。トレース表は，-vオプションを指定しなくても，CSV形式で出力されます。

"#","EDMRptTrace -sv -vt"
"#","COUNT START"," 2000/06/19"," 02:18:19.388"
"#","COUNT END"," 2000/06/19"," 02:19:16.421"
"#","LOG START"," 2000/06/19"," 02:18:19.388"
"#","LOG END"," 2000/06/19"," 02:19:16.420"
"date","time","process ID","thread ID","classification","host name","program name","process ID","session ID","program ID","message"
"2000/06/19","02:18:19.388","00004FDD","0000186​E","msg","","","","","","UPDATE "edmClass_VTCRelationship" SET "edmProp_VTMode"=2,"dmaProp_Head"=? WHERE "dmaProp_OIID"='0000000000000​F10'"
"2000/06/19","02:18:52.261","00004FDD","0000186​E","msg","","","","","","CdabSqlStringValue::DoSetParam, SetParam:0bc46760-366c-11d2-917c-0000e21303670000000000000​F08"
"2000/06/19","02:18:59.392","00005FDD","0000186​F","enter","maruko","dbrsetmode","11519","00004fdd397e5ef20009c3f7(ACUser1)","EDMS000020445​","CdbrDMA::ReleaseObject()"
"2000/06/19","02:19:08.015","00004FDD","0000186​E","enter","maruko","dbrsetmode","11519","00004fdd397e5ef20009c3f7(ACUser1)","EDMS000020445​","CdbrSession::Commit()"
"2000/06/19","02:19:16.420","00004FDD","0000186​E","msg","","","","","","[FPT02] Session_Commit                  ( ObjectName=00004fdd397e5ef20009c3f7 )"

(11)　集計間隔を指定した出力例（-sv -s '開始時刻' -e '終了時刻' -d 集計間隔 指定）

集計の開始時刻（2000/06/19 14:30:00.000）と終了時刻（2000/06/19 16:30:00.000）に加えて，集計間隔（20）を指定してユーザプログラムの処理内容を集計して出力した例を次に示します。

# EDMRptTrace -sv -s '2000/06/19 14:30:00.000' -e '2000/06/19 16:30:00.000' -d 20
# COUNT START = 2000/06/19 14:30:00.000
# COUNT END   = 2000/06/19 16:30:00.000
# LOG START   = 2000/06/19 15:00:00.000
# LOG END     = 2000/06/19 16:00:00.000
# INTERVAL    = 20 minutes

# COUNT START = 2000/06/19 14:30:00.000

# No entry found.

# COUNT START = 2000/06/19 14:50:00.000

program name  pid      message                                         times
------------- -------- ----------------------------------------------- --------
prog01        00005124​ CdbrSession::Commit()                                  1
                      CdbrSession::Begin()                                   2
                      CdbrSession::GetSearchResult()                         3
------------- -------- ----------------------------------------------- --------

# COUNT START = 2000/06/19 15:10:00.000

program name  pid      message                                         times
------------- -------- ----------------------------------------------- --------
prog01        00005124​ CdbrSession::Commit()                                  4
                      CdbrSession::Begin()                                   5
                      CdbrSession::GetSearchResult()                         6
------------- -------- ----------------------------------------------- --------

# COUNT START = 2000/06/19 15:30:00.000

program name  pid      message                                         times
------------- -------- ----------------------------------------------- --------
prog01        00005124​ CdbrSession::Commit()                                  7
                      CdbrSession::Begin()                                   8
                      CdbrSession::GetSearchResult()                         9
------------- -------- ----------------------------------------------- --------

# COUNT START = 2000/06/19 15:50:00.000

program name  pid      message                                         times
------------- -------- ----------------------------------------------- --------
prog01        00005124​ CdbrSession::Commit()                                 10
                      CdbrSession::Begin()                                  11
                      CdbrSession::GetSearchResult()                        12
------------- -------- ----------------------------------------------- --------

# COUNT START = 2000/06/19 16:10:00.000

# No entry found.

この例では，集計対象となるのは，2000/06/19 14:30:00.000から2000/06/19 16:29:59.999までのトレースログエントリです。2000/06/19 14:30:00.000から20分間隔で集計しています。

ログ終了時刻2000/06/19 16:00:00.000を超えて2000/06/19 16:10:00.000に集計したときには，該当するエントリがない，つまりユーザプログラムによる処理がなかったため「No entry found.」という結果が出力されています。

(12)　集計間隔を指定したCSV形式での出力例（-sv -s '開始時刻' -e '終了時刻' -d 集計間隔 -v 指定）

集計の開始時刻（2000/06/19 14:30:00.000）と終了時刻（2000/06/19 16:30:00.000）に加えて，集計間隔（20）を指定してユーザプログラムの処理内容を集計してCSV形式で出力した例を次に示します。なお，CSV形式での出力では，分類項目の内容（この例ではユーザプログラムのプログラム名とユーザプログラムのプロセスID）は，集計結果の行数分，繰り返し出力されます。

"#","EDMRptTrace -sv -s '2000/06/19 14:30:00.000' -e '2000/06/19 16:30:00.000' -d 20 -v"
"#","COUNT START","2000/06/19","14:30:00.000"
"#","COUNT END","2000/06/19","16:30:00.000"
"#","LOG START","2000/06/19","15:00:00.000"
"#","LOG END","2000/06/19","16:00:00.000"
"#","INTERVAL",20,"minutes"
"#","COUNT START","2000/06/19","14:30:00.000"
"#","No entry found."
"#","COUNT START","2000/06/19","14:50:00.000"
"program name","pid","message","times"
"prog01","00005124​","CdbrSession::Commit()",1
"CdbrSession::Begin()",2
"CdbrSession::GetSearchResult()",3
"#","COUNT START","2000/06/19","15:10:00.000"
"program name","pid","message","times"
"prog01","00005124​","CdbrSession::Commit()",4
"CdbrSession::Begin()",5
"CdbrSession::GetSearchResult()",6
"#","COUNT START","2000/06/19","15:30:00.000"
"program name","pid","message","times"
"prog01","00005124​","CdbrSession::Commit()",7
"CdbrSession::Begin()",8
"CdbrSession::GetSearchResult()",9
"#","COUNT START","2000/06/19","15:50:00.000"
"program name","pid","message","times"
"prog01","00005124​","CdbrSession::Commit()",10
"CdbrSession::Begin()",11
"CdbrSession::GetSearchResult()",12
"#","COUNT START","2000/06/19","16:10:00.000"
"#","No entry found."

付録

＜この付録の構成＞

付録A　用語解説

付録A　用語解説

このマニュアルで使用している，統計解析ツールに関する用語について説明します。ここで説明していないDocumentBrokerの用語については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

（英字）

ClassIdエントリ

プロパティ拡張情報ファイルのクラス名セクションを構成する要素の一つで，このエントリにOIID変換，操作対象識別子変換をするプロパティのクラス識別子を指定します。

connect（集計項目）

EDMRptAclogコマンドの集計項目の一つです。アクセスログファイルのCONNECTエントリが，この項目に分類されて集計されます。

create（集計項目）

EDMRptAclogコマンドの集計項目の一つです。アクセスログファイルのCREATE OBJECTエントリが，この項目に分類されて集計されます。

CSV形式

データをテキストとしてファイルに記録するときの形式の一つで，1レコード内のデータをコンマで区切って並べる形式のことです。統計解析ツールでは，コマンドによる処理結果をこの形式で出力できるようにしています。

delete（集計項目）

EDMRptAclogコマンドの集計項目の一つです。アクセスログファイルのDELETE OBJECTエントリが，この項目に分類されて集計されます。

DocumentSpace構成定義ファイル（docspace.ini）

文書空間の構成を定義するためのファイルで，EDMRptAclogコマンドのデータベース（HiRDB）への接続に使用します。HiRDBのホスト名とポート番号，ユーザのユーザ名とパスワードを指定しておきます。

EDMRptAclogコマンドは，データベースに接続する際に，DocumentSpace構成定義ファイルを参照します。

EDMRptAclogコマンド

統計解析ツールが提供するコマンドの一つで，アクセスログファイルの解析・分類・集計をする際にユーザが使用します。

EDMRptTraceコマンド

統計解析ツールが提供するコマンドの一つで，トレースファイルの解析・分類・集計をする際にユーザが使用します。

enterエントリ

EDMRptTraceコマンドが処理の対象としているトレースログの一つです。

error（集計項目）

EDMRptAclogコマンドの集計項目の一つです。アクセスログファイルのERRORエントリが，この項目に分類されて集計されます。

GUID

Globally Unique Identifierの略です。DMAのクラス，プロパティ，検索オペレータなどに与えるユニークな識別子です。GUIDは，「X」を0～9およびa～f（小文字）で表される16進数とした「XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX（8けた-4けた-4けた-4けた-12けた）」の形式で表されます。

msgエントリ

EDMRptTraceコマンドが処理の対象としているトレースログの一つです。

OIID

Object Instance Identifierの略です。文書空間での永続オブジェクトの存在や格納位置などを明確にするために使用する識別子です。OIIDはDMA URLとして定義されます。

OIID変換機能

EDMRptAclogコマンドが提供する機能の一つで，アクセスログ中のOIIDを，ユーザが見てわかるように，アクセス対象オブジェクトのプロパティの値に置き換えます。

PdHostエントリ

DocumentSpace構成定義ファイルの［Entry0001］セクションを構成する要素の一つで，このエントリにHiRDBサーバのホスト名を指定します。

PdNamePortエントリ

DocumentSpace構成定義ファイルの［Entry0001］セクションを構成する要素の一つで，このエントリにHiRDBサーバのポート番号を指定します。

PdUserエントリ

DocumentSpace構成定義ファイルの［Entry0001］セクションを構成する要素の一つで，このエントリにデータベース（HiRDB）に接続するユーザのユーザ名とパスワードを指定します。

PrepresentPropertiesエントリ

プロパティ拡張情報ファイルのクラス名セクションを構成する要素の一つで，このエントリにOIID変換，操作対象識別子変換をするプロパティのプロパティ名を指定します。ここで指定したプロパティの値がOIID，操作対象識別子の変換対象になります。

refer（集計項目）

EDMRptAclogコマンドの集計項目の一つです。アクセスログファイルのGET RESULTエントリ以外のGET XXXXエントリ（XXXXは処理対象を表す引数）などの，オブジェクトの参照に関連するアクセスログが，この項目に分類されて集計されます。

search（集計項目）

EDMRptAclogコマンドの集計項目の一つです。アクセスログファイルのEXECUTE SEARCHエントリ，GET RESULTエントリなどの，検索の実行に関連するアクセスログが，この項目に分類されて集計されます。

update（集計項目）

EDMRptAclogコマンドの集計項目の一つです。アクセスログファイルのCHANGE XXXXエントリ，SET XXXXエントリ（XXXXは処理対象を表す引数）などの，オブジェクトの更新を伴ったアクセスログが，この項目に分類されて集計されます。

（ア行）

アクセスログ

アクセスログファイルに残されている一つ一つの記録のことです。DocumentBrokerは，DocumentBrokerで構築された文書管理システムへのアクセス状況を，アクセスログとして記録しています。

アクセスログ表

集計機能で利用するために，EDMRptAclogコマンドが作成する一時ファイルです。

アクセスログファイル（EDMAccess_"NO".log）

アクセスログが格納されているファイルのことです。なお，"NO"は1～16の通し番号です。

エントリ

ソフトウェアで扱う一つの単位となる情報です。EDMRptAclogコマンドでは，アクセスログファイルに記録されている一つ一つのアクセスログがエントリとして扱われます。EDMRptTraceコマンドでは，トレースファイルに記録されている一つ一つのトレースログがエントリとして扱われます。また，EDMRptAclogコマンド，EDMRptTraceコマンドが出力する結果の1行1行も，エントリということになります。

エントリ抽出機能

EDMRptAclogコマンド，EDMRptTraceコマンドが提供する機能の一つです。EDMRptAclogコマンドでは，抽出エントリ定義ファイルに指定されたメソッド名と引数によって，アクセスログエントリが抽出されて出力されます。EDMRptTraceコマンドでは，抽出エントリ定義ファイルに指定された処理の種別によって，トレースログエントリが抽出されて出力されます。

（カ行）

クライアントトレース（EDMRasTraceCL"PID"_"NO".log）

DocumentBrokerクライアントでのユーザプログラムによる処理内容を記録したトレースファイルです。なお，"PID"はプロセスID，"NO"は1～16の通し番号です。

クラス名セクション

プロパティ拡張情報ファイルを構成するセクションで，ClassIdエントリとPrepresentPropertiesエントリから構成されます。

（サ行）

サーバトレース（EDMRasTrace"PID"_"NO".log）

DocumentBrokerサーバでのユーザプログラムによる処理内容を記録したトレースファイルです。なお，"PID"はプロセスID，"NO"は1～16の通し番号です。

集計キー定義ファイル

EDMRptAclogコマンドの集計機能で，-kオプションを指定してキーとなる項目によって集計する場合に，キーとなる項目を指定しておくファイルです。EDMRptAclogコマンドの-kオプションで，集計キー定義ファイルのファイル名を指定します。

集計機能

EDMRptAclogコマンド，EDMRptTraceコマンドが提供する機能の一つです。EDMRptAclogコマンドでは，アクセスログファイルに残された記録（アクセスログ）が，ユーザ名およびオブジェクト名で分類・集計されて結果が出力されます。EDMRptTraceコマンドでは，トレースファイルに残された記録（トレース）が，ユーザプログラムのプログラム名，プロセスIDおよびスレッドIDで分類・集計されて結果が出力されます。

操作対象識別子

アクセスログにアクセス対象オブジェクトの情報として出力される，バージョン識別子，リレーション識別子およびリンク識別子の総称です。

操作対象識別子変換機能

EDMRptAclogコマンドが提供する機能の一つで，アクセスログ中の操作対象識別子を，ユーザが見てわかるように，アクセス対象オブジェクトのプロパティの値に置き換えます。

（タ行）

抽出エントリ定義ファイル

EDMRptAclogコマンド，EDMRptTraceコマンドのエントリ抽出機能で，-xオプションを指定してエントリを抽出する場合に，抽出するエントリのメソッド名，引数および処理の種別を指定しておくファイルです。EDMRptAclogコマンド，EDMRptTraceコマンドの-xオプションで，抽出エントリ定義ファイルのファイル名を指定します。

動作環境定義ファイル（edmrpt.ini）

統計解析ツールが動作する時に参照する情報を定義するファイルです。ユーザIDの集計方法に関する情報，およびOIID変換，操作対象識別子変換の実行に関する情報が定義されています。

トレース

トレースファイルに残されている一つ一つの記録のことで，トレースログということもあります。DocumentBrokerは，サーバおよびクライアントのプログラムの処理内容を，トレースとして記録しています。

トレース表

集計機能で利用するために，EDMRptTraceコマンドが作成する一時ファイルです。

トレースファイル（EDMRasTrace"PID"_"NO".logまたはEDMRasTraceCL"PID"_"NO".log）

DocumentBrokerサーバおよびクライアントのプログラムの処理内容の履歴（トレース）を記録したファイルです。トレースファイルには，サーバトレース（EDMRasTrace"PID"_"NO".log）と，クライアントトレース（EDMRasTraceCL"PID"_"NO".log）があります。なお，"PID"はプロセスID，"NO"は1～16の通し番号です。

トレースファイル分割機能

EDMRptTraceコマンドが提供する機能の一つです。サーバトレース解析の場合はユーザプログラムのプログラム名とユーザプログラムのプロセスIDごとに，クライアントトレース解析の場合はユーザプログラムのスレッドIDごとに，トレースファイルの内容が分割されて別々のファイルに出力されます。

（ハ行）

標準エラー出力（stderr）

コマンド実行時などにエラーが発生した場合，そのことをユーザに知らせるためにシステムが使用する標準の出力先のことです。

標準出力（stdout）

コマンドの実行結果などをユーザに知らせるために，システムが使用する標準の出力先のことです。

プロパティ拡張情報ファイル（propex.ini）

DocumentBrokerの文書モデルを構成するクラスに定義されている複数のプロパティの中から，OIID変換，操作対象識別子変換の対象となるプロパティを特定するために使用するファイルです。OIID変換，操作対象識別子変換の対象となるプロパティを指定しておきます。

EDMRptAclogコマンドは，データベース（HiRDB）からアクセス対象のオブジェクトのプロパティの値を取得して，アクセスログ中のOIID，操作対象識別子をプロパティの値（文書名など）に変換する際に，プロパティ拡張情報ファイルを参照します。

（マ行）

メッセージトレース（aclog_msg.logまたはtrace_msg.log）

EDMRptAclogコマンド，EDMRptTraceコマンドのメッセージを出力するファイルです。メッセージトレースは，環境変数「EDMARUMSG」で設定したディレクトリに出力されます。

索引

[記号]
[Ａ][Ｃ][Ｄ][Ｅ][Ｇ][Ｈ][Ｌ][Ｍ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ]
[ア行][カ行][サ行][タ行][ハ行][マ行][ヤ行][ラ行]

(記号)

［Entry0001］セクション

［Extract Aclog］セクション

［Extract Trace］セクション

［Key Object］セクション

［Key User］セクション

［ObjectConvertingMode］セクション

［UserCountingMode］セクション

(英字)

(Ａ)

arg

(Ｃ)

call

ClassIdエントリ

ClassIdエントリ

connect

connect

create

create

CSV形式

(Ｄ)

delete

delete

DOCBROKERDIR

DOCBROKERDIR

docspace.ini

docspace.ini

DocumentBrokerの実行環境作成コマンド

DocumentSpace構成定義ファイル

DocumentSpace構成定義ファイル

(Ｅ)

EDMARUMSG

EDMARUMSG

EDMARUMSG

EDMARUMSG

edmrpt.ini

EDMRptAclogコマンド

EDMRptAclogコマンド（アクセスログの解析）

EDMRptAclogコマンドに必要なファイル

EDMRptAclogコマンドの機能

EDMRptAclogコマンドの機能概要

EDMRptAclogコマンドの機能の処理方式

EDMRptAclogコマンドの集計方法

EDMRptAclogコマンドの出力形式

EDMRptAclogコマンドの出力例

EDMRptAclogコマンドの詳細

EDMRptAclogコマンドの処理概要

EDMRptAclogコマンドのトラブルシュート機能

EDMRptAclogコマンドの目的

EDMRptTraceコマンド

EDMRptTraceコマンド（トレースの解析）

EDMRptTraceコマンドに必要なファイル

EDMRptTraceコマンドの機能

EDMRptTraceコマンドの機能概要

EDMRptTraceコマンドの機能の処理方式

EDMRptTraceコマンドの集計方法

EDMRptTraceコマンドの出力形式

EDMRptTraceコマンドの出力例

EDMRptTraceコマンドの詳細

EDMRptTraceコマンドの処理概要

EDMRptTraceコマンドのトラブルシュート機能

EDMRptTraceコマンドの目的

EDMSetup

enter

enter

enterエントリ

error

error

error

exit

(Ｇ)

GUID

GUID文字列

(Ｈ)

HiRDBサーバのポート番号

HiRDBサーバのホスト名

(Ｌ)

LANG

LD

LIBPATH

LR

LV

(Ｍ)

mark

msg

msg

msgエントリ

(Ｏ)

OIID

OIID

OIID

OIID変換

OIID変換，操作対象識別子変換時のエラー処理

OIID変換機能

OIID変換機能

OIID変換機能

OIID変換機能，操作対象識別子変換機能（-cオプション指定）の出力形式

OIID変換機能，操作対象識別子変換機能の処理方式

OIID変換機能の処理の流れ

(Ｐ)

PATH

PdHostエントリ

PdHostエントリ

PdNamePortエントリ

PdNamePortエントリ

PdUserエントリ

PdUserエントリ

PrepresentPropertiesエントリ

PrepresentPropertiesエントリ

PrepresentPropertiesエントリ

propex.ini

propex.ini

(Ｒ)

refer

refer

return

RL

(Ｓ)

search

search

stderr

stdout

SUBTOTAL

SUBTOTAL

syslogファイル

syslogファイル

(Ｔ)

TOTAL

TOTAL

TZ

TZ

(Ｕ)

update

update

(Ｖ)

VD

(Ｗ)

warn

(ア行)

(あ)

アクセス種別

アクセス種別とその意味

アクセスの内容

アクセスログ

アクセスログ

アクセスログの項目

アクセスログの出力形式

アクセスログ表

アクセスログ表

アクセスログ表

アクセスログ表作成時の処理方式

アクセスログ表の項目

アクセスログ表の例

アクセスログファイル

アクセスログファイル

アクセスログファイル

アクセスログファイル格納ディレクトリ

アクセスログファイル格納ディレクトリ

アクセスログファイル格納ディレクトリ

アクセスログファイルのコピー

アクセスログファイルの出力例

アクセスログファイル名

(い)

イベントログ

イベントログ

(え)

エントリ

エントリ抽出機能

エントリ抽出機能

エントリ抽出機能

エントリ抽出機能の出力形式

エントリ抽出機能の出力形式

エントリ抽出機能の処理方式

エントリ抽出機能の処理方式

(お)

オブジェクト変換モード

オブジェクト名

オプションの指定の組み合わせ（EDMRptAclogコマンド）

オプションの指定の組み合わせ（EDMRptTraceコマンド）

(カ行)

(か)

環境変数の設定（AIXの場合）

環境変数の設定（Windowsの場合）

(き)

共通情報

共通情報

共通情報

(く)

クライアントトレース

クライアントトレース

クライアントトレース解析

クライアントトレース格納ディレクトリ

クライアントトレース格納ディレクトリ

クライアントトレース格納ディレクトリ

クライアントトレースの出力例

クラス定義情報ファイル

クラス名セクション

(こ)

コマンドの記述形式

コマンドの実行に必要なファイル

コマンド引数

コマンド引数

コマンドリファレンス

(サ行)

(さ)

サーバトレース

サーバトレース

サーバトレース解析

サーバトレース格納ディレクトリ

サーバトレース格納ディレクトリ

サーバトレース格納ディレクトリ

サーバトレースの出力例

(し)

実行環境設定の流れ

実行環境の設定

集計キー定義ファイル

集計キー定義ファイル

集計キー定義ファイル

集計キー定義ファイルで指定された項目別の集計対象

集計キー定義ファイルと抽出エントリ定義ファイルを一つのファイルに記述する場合の記述規則

集計キー定義ファイルの記述規則

集計キー定義ファイルの記述形式

集計キー定義ファイルの記述例

集計キー定義ファイル名

集計機能

集計機能

集計機能

集計機能で分類されるアクセスの内容と集計項目

集計機能の出力形式

集計機能の出力形式

集計機能の処理方式

集計機能の処理方式

集計結果

集計結果

集計項目

集計項目

集計項目

集計項目

集計項目

集計項目

集計項目

集計項目

終了コード一覧

出力ファイル名

出力ファイル名

(そ)

操作対象識別子

操作対象識別子

操作対象識別子変換機能

操作対象識別子変換機能

操作対象識別子変換機能

操作対象識別子変換機能の処理の流れ

(タ行)

(ち)

抽出エントリ定義ファイル

抽出エントリ定義ファイル

抽出エントリ定義ファイル

抽出エントリ定義ファイル

抽出エントリ定義ファイルの記述規則

抽出エントリ定義ファイルの記述形式

抽出エントリ定義ファイルの記述例

抽出エントリ定義ファイル名

抽出エントリ定義ファイル名

(て)

ディレクトリ名

ディレクトリ名

(と)

統計解析ツールが提供するコマンドの一覧

統計解析ツールとは

統計解析ツールの機能概要

統計解析ツールの実行環境

統計解析ツールの処理概要

統計解析ツールのディレクトリ構成（UNIXの場合）

統計解析ツールのディレクトリ構成（Windowsの場合）

動作環境定義ファイル

動作環境定義ファイル

動作環境定義ファイル

動作環境定義ファイルの記述規則

動作環境定義ファイルの記述形式

動作環境定義ファイルの記述例

トラブルシュート機能

トレース

トレース表

トレース表

トレース表

トレース表の項目

トレース表の例

トレースファイル

トレースファイル

トレースファイル

トレースファイルのコピー

トレースファイルの出力例

トレースファイル分割機能

トレースファイル分割機能

トレースファイル分割機能の出力形式

トレースファイル分割機能の処理方式

トレースファイル名

トレースログ

トレースログの項目

トレースログの出力形式

(ハ行)

(は)

バージョン識別子

バージョン識別子

パスワード

(ひ)

標準エラー出力

標準出力

(ふ)

プロパティ拡張情報ファイル

プロパティ拡張情報ファイル

プロパティ拡張情報ファイル

プロパティ拡張情報ファイル

プロパティ拡張情報ファイルの記述規則

プロパティ拡張情報ファイルの記述形式

プロパティ拡張情報ファイルの記述例

分類項目

分類項目

分類項目

(マ行)

(め)

メソッド名と引数

メッセージトレース

メッセージトレース

メッセージトレース

メッセージトレースを出力する

メッセージトレースを出力する

メッセージの出力先

メッセージの出力先

(ヤ行)

(ゆ)

ユーザ名

ユーザ名

ユーザ名集計モード

(ラ行)

(り)

リレーション識別子

リレーション識別子

リンク識別子

リンク識別子

リンク識別子

リンク識別子

■ 商標類

AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OLEは，米国Microsoft Corporationが開発したソフトウェア名称です。
TIFFは，米国Aldus Corp.が開発したフォーマットの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
活文，PDFstaffは，株式会社日立ソリューションズの登録商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。