DABroker管理ユティリティの機能，操作できるユーザ，各機能を使用する場合の操作手順について説明します。

(a)　機能

DABroker管理ユティリティには次の二つの機能があります。

DABrokerの動作状態の表示

各HITSENSER5との接続時間，及び予約処理の状態を表示します。操作手順については「(c)　DABrokerの動作状態を表示する操作手順」を参照してください。

HITSENSER5の処理の中断

指定したHITSENSER5との接続を解放し，実行中の処理を中断します。このとき，DABrokerはリレーショナルデータベースに要求した処理のロールバックを要求します。また，そのHITSENSER5が要求した予約処理をすべて取り消します。操作手順については「(d)　HITSENSER5の処理を中断する操作手順」を参照してください。

(b)　操作できるユーザ

すべてのユーザが管理ユティリティを実行できます。ただし，特定のクライアントの処理を中断できるのは，WindowsのAdministratorsグループに属するユーザだけです。

(c)　DABrokerの動作状態を表示する操作手順

DABrokerの動作状態を表示する手順を次に示します。

1. DABrokerが起動していることを確認する
2. プログラムフォルダに登録された［DABroker］から［DABroker管理］を選択する
   DABroker管理ユティリティが起動し，［DABroker管理］ダイアログに動作状態が表示されます。をクリックすると，最新の動作状態に表示が更新されます。
   

   図A-4　［DABroker管理］ダイアログ

   

   ［DABroker管理］ダイアログに表示される項目の意味は次のとおりです。
   

   識別子

   DABrokerに接続されているクライアント処理を識別するための番号です。

   IPアドレス

   接続しているHITSENSER5があるマシンのIPアドレス。

   接続時刻

   HITSENSER5と接続した日時（年／月／日 時：分：秒）。

   接続時間

   接続してからの経過時間（時：分：秒）。

   予約

   実行中の予約処理数（HITSENSER5では使用しません）。

   状態

   HITSENSER5との接続状態。

   「接続中」と表示されている場合は，HITSENSER5とのコネクションが確立されていることを示します。

   ホスト名

   接続しているHITSENSER5があるマシンのホスト名。

   次の条件をすべて満たしている場合に表示されます。

   • 「図A-3　［リモートアクセス設定］タブの設定内容」で「IPアドレスからホスト名へ変換する」をチェックしている
   • 次のフォルダのhostsファイルに各クライアントのホスト名を登録している場合
     ［Windowsインストール先フォルダ］\SYSTEM32\DRIVERS\ETC
     
   なお，ホスト名の長さによっては，途中までしか表示されない場合があります。
   
3. DABrokerの動作状態の確認が済んだら，［DABroker管理］ダイアログを閉じ，DABroker管理ユティリティを終了させてください。

(d)　HITSENSER5の処理を中断する操作手順

特定のHITSENSER5の処理を中断する手順を次に示します。

1. DABrokerが起動していることを確認する
2. プログラムフォルダに登録された［DABroker］から［DABroker管理］を選択する
   DABroker管理ユティリティが起動し，［DABroker管理］ダイアログに動作状態が表示されます。
   
3. ［DABroker管理］ダイアログで処理を中断するHITSENSER5を選択し，をクリックする
   確認のダイアログが表示されます。
   
4. ［はい］を選択する
   DABrokerは選択したクライアントとのコネクションを解放します。同時にリレーショナルデータベースに処理のロールバックを要求して，そのクライアントが要求したすべての予約処理を取り消します。
   

DABrokerトレース出力ユティリティの機能，操作できるユーザ，各機能を使用する場合の操作手順について説明します。

(a)　機能

DABrokerトレース出力ユティリティでは，次の２種類のトレースを出力できます。

通信トレース

通信トレースとは，DABrokerとHITSENSER5間のデータの送受信についての情報です。DABrokerがこの情報を取得するのは，クライアントからの要求受付直後，及びDABrokerからの結果送信直後です。通信トレースは，［DABroker運用ディレクトリ］\spool\dabcltrcの下に出力されます。

アクセストレース

アクセストレースとは，DABrokerがリレーショナルデータベースに要求した処理，及びその処理に対するリレーショナルデータベースからの応答についての情報です。DABrokerがこの情報を出力するのは，リレーショナルデータベースに要求を出す直前及びリレーショナルデータベースから応答が返ってきた直後です。リレーショナルデータベースとのアクセストレースは，［DABroker運用ディレクトリ］\spool\db_accessの下に出力されます。

