付録D.3 DABrokerの起動中に使用できるユティリティ

DABrokerの起動中には,次の三つのユティリティを使って情報を取得したり,HITSENSER5の処理を制御したりできます。

DABroker管理ユティリティ
DABrokerの動作状態を表示したり,特定のHITSENSER5の処理を中断したりできます。詳しくは「付録D.3(1) DABroker管理ユティリティ」で説明します。
DABrokerトレース出力ユティリティ
通信トレース,及びアクセストレースを出力できます。このユティリティは,DABrokerが起動していなくても使用できます。詳しくは「付録D.3(2) DABrokerトレース出力ユティリティ」で説明します。
拡張アクセストレースユティリティ
拡張アクセストレースを出力できます。詳しくは「付録D.3(3) 拡張アクセストレースユティリティ」で説明します。
参考 使用しないユティリティ
プログラムフォルダに登録された[DABroker]で[エージェント実行]を選択すると,DABrokerエージェント管理ユティリティが起動されます。しかし,DABrokerをHITSENSER5とリレーショナルデータベースの接続に使用している場合,このユティリティは使用しません。よって,このユティリティについての説明は省略します。
<この項の構成>
(1)  DABroker管理ユティリティ
(2) DABrokerトレース出力ユティリティ
(3) 拡張アクセストレースユティリティ

(1)  DABroker管理ユティリティ

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

(a) 機能

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

DABrokerの動作状態の表示
各HITSENSER5との接続時間,及び予約処理の状態を表示します。操作手順については「付録D.3(1)(c) DABrokerの動作状態を表示する操作手順」を参照してください。
HITSENSER5の処理の中断
指定したHITSENSER5との接続を解放し,実行中の処理を中断します。このとき,DABrokerはリレーショナルデータベースに要求した処理のロールバックを要求します。また,そのHITSENSER5が要求した予約処理をすべて取り消します。操作手順については「付録D.3(1)(d) HITSENSER5の処理を中断する操作手順」を参照してください。
(b) 操作できるユーザ

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

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

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

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

    図D-6 [DABroker管理]ダイアログ

    [図データ]

    [DABroker管理]ダイアログに表示される項目の意味は次のとおりです。
    識別子
    DABrokerに接続されているクライアント処理を識別するための番号です。
    IPアドレス
    接続しているHITSENSER5があるマシンのIPアドレス。
    接続時刻
    HITSENSER5と接続した日時(年/月/日 時:分:秒)。
    接続時間
    接続してからの経過時間(時:分:秒)。
    予約
    実行中の予約処理数(HITSENSER5では使用しません)。
    状態
    HITSENSER5との接続状態。
    「接続中」と表示されている場合は,HITSENSER5とのコネクションが確立されていることを示します。
    ホスト名
    接続しているHITSENSER5があるマシンのホスト名。
    次の条件をすべて満たしている場合に表示されます。
    • 「図D-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は選択したクライアントとのコネクションを解放します。同時にリレーショナルデータベースに処理のロールバックを要求して,そのクライアントが要求したすべての予約処理を取り消します。

(2) DABrokerトレース出力ユティリティ

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

(a) 機能

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

通信トレース
通信トレースとは,DABrokerとHITSENSER5間のデータの送受信についての情報です。DABrokerがこの情報を取得するのは,クライアントからの要求受付直後,及びDABrokerからの結果送信直後です。通信トレースは,「DABroker運用ディレクトリ¥spool¥dabcltrc」の下に出力されます。
アクセストレース
アクセストレースとは,DABrokerがリレーショナルデータベースに要求した処理,及びその処理に対するリレーショナルデータベースからの応答についての情報です。DABrokerがこの情報を出力するのは,リレーショナルデータベースに要求を出す直前及びリレーショナルデータベースから応答が返ってきた直後です。リレーショナルデータベースとのアクセストレースは,「DABroker運用ディレクトリ」¥spool¥db_accessの下に出力されます。
(b) 操作できるユーザ

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

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

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

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

    図D-7 [DABrokerトレース出力]ダイアログ

    [図データ]

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

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

      出力するアクセストレースの範囲[UAP名]※1[ユーザID]※2
      すべてのアクセストレースを出力する場合
      特定のHITSENSER5のアクセストレースを出力する場合
      特定のユーザIDのアクセストレースを出力する場合
      特定のHITSENSER5の特定のユーザIDのアクセストレースを出力する場合

      (凡例)○:指定する項目  -:指定しない項目

      注※1 [UAP名]
      「HS5」+「HITSENSER5ユーザIDの先頭9文字」+「-」+「IPアドレス」を指定します。例えば,HITSENSER5ユーザIDの先頭9文字が「LOGINUSRID」,IPアドレスが「111.22.33.44」の場合,UAP名には「HS5LOGINUSRI-111.22.33.44」と指定します。
      注※2 [ユーザID]
      リレーショナルデータベースへログインするためのユーザIDを指定します。

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

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

