DocumentBrokerのクライアントライブラリを起動するために必要な次の環境変数を指定してください。

• LANG
  環境変数「LANG」には，使用する文字コードセットを設定します。DocumentBrokerの文書空間で使用する文字コード種別に合わせて値を設定してください。
  

  文書空間で使用する文字コード種別がShift-JISの場合

  設定する値は「Ja_JP」です。

  文書空間で使用する文字コード種別がUTF-8の場合

  使用する言語に合わせて適切な値を設定してください。

  ただし，次のときは「C」を設定してください。
  
  • 文書空間で使用する文字コード種別に関係なく，ASCIIコードのデータだけを扱う英語環境の場合
  • 一つのアプリケーションから文字コード種別の異なる複数の文書空間に接続する場合に，接続先に文字コード種別がUTF-8の文書空間が含まれるとき
  なお，この環境変数に設定する値によって，メッセージの言語種別が変わります。「Ja_JP」を設定した場合は，日本語のメッセージが出力されます。「Ja_JP」以外を設定した場合は，英語のメッセージが出力されます。　
  
• TZ
  環境変数「TZ」には，マシン時間のタイムゾーンを設定します。設定する値は「JST-9」です。
  
• XDK_HOME
  環境変数「XDK_HOME」には，SystemManagerオブジェクトのレジストリファイルのロケーションを設定します。指定する値は「/opt/HiEDMS/client/etc」です。
  
• LIBPATH
  環境変数「LIBPATH」には，DocumentBrokerのクライアントライブラリのインストールディレクトリを指定します。次の値を追加してください。
  

  TPBroker V3を使用している場合

  :/opt/hitachi/common/lib
  :/usr/vacpp/lib※1
  :/opt/TPBroker/lib
  :/opt/HiEDMS/client/lib
  :/opt/HiEDMS/ACLibrary/lib
  :/opt/hirdb_xml/lib※2
  :/opt/hitachi/xpk/lib※2

  TPBroker V5を使用している場合

  :/opt/hitachi/common/lib
  :/usr/vacpp/lib※1
  :TPBroker V5インストールディレクトリ/lib
  :/opt/HiEDMS/client/lib_tp5
  :/opt/HiEDMS/ACLibrary/lib_tp5
  :/opt/hirdb_xml/lib※2
  :/opt/hitachi/xpk/lib※2

  注※1　VisualAge C++ Professional for AIXまたはIBM XL C/C++ Enterprise Edition for AIXのライブラリの格納ディレクトリを設定します。これは，デフォルトのインストールディレクトリにインストールされている場合の値です。
  注※2　XML文書管理機能（XMLプロパティマッピング機能・XMLインデクスデータ作成機能）を使用する場合に設定します。
  
• PSALLOC
  環境変数「PSALLOC」には，次の値を設定します。
  

  early

• NODISCLAIM
  環境変数「NODISCLAIM」には，次の値を設定します。
  

  true

• DBR_CONNECTSV_ENVID
  環境変数「DBR_CONNECTSV_ENVID」には，接続先の実行環境識別子を設定します。同一文書空間に実行環境が複数作成されていて，それらが同時に稼働しているサーバに接続する場合に，クライアントで接続先を選択するときに設定します。
  設定できる値は，「0〜254」です。
  同一文書空間の実行環境として複数のサーバが存在している場合に，この環境変数を設定しないときは，クライアントで接続するサーバを選択しません。設定できる値以外を指定した場合は，設定されていないものとして動作します。
  接続先の実行環境識別子をCdbrSession::Connectメソッドの引数に指定することもできます。引数で指定する場合については，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　リファレンス　基本機能編」を参照してください。
  CdbrSession::Connectメソッドの引数の指定と，この環境変数の関係は，次のようになります。
  

  表5-1　CdbrSession::Connectメソッドの引数の指定と，環境変数「DBR_CONNECTSV_ENVID」の関係（AIXの場合）

  環境変数		CdbrSession::Connectメソッドへの引数
  		指定あり		指定なし
  		0〜254	範囲外
  指定あり	0〜254	引数で指定した実行環境識別子のサーバに接続	環境変数で指定した実行環境識別子のサーバに接続	環境変数で指定した実行環境識別子のサーバに接続
  	範囲外	引数で指定した実行環境識別子のサーバに接続	接続するサーバを選択しない	接続するサーバを選択しない
  指定なし		引数で指定した実行環境識別子のサーバに接続	接続するサーバを選択しない	接続するサーバを選択しない

  クライアントで接続先を選択する場合は，接続先のDocumentSpace構成定義ファイルのSelectServerInMultiServerエントリにYesを指定して起動しておく必要があります。
  
• DBR_CON_TIMEOUT
  環境変数「DBR_CON_TIMEOUT」には，サーバへの接続要求に対するクライアントでの接続確立待ち時間（秒）を設定します。
  設定できる値は，「0〜2,147,483,647」です。
  0を設定した場合，TCP/IPで固有のサーバへの接続確立待ち時間（秒）が設定されます。
  範囲外の値を設定した場合は，0が仮定されます。
  