(b)　操作できるユーザ

すべてのユーザがDABrokerトレース出力ユティリティを実行できます。

(c)　トレースを出力する操作手順

通信トレース，及びリレーショナルデータベースとのアクセストレースを出力する操作手順を，次に示します。

1. DABrokerが起動していることを確認する
2. プログラムフォルダに登録された［DABroker］から［トレース出力］を選択する
   DABrokerトレース出力ユティリティが起動し，［DABrokerトレース出力］ダイアログが表示されます。
   

   図A-5　［DABrokerトレース出力］ダイアログ

   

   • 通信トレースを出力する場合の操作
     １．［通信トレースを出力する］チェックボックスをチェックする
     ２．［IPアドレスまたはホスト名］を設定する
     すべての通信トレースを出力する場合は，［IPアドレスまたはホスト名］に何も指定しないでください。特定のIPアドレス又はホスト名の通信トレースを出力する場合，［IPアドレスまたはホスト名］に，通信トレースを出力するIPアドレス又はホスト名を指定してください。
     ３．通信トレースの出力先を指定する
     ［出力先］ボタンをクリックすると，出力先を指定するダイアログが表示されます。出力先のファイル名を指定してください。省略した場合は，［DABroker運用ディレクトリ］\spool\DABTT.TXTに出力されます。
     
   • アクセストレースを出力する場合の操作
     １．［アクセストレースを出力する］チェックボックスをチェックする
     ２．［UAP名］，［ユーザID］を設定する
     どの範囲のアクセストレースを出力するかによって，設定内容が異なります。場合ごとに必要な設定内容を表A-2に示します。
     

     表A-2　アクセストレース出力時の設定内容

     出力するアクセストレースの範囲	［UAP名］※１	［ユーザID］※２
     すべてのアクセストレースを出力する場合	−	−
     特定のHITSENSER5のアクセストレースを出力する場合	○	−
     特定のユーザIDのアクセストレースを出力する場合	−	○
     特定のHITSENSER5の特定のユーザIDのアクセストレースを出力する場合	○	○

     （凡例）○：指定する項目　　−：指定しない項目

     
     

   注※１　［UAP名］

   「HS5」+「HITSENSER5ユーザID」を指定します。例えば，HITSENSER5ユーザIDが「LOGINUSRID」の場合，UAP名には「HS5LOGINUSRID」と指定します。

   注※２　［ユーザID］

   リレーショナルデータベースへログインするためのユーザIDを指定します。

   ３．アクセストレースの出力先を指定する
   ［出力先］ボタンをクリックすると，出力先を指定するダイアログが表示されます。出力先のファイル名を指定してください。省略した場合は，［DABroker運用ディレクトリ］\spool\DABDT.TXTに出力されます。
   
3. 「通信トレースを出力する場合の操作」，「アクセストレースを出力する場合の操作」が済んだら，［実行］ボタンを選択する
   指定した出力先が登録されます。
   なお，「通信トレースを出力する場合の操作」及び「アクセストレースを出力する場合の操作」の両方をすると，２種類のトレースが出力できます。
   

(d)　トレースの出力例

通信トレース及びアクセストレースの出力例と，出力される項目の意味について説明します。