注意
クライアントからの要求量が多いほど,クライアントとの通信トレースのファイル容量も多くなります。通信トレースのファイル容量の目安として,概算式を次に示します。
通信トレースのファイル容量(単位:バイト)=
80(ヘッダ情報長) + クライアントからの要求数 * 2 (PUT及び
GET分) * 36(PUT及びGET情報長)
あらかじめ,この概算式で計算したサイズ以上のハードディスク容量を用意しておいてください。また,クライアントからの要求量が多いほど,トレース出力が終わるまで時間がかかります。御注意ください。

アクセストレースの出力例を次に示します。

図D-9 アクセストレースの出力例

[図データ]

UID=XXXXXXXX
ユーザID。
PAPNAME=XXXXXXX
アプリケーションを識別するための文字列が表示されます。表示される文字列は,[UAP名]で指定できる名称です。
DBNAME=XXXXXXX
接続先データベース名。次のどれかが出力されます。
DATE
アクセスの発生日(年/月/日)。
TIME
アクセスの発生時刻(時:分:秒.n)。nは100分の1秒を表します。
EVT
DABrokerがデータベースに要求した処理の内容。EVTの表示と対応する処理内容を,表D-4に示します。

表D-4 EVTの表示と処理内容(DABrokerトレース出力ユティリティ)

EVTの表示処理内容
CONNECTデータベースと接続します。
PREPARESQLの前処理をします。
DESCRIBE前処理したSQLの情報を返します。
DECLARE前処理したSELECTに対してカーソルを宣言します。
OPENカーソルを位置付けます。
FETCH行を読み込んでカーソルを進めます。
CLOSEカーソルを閉じます。
EXECUTE前処理したSQLを実行します。
COMMITトランザクションを正常終了,更新を有効にします。
ROLLBACKトランザクションを取り消し,更新を無効にします。
DISCONNECTトランザクションを正常終了,切り離します。
CANCELリレーショナルデータベースに対し,処理の中断します。
LOGGINGリレーショナルデータベースに対し,ログ取得要求します。
ただし,HiRDBの場合だけです。
LOGLESSリレーショナルデータベースに対し,ログレス要求します。
ただし,HiRDBの場合だけです。
データベースとのアクセストレースの取得内容は任意に選択できます。環境設定ユティリティの[アクセストレースの種類]で選択します。
RETCODE
DABrokerが要求した処理に対して,リレーショナルデータベースから返されるリターンコード。

DABrokerからリレーショナルデータベースへの要求の送信を表示している行は,RETCODEは空白になります。

INFORMATION
FETCH時の行取得要求数及び取得結果の情報。ORACLEの場合は,「BLOCK COUNT(XXX)」の形式で出力されます。
SQL
クライアントから要求のあったSQLの内容。
この項目は,Microsoft SQL Server使用時にEVTがPREPAREの場合にだけ出力されます。表示内容と意味を表D-5に示します。

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

(3) 拡張アクセストレースユティリティ

拡張アクセストレースは,次のような場合に有効です。

ここでは,拡張アクセストレースユティリティの機能,拡張アクセストレースの取得方法,ファイル出力形式,ファイル名称及び注意事項について説明します。

(a) 機能

拡張アクセストレースでは,従来のDABrokerのアクセストレースに比べて,次の機能が拡張されています。

(b) 拡張アクセストレースの取得方法

拡張アクセストレースの取得は,DABroker動作環境定義ファイルで設定します。DABroker動作環境定義ファイルでの設定方法については,マニュアル「DABroker」を参照してください。

(c) ファイル出力形式

拡張アクセストレースのファイル出力形式を次に示します。

ヘッダ情報

*-------------------------------------------------------*
*- DataBase Access Information (DRV)                   -*
*- Date  YYYY/MM/DD hh:mm:ss.nnnnnn                    -*
*-------------------------------------------------------*
DABroker Connect ID    : AAAAA(BBBBB)
Process ID             : CCCCC
UserID                 : DDDDD
Client Name            : EEEEE
(DB別出力情報)
Lang Mode              : GGGGG

個々のトレース情報

THREAD-ID  CID   EVT   START-TIME   END-TIME   RETCODE
BLOCKCNT   (SQL)

それぞれの出力項目について,次に説明します。

DRV
DABrokerのアクセスドライバの種別に従い,次の識別子が出力されます。

表D-6 アクセスドライバの種別と識別子

アクセスドライバの種別識別子
HiRDB Version5.0,HiRDB Version6,HiRDB Version7HiRDB Driver
Oracle7,Oracle8,Oracle8i,Oracle9i,Oracle 10gORACLE7 Driver
Microsoft SQL Server,DIAPRISMODBC30
Date
ファイル作成日時。
YYYY/MM/DD hh:mm:ss.nnnnnnの形式で出力されます。
  • YYYY:西暦年
  • MM:月
  • DD:日
  • hh:時
  • mm:分
  • ss:秒
  • nnnnnn:マイクロ秒
