HITSENSER5

[目次][用語][索引][前へ][次へ]

付録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トレース出力ユティリティでは，次の２種類のトレースを出力できます。

通信トレース
通信トレースとは，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トレース出力］ダイアログ

    [図データ]

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

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

      出力するアクセストレースの範囲 ［UAP名］※１ ［ユーザID］※２
      すべてのアクセストレースを出力する場合 − −
      特定の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を指定します。

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

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

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

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

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

[図データ]

UID=XXXXXXXX
ユーザID。

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

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

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

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

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

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

EVTの表示 処理内容
CONNECT データベースと接続します。
PREPARE SQLの前処理をします。
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 Version7 HiRDB Driver
Oracle7，Oracle8，Oracle8i，Oracle9i，Oracle 10g ORACLE7 Driver
Microsoft SQL Server，DIAPRISM ODBC30

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 Version7 PDHOST: HiRDB接続時のPDHOSTの設定内容です。未設定の場合は，"Not Indicator"が出力されます。
PDNAMEPORT: HiRDB接続時のPDNAMEPORTの設定内容です。未設定の場合は，"Not Indicator"が出力されます。
Oracle7，Oracle8，Oracle8i，Oracle9i，Oracle 10g SQLNET: ORACLEリスナー名が出力されます。未設定の場合は，"Not Indicator"が出力されます。
Microsoft SQL Server，DIAPRISM ODBC 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※ ハンドルの領域解放を実行します。
LOBCLOSE※ BFILEデータのクローズ要求を実行します。
LOBLEN※ LOBデータの長さ取得要求を実行します。
LOBOPEN※ BFILEデータのオープン要求を実行します。
LOBREAD※ LOBデータの読み込み要求を実行します。
LOBWRITE※ LOBデータの書き込み要求を実行します。
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)　注意事項

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

[目次][前へ][次へ]

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

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