• 通信トレースの場合
  

  図A-6　通信トレースの出力例

  

  IPADDR=XXXXXXXX

  HITSENSER5のあるマシンのIPアドレス又はホスト名。

  PROT=XXX

  通信プロトコル。TCP：TCP/IP。

  PAP-NAME=XXXXXX

  「HS5」+「HITSENSER5ユーザID」

  DATE

  送受信の発生日付（年／月／日）。

  TIME

  送受信の発生時刻（時:分:秒.n）。nは100分の１秒を表します。

  EVT

  DABrokerでの事象区分。

  • PUT：リレーショナルデータベースからHITSENSER5への送信
  • GET：HITSENSER5からリレーショナルデータベースへの受信

  SIZE

  送受信データ長（単位：バイト）。

  DATA

  送受信データ種別。

  aa…aa <bb…bb>（cc…cc,dd…dd）の形式で出力されます。

  • aa…aa：オペレーション種別。^※
  • bb…bb：付加情報。オペレーション種別が，LIST（xxxxx）及びEXT-CMDの場合に表示されます。
  • cc…cc：リターンコード。
  • dd…dd：詳細コード。
  注※　表示されるオペレーション種別の意味を，表A-3に示します。
  

  表A-3　オペレーション種別の意味

  オペレーション種別	意味
  Connect（Database）	データベースとの接続要求
  Disconnect（Database）	データベースとの切り離し要求
  Disconnect（Connection）	コネクションの解放要求
  Commit	トランザクションのコミット要求
  Rollback	トランザクションのロールバック要求
  LIST（Table）	表一覧取得要求
  LIST（Column）	列一覧取得要求
  LIST（Index）	索引一覧取得要求
  LIST（Table Privileges）	表権限一覧取得要求
  LIST（Column Privileges）	列権限一覧取得要求
  LIST（Inquiry）	予約完了状況一覧取得要求
  EXT-CMD	SQL文の実行要求
  SQL Fetch Option	SQL実行オプション実行
  File Delete	SQL実行結果格納ファイル削除
  Save	データベースへの表の保存要求
  Reserve	予約処理要求
  Reserve Delete	予約処理結果の削除要求
  Agent（Register）	エージェントの登録要求
  Agent（Delete Registration）	エージェントの削除要求
  Agent（List Prepare Registration）	エージェントの登録情報の取得準備要求
  Agent（List Fetch Registration）	エージェントの登録情報の取得継続要求
  Agent（List Close Registration）	エージェントの登録情報取得後の処理要求
  Agent（Execute）	エージェントの実行要求
  Agent（List Prepare Execution）	エージェントの実行状況の取得準備要求
  Agent（List Fetch Execution）	エージェントの実行状況の取得継続要求
  Agent（List Close Execution）	エージェントの実行状況取得後の処理要求
  Agent（Get Prepare Result）	エージェント実行結果の取得準備要求
  Agent（Get Fetch Result）	エージェント実行結果の取得継続要求
  Agent（Get Close Result）	エージェント実行結果の取得後の処理要求
  Agent（Delete Result）	エージェントの実行結果の削除要求
  Agent（Option）	エージェントのオプション実行要求
  Agent（Execute Direct Prepare）	エージェントの即時配信実行準備要求
  Agent（Execute Direct Fetch）	エージェントの即時配信実行継続要求
  Agent（Execute Direct Close）	エージェントの即時配信実行後処理要求
  Cancel	リレーショナルデータベースに対する処理の中断要求
  Illegal Request	不正要求
  Connection	コネクション確立応答
  Result	正常応答
  Error	異常応答
  Result（Cancel）	正常応答（リレーショナルデータベースに対する処理の中断要求時）
  Error（Cancel）	異常応答（リレーショナルデータベースに対する処理の中断要求時）
  Procedure(List Prepare Procedure)	ストアドプロシジャ一覧取得準備要求
  Procedure(List Fetch Procedure)	ストアドプロシジャ一覧取得要求
  Procedure(List Close Procedure)	ストアドプロシジャ一覧取得後の処理要求
  Procedure(List Prepare Column)	ストアドプロシジャ列一覧取得準備要求
  Procedure(List Fetch Column)	ストアドプロシジャ列一覧取得要求
  Procedure(List Close Column)	ストアドプロシジャ列一覧取得後の処理要求
  Procedure(Parameter Get)	ストアドプロシジャ定義情報取得要求
  Procedure(Prepare)	ストアドプロシジャ実行準備要求
  Procedure(Execute)	ストアドプロシジャ実行要求

  注意

  クライアントからの要求量が多いほど，クライアントとの通信トレースのファイル容量も多くなります。通信トレースのファイル容量の目安として，概算式を次に示します。

  通信トレースのファイル容量（単位：バイト）＝

  80（ヘッダ情報長） + クライアントからの要求数 * 2 （PUT及び

  GET分） * 36（PUT及びGET情報長）

  あらかじめ，この概算式で計算したサイズ以上のハードディスク容量を用意しておいてください。また，クライアントからの要求量が多いほど，トレース出力が終わるまで時間がかかります。御注意ください。

