17.4.2 トレースレベル1の場合に出力される情報
トレースレベル1の場合の出力例を次に示します。
■出力例(トレースレベル1の場合)
トレースレベル1の場合,1行に出力される文字列は最大256バイトです。ただし,実行要求したSQL文,および診断情報メッセージについては,すべての情報が出力されます。
各出力情報について次の表で説明します。
項番 |
出力項目 |
説明 |
---|---|---|
1 |
[Trace Start Time] |
HADB ODBCドライバトレース情報の出力を開始した日時を出力します。 日時の取得に失敗した場合,日付および時刻のすべての欄に0を出力します。 |
2 |
[Process ID] |
プロセスIDを出力します。 |
3 |
[Module Name] |
HADB ODBCドライバを使用するモジュール名称を出力します。モジュール名称が不明な場合は,unknownを出力します。 |
4 |
[Platform] |
HADB ODBCドライバが動作しているプラットフォームを出力します。 |
5 |
[ODBC environment variables] |
HADB ODBCドライバが使用している環境変数の値を出力します。環境変数に指定された値ではなく,HADB ODBCドライバで有効となっている値(デフォルト値やODBCデータソースアドミニストレーターで変更された値)が出力されます。
上記の環境変数については,「4.3.1 Windows版のHADBクライアントの場合」を参照してください。 |
6 |
[RETURN Value] |
ODBC関数の戻り値の説明です。 項番11のRETURNのSQLRETURN型の整数値に対応する定義の説明です。 |
7 |
FUNCTION |
ODBC関数名を出力します。 |
8 |
HANDLE |
ODBC関数に引数として渡されたハンドルの値を出力します。 |
9 |
START-TIME |
ODBC関数の実行開始日時を出力します。 日時の取得に失敗した場合,日付および時刻のすべての欄に0を出力します。 |
10 |
END-TIME |
ODBC関数の実行終了日時を出力します。 日時の取得に失敗した場合,日付および時刻のすべての欄に0を出力します。 |
11 |
RETURN |
ODBC関数の実行結果であるSQLRETURN型の値を出力します。 値の意味については,上部に出力される[RETURN Value]を参照してください。 |
12 |
SQLSTATE |
SQLSTATEを出力します。 ODBC関数を実行した結果,SQLSTATEが出力された場合に限り出力されます。 |
13 |
CON_ID |
コネクション番号を出力します。 SQLトレース情報に出力されるコネクション番号と同じものが出力されます。 HADBサーバと接続する前の場合は,*を出力します。 |
14 |
CON_NUM |
コネクション通番を出力します。 SQLトレース情報に出力されるコネクション通番と同じものが出力されます。 HADBサーバと接続する前の場合は,*を出力します。 |
15 |
OPTION |
オプション情報を出力します。詳細については,「表17‒5 OPTIONに出力されるオプション情報」を参照してください。 ODBC関数ごとに出力情報が異なります。 出力する情報がない場合は,*を出力します。 シンボル名で出力する情報のうち,不明な値の場合は,シンボル値の代わりにunknownが出力されます。 |
16 |
Connect Info |
HADBサーバとの接続が確立したときに出力される情報を出力します。 |
17 |
[DataSourceName] |
接続しているデータソース名を出力します。 データソースを使用していない場合,またはファイルDSNを使用している場合は,*を出力します。 |
18 |
[Client Definition File Path] |
クライアント定義ファイルのパスを出力します。 |
19 |
[Hitachi Advanced Data Binder ODBC Driver Version] |
HADB ODBCドライバのバージョンを出力します。 |
20 |
[ProcessID] |
HADBクライアントのプロセスIDを出力します。 |
21 |
<SQL> |
実行要求したSQL文を出力します。 次のODBC関数が実行された場合に,ODBC関数の引数として渡されたSQL文を出力します。
|
22 |
<Message> |
診断情報メッセージを出力します。 ODBC関数の実行結果が次の場合に出力されます。
|
上記の表のOPTIONに出力されるオプション情報を次の表に示します。
項番 |
分類 |
ODBC関数 |
OPTIONに出力されるオプション情報 |
---|---|---|---|
1 |
データソースとの接続 |
SQLAllocHandle |
|
2 |
SQLConnect(W) |
|
|
3 |
SQLDriverConnect(W) |
InConnectionString パスワードは,*1個を出力します。 |
|
4 |
SQLBrowseConnect(W) |
||
5 |
ドライバおよびデータソースの情報取得 |
SQLDataSources(W) |
なし |
6 |
SQLDrivers(W) |
||
7 |
SQLGetInfo(W) |
InfoType |
|
8 |
SQLGetFunctions |
FunctionID |
|
9 |
SQLGetTypeInfo(W) |
DataType |
|
10 |
ドライバオプションの設定および取得 |
SQLSetConnectAttr(W) |
Attribute |
11 |
SQLGetConnectAttr(W) |
||
12 |
SQLSetEnvAttr |
||
13 |
SQLGetEnvAttr |
||
14 |
SQLSetStmtAttr(W) |
||
15 |
SQLGetStmtAttr(W) |
||
16 |
ディスクリプタ値の設定 |
SQLGetDescField(W) |
|
17 |
SQLGetDescRec(W) |
|
|
18 |
SQLSetDescField(W) |
|
|
19 |
SQLSetDescRec |
|
|
20 |
SQLCopyDesc |
|
|
21 |
SQL要求の作成 |
SQLPrepare(W) |
|
22 |
SQLBindParameter |
|
|
23 |
SQLGetCursorName(W) |
なし |
|
24 |
SQLSetCursorName(W) |
||
25 |
SQLDescribeParam |
ParameterNumber |
|
26 |
SQLNumParams |
*ParameterCountPtr |
|
27 |
SQLの実行 |
SQLExecute |
|
28 |
SQLExecDirect(W) |
||
29 |
SQLNativeSql(W) |
OutStatementText |
|
30 |
SQLParamData |
なし |
|
31 |
SQLPutData |
StrLen_or_Ind |
|
32 |
実行結果および実行結果情報の取得 |
SQLRowCount |
*RowCountPtr |
33 |
SQLNumResultCols |
*ColumnCountPtr |
|
34 |
SQLDescribeCol(W) |
ColumnNumber |
|
35 |
SQLColAttribute(W) |
|
|
36 |
SQLBindCol |
|
|
37 |
SQLFetch |
なし |
|
38 |
SQLFetchScroll |
||
39 |
SQLGetData |
|
|
40 |
SQLSetPos |
なし |
|
41 |
SQLBulkOperations |
||
42 |
SQLMoreResults |
||
43 |
SQLGetDiagField(W) |
DiagIdentifier |
|
44 |
SQLGetDiagRec(W) |
なし |
|
45 |
データソースのシステム情報の取得 |
SQLColumnPrivileges(W) |
なし |
46 |
SQLColumns(W) |
||
47 |
SQLForeignKeys(W) |
||
48 |
SQLPrimaryKeys(W) |
||
49 |
SQLProcedureColumns(W) |
||
50 |
SQLProcedures(W) |
||
51 |
SQLSpecialColumns(W) |
||
52 |
SQLStatistics(W) |
||
53 |
SQLTablePrivileges(W) |
||
54 |
SQLTables(W) |
||
55 |
SQL実行の終了 |
SQLFreeStmt |
Option Option=SQL_CLOSEの場合は,次の情報も出力します。
|
56 |
SQLCloseCursor |
|
|
57 |
SQLCancel |
なし |
|
58 |
SQLEndTran |
|
|
59 |
データソースとの切断 |
SQLDisconnect |
なし |
60 |
SQLFreeHandle |
注
-
*付きの変数名は出力値を出力します。それ以外の場合は,入力値を出力します。
-
(シンボル値)は,シンボル値に置き換えた文字列を出力します。それ以外の場合は,数値を出力します。不明な値の場合は,unknownを出力します。
-
トランザクションが決着済みのときなど,tran_id,stmt_htdl,およびsql_serial_numが取得できない場合は,各値に*を出力します。
-
オプション情報に2つ以上の情報を出力する場合,各情報をコンマで区切って出力します。