uCosminexus DocumentBroker Version 3 クラスライブラリ C++ リファレンス 基本機能編
![[目次]](figure/content.gif)
![[用語]](figure/gloss.gif)
![[索引]](figure/index.gif)
![[前へ]](figure/front.gif)
(1) 詳細メッセージの出力先
詳細メッセージの出力先は,次のとおりです。なお,詳細メッセージの内容については,マニュアル「DocumentBroker Version 3 メッセージ」を参照してください。
- 詳細エラーログファイル
クライアント環境変数DBR_DETAIL_ERRORLOGがONのとき,DBR_DETAIL_ERRORLOG_DIRで指定されたディレクトリの下に「EDMErrTraceCLXXXXX_1.log」として出力されます。XXXXはプロセスID番号を示します。詳細エラーログファイルには,エラーが発生しないときでもログが出力されますので,必要に応じて詳細エラーログファイルを削除するようにしてください。
クライアント環境変数については,マニュアル「DocumentBroker Version 3 クラスライブラリ C++ 解説」の「5. 環境設定」を参照してください。
- CdbrSession::GetLastDetailErrorメソッドの引数
詳細メッセージは,それを取得するためのメソッドであるCdbrSession::GetLastDetailErrorメソッドをコールした場合に,引数の値として出力されます。
このメソッドは,クラスライブラリのメソッドのコール時にエラーが発生した場合に,CdbrCore::GetLastErrorメソッドでmajor_code,minor_codeを取得した後で必要に応じてコールします。メソッドの詳細については,「13. CdbrSessionクラス(セッションを確立するクラス)」のCdbrSession::GetLastDetailErrorメソッドを参照してください。
(2) 詳細メッセージ取得の対象メソッド,取得できる条件および注意事項
(a) 詳細メッセージを取得できる対象メソッド
次に示すクラスのメソッドがエラーリターンした場合に, CdbrSession::GetLastDetailErrorメソッドで詳細メッセージを取得できます。
| クラス名 |
メソッド名 |
| CdbrConfiguratedReferentialContainer |
- CreateObject
- GetLinkPropertyValues
- GetLinkPropertyValuesAndLock
- PutLinkPropertyValues
|
| CdbrDocument |
CreateObject |
| CdbrEqlStatement |
- ChangeACLMode
- ChangeGetObjCount
- ChangeLockType
- DeleteResult
- Execute
- GetACLMode
- GetResult
- Initialize
- Set
- SetObjParam
- SetOIIDParam
- SetParam
- Terminate
|
| CdbrIndependentPersistence |
CreateObject |
| CdbrPublicACL |
CreateObject |
| CdbrReferentialContainer |
- CreateObject
- GetLinkPropertyValues
- GetLinkPropertyValuesAndLock
- PutLinkPropertyValues
|
| CdbrVersionableDocument |
CreateObject |
| CdbrVersionTraceableContainer |
CreateObject |
(b) 詳細メッセージを取得できる条件
CdbrSession::GetLastDetailErrorメソッドは,取得するメッセージがない場合,引数ppDetailErrorMessageの指すポインタの値がNULLになります。引数ppDetailErrorMessageの指すポインタの値がNULL以外の場合に詳細メッセージを取得できます。
詳細メッセージの取得についての注意事項を次に示します。
- すべてのエラーに対して,詳細メッセージとしてKMBR20000-Eが出力されます。
- クライアントで検知した引数不正に対しても詳細メッセージとしてKMBR26000-Eが出力されます。
クライアントで検知する引数不正には,次のような場合があります。
- NULL値を指定できないポインタ引数に対してNULL値が設定された場合
なお,この引数不正が発生した場合でも,次に示すメソッドに関しては詳細メッセージを取得できません。
ConnectObjectメソッド
CreateObjectメソッド
SetOIIDメソッド
Initializeメソッド
- アクセス権を操作するメソッドのエラー時およびアクセス権エラー時に詳細メッセージは取得できません。
All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi Solutions, Ltd.