• アクセストレースの場合
  

  図A-7　アクセストレースの出力例

  

  UID=XXXXXXXX

  ユーザID。

  PAPNAME=XXXXXXX

  アプリケーションを識別するための文字列が表示されます。表示される文字列は，［UAP名］で指定できる名称です。

  DBNAME=XXXXXXX

  接続先データベース名。次のどれかが出力されます。

  • HiRDB：HiRDB Version 4.0，HiRDB Version 5.0，HiRDB Version 6，又はHiRDB Version 7の場合です。
  • Oracle7：Oracle7，Oracle8，Oracle8i，Oracle9i又はOracle 10gの場合です。
  • ODBC3.0：Microsoft SQL Serverの場合です。

  DATE

  アクセスの発生日（年／月／日）。

  TIME

  アクセスの発生時刻（時:分:秒.n）。nは100分の１秒を表します。

  EVT

  DABrokerがデータベースに要求した処理の内容。EVTの表示と対応する処理内容を，表A-4に示します。

  表A-4　EVTの表示と処理内容

  EVTの表示	処理内容
  CONNECT	データベースと接続します。
  PREPARE	SQLの前処理をします。
  DESCRIBE	前処理したSQLの情報を返します。
  DECLARE	前処理したSELECTに対してカーソルを宣言します。
  OPEN	カーソルを位置づけます。
  FETCH	行を読み込んでカーソルを進めます。
  CLOSE	カーソルを閉じます。
  EXECUTE	前処理したSQLを実行します。
  COMMIT	トランザクションを正常終了，更新を有効にします。
  ROLLBACK	トランザクションを取り消し，更新を無効にします。
  DISCONNECT	トランザクションを正常終了，切り離します。
  CANCEL	リレーショナルデータベースに対し，処理の中断します。
  LOGGING	リレーショナルデータベースに対し，ログ取得要求します。 ただし，HiRDBの場合だけです。
  LOGLESS	リレーショナルデータベースに対し，ログレス要求します。 ただし，HiRDBの場合だけです。

  データベースとのアクセストレースの取得内容は任意に選択できます。環境設定ユティリティの［アクセストレースの種類］で選択します。

  RETCODE

  DABrokerが要求した処理に対して，リレーショナルデータベースから返されるリターンコード。

  • 0：正常終了。
  • 0以外：異常終了又はメッセージ付きの正常終了。
  DABrokerからリレーショナルデータベースへの要求の送信を表示している行は，RETCODEは空白になります。
  

  INFORMATION

  FETCH時の行取得要求数及び取得結果の情報。ORACLEの場合は，「BLOCK COUNT（XXX）」の形式で出力されます。

  SQL

  クライアントから要求のあったSQLの内容。

  この項目は，Microsoft SQL Server使用時にEVTがPREPAREの場合にだけ出力されます。表示内容と意味を表A-5に示します。

  表A-5　「SQL」への表示内容と意味

  表示内容	意味
  (SQL) ODBC:{SQLTables}	テーブル一覧情報
  (SQL) ODBC:{SQLColumns }	カラム一覧情報
  (SQL) ODBC:{SQLTablePrivileges}	テーブル権限一覧情報
  (SQL) ODBC:{SQLColumnPrivileges}	カラム権限一覧情報
  (SQL) ODBC:{SQLStatistics}	インデックス一覧情報
  (SQL) ODBC:{SQLProcedures}	プロシジャ一覧情報
  (SQL) ODBC:{SQLProcedureColumns}	プロシジャ列一覧情報
  (SQL) ODBC:{SQLPrimaryKeys}	プライマリキー一覧情報

  注意

  クライアントからの要求量（SQL文）が多いほど，アクセストレースのファイル容量も多くなります。トレースは，1レコード80バイトで表示されます。クライアントからの要求（SQL文）が多い場合は，折り返して表示します。アクセストレースのファイル容量の目安として，概算式を次に示します。

  アクセストレースのファイル容量（単位：バイト）＝

  {(クライアントからの要求（SQL長など）* 2) + 2 [ +↓(クライアントからの要求SQL長/73)↓-1] } * 80

  注　下線は，SQL長が73バイト以上の場合です。

あらかじめ，この概算式で計算したサイズ以上のハードディスク容量を用意しておいてください。また，クライアントからの要求量が多いほど，トレース表示が終わるまで時間が掛かります。