• DBR_FLINK_CONTENT_DELETE
  環境変数「DBR_FLINK_CONTENT_DELETE」には，File Link連携機能を使用して管理している文書のコンテントをRemoveObjectメソッドまたはDeleteRenditionメソッドによって削除する場合に，ファイルサーバ上のファイルの実体を削除することを指定します。次の値を指定します。
  

  ON

• DBR_DETAIL_ERRORLOG
  環境変数「DBR_DETAIL_ERRORLOG」は，詳細メッセージを取得する場合に指定します。詳細メッセージを取得する場合には，次の値を指定してください。
  

  ON

• DBR_DETAIL_ERRORLOG_DIR
  環境変数「DBR_DETAIL_ERRORLOG_DIR」には，詳細メッセージを取得する場合に，詳細エラーログファイルを出力するためのパス名を指定します。なお，文書空間で使用する文字コード種別がUTF-8の場合，印刷可能なASCIIコードで記述できる値を設定してください。詳細エラーログファイルは，指定したパス名のディレクトリ下に，次のファイル名で出力されます。
  

  EDMErrTraceCLXXXXX_1.log
  （XXXXXはプロセスID番号）

  詳細エラーログファイルにはエラーが発生していない場合もログが出力されますので，必要に応じて詳細エラーログファイルを削除するようにしてください。
  詳細エラーログファイルに出力される内容については，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。なお，指定を省略した場合，環境変数「DBR_DETAIL_ERRORLOG」にONを指定していても，詳細エラーログファイルは出力されません。
  
• DBR_DETAIL_ERRORLOG_NUM
  環境変数「DBR_DETAIL_ERRORLOG_NUM」には，詳細メッセージを取得する場合に使用する，ラップアラウンドする詳細エラーログファイルの個数を指定します。2,147,483,647以下の値を指定してください。省略した場合の仮定値は2です。また，2未満の値を指定した場合も，2が仮定されます。
  
• DBR_DETAIL_ERRORLOG_SIZE
  環境変数「DBR_DETAIL_ERRORLOG_SIZE」には，詳細メッセージを取得する場合に使用する詳細エラーログファイルの容量の上限値（バイト）を指定します。2,147,483,647以下の値を指定してください。省略した場合の仮定値は10,000です。
  0以下の値を設定した場合，または1回の出力データ量よりも小さい値を指定した場合には，詳細メッセージは出力されません。
  

環境変数の値と詳細エラーログファイルのラップアラウンド処理

1プロセスで長時間に及ぶ処理を実行する場合，出力される詳細エラーログファイルの容量が過剰に大きくなる可能性があります。

詳細エラーログファイルが必要以上の容量に増加するのを防ぐため，詳細エラーログファイルはラップアラウンド処理されます。詳細エラーログファイルの容量が環境変数で指定した最大容量になった場合，ラップアラウンド処理されて，詳細メッセージのログは最初の詳細エラーログファイルに出力されます。

最大容量とは，次の値です。

（詳細エラーログファイルのサイズ（DBR_DETAIL_ERROR_SIZEの指定値））×（詳細エラーログファイルの個数（DBR_DETAIL_ERROR_NUMの指定値））

この場合の詳細エラーログファイルの出力処理は，次のようになります。

1. 環境変数「DBR_DETAIL_ERRORLOG_DIR」に指定したディレクトリに，次の名称で詳細エラーログファイルが作成されます。（XXXXXXはプロセスID，Nはプロセス内のファイル番号）
   EDMErrTraceClXXXXXX_N.log
   
2. ファイルの容量が環境変数「DBR_DETAIL_ERROR_SIZE」で指定した容量になったら，次の詳細エラーログファイルが作成されます。
3. 環境変数「DBR_DETAIL_ERRORLOG_NUM」に指定した個数のファイルがすべて最大容量になったら，ラップアラウンドして再び先頭のファイルにログが出力されます。

また，edmSQL構文解析情報ファイルを出力する場合は，次の環境変数の設定が必要です。

• DBR_EQL_PARSELOG
• DBR_EQL_PARSELOG_DIR

これらの環境変数の詳細は，「4.7.3(1)edmSQL構文解析情報ファイル」を参照してください。

DocumentBrokerのクライアントライブラリを起動するために必要な次の環境変数を指定してください。