DABroker Connect ID
データベース接続識別子が出力されます。
Process ID
実行プロセスIDが出力されます。
UserID
接続ユーザIDが出力されます。
Client Name
UAP名称が出力されます。名称が設定されていない場合は空白になります。
(DB別出力情報)
接続データベースによって異なる情報が出力されます。出力内容について,表D-7に示します。

表D-7 接続データベースごとのトレース出力内容

接続データベース出力内容説明
HiRDB Version5.0,HiRDB Version6,HiRDB Version7PDHOST:HiRDB接続時のPDHOSTの設定内容です。未設定の場合は,"Not Indicator"が出力されます。
PDNAMEPORT:HiRDB接続時のPDNAMEPORTの設定内容です。未設定の場合は,"Not Indicator"が出力されます。
Oracle7,Oracle8,Oracle8i,Oracle9i,Oracle 10gSQLNET:ORACLEリスナー名が出力されます。未設定の場合は,"Not Indicator"が出力されます。
Microsoft SQL Server,DIAPRISMODBC Dara Sourcs:ODBC設定のデータソース名が出力されます。未設定の場合は,"Not Indicator"が出力されます。
ODBC Key Word:ODBC設定の接続情報が出力されます。未設定の場合は,"Not Indicator"が出力されます。
Lang Mode
実行言語モードが出力されます。
THREAD-ID
実行スレッドIDが出力されます。
CID
カーソル番号が出力されます。
EVT
DABrokerがデータベースに要求した処理の内容です。内容の種類は任意に選択できます。詳しくは,マニュアル「DABroker」を参照してください。ただし,アクセストレースを取得していない場合は,DABroker動作環境定義ファイルを直接編集します。また,拡張アクセストレースで表示の種類を変更すると,従来のアクセストレース表示の種類も変更されます。
すべての表示をOFFにした場合はヘッダだけが出力されます。
従来のアクセストレースにはないETVの表示とその処理内容を次に示します。表示を一つでもONにした場合,GET_DIAGの表示を抑止できません。

表D-8 EVTの表示と処理の内容(拡張アクセストレースユティリティ)

EVTの表示処理内容
DESC_OUT前処理したSQLの出力情報を返します。
DESC_IN前処理したSQLの入力情報を返します。
GET_DIAGエラー詳細情報の取得処理を実行します。
ATTACHサーバとのアクセスパス作成要求を実行します。
ATTRGETハンドル属性の取得要求を実行します。
ATTRSETハンドル属性の設定要求を実行します。
BINDパラメタのバインド要求を実行します。
CHARFORMキャラクタセットフォームの取得要求を実行します。
CHARIDキャラクタセットIDの取得要求を実行します。
DEFINEパラメタの定義要求を実行します。
DESALLOC記述子の領域確保を実行します。
DESCANYオブジェクトの記述要求を実行します。
DESFREE記述子の領域解放を実行します。
DETACHアクセスパス削除要求を実行します。
ENVCREATE環境作成要求を実行します。
ERRGETエラー情報取得要求を実行します。
GETPIECEピース情報の取得要求を実行します。
HDLALLOCハンドルの領域確保を実行します。
HEDLFREEハンドルの領域解放を実行します。
LOBCLOSEBFILEデータのクローズ要求を実行します。
LOBLENLOBデータの長さ取得要求を実行します。
LOBOPENBFILEデータのオープン要求を実行します。
LOBREADLOBデータの読み込み要求を実行します。
LOBWRITELOBデータの書き込み要求を実行します。
PARAMGETパラメタ情報の取得要求を実行します。
SESBEGINセション開始要求を実行します。
SESENDセション終了要求を実行します。
SETPIECEピース情報の設定要求を実行します。
注※
HITSENSER5から使用した場合は出力されません。

START-TIME
アクセス開始日時。
YYYY/MM/DD hh:mm:ss.nnnnnnの形式で出力されます。
  • YYYY:西暦年
  • MM:月
  • DD:日
  • hh:時
  • mm:分
  • ss:秒
  • nnnnnn:マイクロ秒
END-TIME
アクセス終了日時。
YYYY/MM/DD hh:mm:ss.nnnnnnの形式で出力されます。
  • YYYY:西暦年
  • MM:月
  • DD:日
  • hh:時
  • mm:分
  • ss:秒
  • nnnnnn:マイクロ秒
RETCODE
データベースから返されるリターンコードが出力されます。
BLOCKCNT
FETCH時の行取得件数が出力されます。
(SQL)
クライアントから要求のあったSQLの内容が出力されます。この項目は,必要に応じて出力されます。
(d) ファイル名称

拡張アクセストレースのファイルは,次のディレクトリに作成されます。

DABroker運用ディレクトリ¥spool¥db_access

拡張アクセストレースのファイル名称は,次の規則に従います。

spdb_XXXXXXXX_YYYYYYYY_****ZZZZZ.IIIIII

(e) 注意事項

拡張アクセストレースのファイルを運用する際には,次の点に注意してください。