• DBR_CONNECTSV_ENVID
  環境変数「DBR_CONNECTSV_ENVID」には，接続先の実行環境識別子を設定します。同一文書空間に実行環境が複数作成されていて，それらが同時に稼働しているサーバに接続する場合に，クライアントで接続先を選択するときに設定します。
  設定できる値は，「0〜254」です。
  同一文書空間の実行環境として複数のサーバが存在している場合に，この環境変数を設定しないときは，クライアントで接続するサーバを選択しません。設定できる値以外を指定した場合は，設定されていないものとして動作します。
  接続先の実行環境識別子をCdbrSession::Connectメソッドの引数に指定することもできます。引数で指定する場合については，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　リファレンス　基本機能編」を参照してください。
  CdbrSession::Connectメソッドの引数の指定と，この環境変数の関係は，次のようになります。
  

  表5-2　CdbrSession::Connectメソッドの引数の指定と，環境変数「DBR_CONNECTSV_ENVID」の関係（Windowsの場合）

  環境変数		CdbrSession::Connectメソッドへの引数
  		指定あり		指定なし
  		0〜254	範囲外
  指定あり	0〜254	引数で指定した実行環境識別子のサーバに接続	環境変数で指定した実行環境識別子のサーバに接続	環境変数で指定した実行環境識別子のサーバに接続
  	範囲外	引数で指定した実行環境識別子のサーバに接続	接続するサーバを選択しない	接続するサーバを選択しない
  指定なし		引数で指定した実行環境識別子のサーバに接続	接続するサーバを選択しない	接続するサーバを選択しない

  クライアントで接続先を選択する場合は，接続先のDocumentSpace構成定義ファイルのSelectServerInMultiServerエントリにYesを指定して起動しておく必要があります。
  
• DBR_CON_TIMEOUT
  環境変数「DBR_CON_TIMEOUT」には，サーバへの接続要求に対するクライアントでの接続確立待ち時間（秒）を設定します。
  設定できる値は，「0〜2,147,483,647」です。
  0を設定した場合，TCP/IPで固有のサーバへの接続確立待ち時間（秒）が設定されます。
  範囲外の値を設定した場合は，0が仮定されます。
  既に一度接続したクライアントからサーバへの接続要求でタイムアウトが発生した場合，CdbrSession::Connectメソッドで，次のエラーが返却されます。
  major_code：ERR_DMA　minor_code：DMARC_NETWORK_UNAVAILABLE
  TPBroker V3と連携して動作する環境の場合，エラーが返却されず，正常に接続できる場合があります。
  
• DBR_FLINK_CONTENT_DELETE
  環境変数「DBR_FLINK_CONTENT_DELETE」には，File Link連携機能を使用して管理している文書のコンテントをRemoveObjectメソッドまたはDeleteRenditionメソッドによって削除する場合に，ファイルサーバ上のファイルの実体を削除することを指定します。次の値を指定します。
  

  ON

• DBR_DETAIL_ERRORLOG
  環境変数「DBR_DETAIL_ERRORLOG」は，詳細メッセージを取得する場合に指定します。詳細メッセージを取得する場合には，次の値を指定してください。
  

  ON

• DBR_DETAIL_ERRORLOG_DIR
  環境変数「DBR_DETAIL_ERRORLOG_DIR」には，詳細メッセージを取得する場合に，詳細エラーログファイルを出力するためのパス名を指定します。なお，文書空間で使用する文字コード種別がUTF-8の場合，印刷可能なASCIIコードで記述できる値を設定してください。詳細エラーログファイルは，指定したパス名のディレクトリ下に，次のファイル名で出力されます。
  

  EDMErrTraceCLXXXXX_1.log
  （XXXXXはプロセスID番号）

  詳細エラーログファイルにはエラーが発生していない場合もログが出力されますので，必要に応じて詳細エラーログファイルを削除するようにしてください。
  詳細エラーログファイルに出力される内容については，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。なお，指定を省略した場合，環境変数「DBR_DETAIL_ERRORLOG」にONを指定していても，詳細エラーログファイルは出力されません。
  
• DBR_DETAIL_ERRORLOG_NUM
  環境変数「DBR_DETAIL_ERRORLOG_NUM」には，詳細メッセージを取得する場合に使用する，ラップアラウンドする詳細エラーログファイルの個数を指定します。2,147,483,647以下の値を指定してください。省略した場合の仮定値は2です。また，2未満の値を指定した場合も，2が仮定されます。
  
• DBR_DETAIL_ERRORLOG_SIZE
  環境変数「DBR_DETAIL_ERRORLOG_SIZE」には，詳細メッセージを取得する場合に使用する詳細エラーログファイルの容量の上限値（バイト）を指定します。2,147,483,647以下の値を指定してください。省略した場合の仮定値は10,000です。
  0以下の値を設定した場合，または1回の出力データ量よりも小さい値を指定した場合には，詳細メッセージは出力されません。
  環境変数の値と詳細エラーログファイルのラップアラウンド処理の関係については，「(1)環境変数（AIXの場合）」を参照してください。
  また，edmSQL構文解析情報ファイルを出力する場合は，次の環境変数の設定が必要です。
  
• DBR_EQL_PARSELOG
• DBR_EQL_PARSELOG_DIR
  これらの環境変数の詳細は，「4.7.3(1)edmSQL構文解析情報ファイル」を参照してください。
  

カレントディレクトリは，クライアントアプリケーションが格納されているディレクトリから移動しないでください。