システム・モニター 手引きおよび解説書

db2ConvMonStream

新しい自己記述形式の単一の論理データ要素 (SQLM_ELM_DB2 など) を、 それに対応するバージョン 6 以前の外部モニター構造 (sqlm_db2 など) に変換します。 バージョン 5 以降のストリームを使用するために API 呼び出しをアップグレードする場合、 API 呼び出しは、新しいストリーム形式を使用してモニター・データを走査する必要があります (たとえば SQLM_ELM_DB2 要素を検索するなど)。 それから、ストリームのこの部分を変換 API に渡すことにより、 関連するバージョン 6 以前のデータを取得することができます。

許可

なし

必須接続

なし

db2ApiDf.h

C API 構文



/* File: db2ApiDf.h */
/* API: db2ConvMonStream */
/* ... */
int db2ConvMonStream (
  unsigned char version,
  db2ConvMonStreamData * data,
  struct sqlca * pSqlca);
 
typedef struct
{
  void * poTarget;
  sqlm_header_info * piSource;
  db2Uint32 iTargetType;
  db2Uint32 iTargetSize;
  db2Uint32 iSourceType
} db2ConvMonStreamData;
/* ... */
 

API パラメーター

version
入力。 2 番目のパラメーター data によって渡される構造体のバージョンとリリース・レベルを指定します。

data
入力。 db2ConvMonStreamData 構造体へのポインター

pSqlca
出力。 sqlca 構造体へのポインター。

poTarget
出力。 ターゲット・モニター出力構造体 (たとえば sqlm_db2) へのポインター。 出力タイプとそれぞれに対応する入力タイプのリストが以下に続きます。

piSource
入力。 変換される論理データ要素 (たとえば SQLM_ELM_DB2) へのポインター。 出力タイプとそれぞれに対応する入力タイプのリストが以下に続きます。

iTargetType
入力。 実行される変換のタイプ。 sqlmon.h に、バージョン 5 のタイプの値を指定してください (たとえば SQLM_DB2_SS)。

iTargetSize
入力。 通常、このパラメーターは poTarget によって示される構造体のサイズに設定できます。 しかし、 いつも構造体末尾からのオフセット値で参照されていた要素 (たとえば sqlm_stmt のステートメント・テキスト) に関しては、 サイズが静的な sqlm_stmt 要素と、 抽出される最大サイズのステートメントとを収容できる大きさのバッファーを指定してください。 これは、SQL_MAX_STMT_SZ に sizeof(sqlm_stmt) を加えた値に相当します。

iSourceType
入力。 ソース・ストリームのタイプ。 有効な値は SQLM_STREAM_SNAPSHOT (スナップショット・ストリーム)、 または SQLM_STREAM_EVMON (イベント・モニター・ストリーム) です。

使用上の注意

サポートされている変換可能なデータ要素のリストを以下に示します。

Snapshot Variable Datastream Type             Structure
---------------------------------             ---------
SQLM_ELM_APPL                                 sqlm_appl
SQLM_ELM_APPL_INFO                            sqlm_applinfo
SQLM_ELM_DB2                                  sqlm_db2
SQLM_ELM_FCM                                  sqlm_fcm
SQLM_ELM_FCM_NODE                             sqlm_fcm_node
SQLM_ELM_DBASE                                sqlm_dbase
SQLM_ELM_TABLE_LIST                           sqlm_table_header
SQLM_ELM_TABLE                                sqlm_table
SQLM_ELM_DB_LOCK_LIST                         sqlm_dbase_lock
SQLM_ELM_APPL_LOCK_LIST                       sqlm_appl_lock
SQLM_ELM_LOCK                                 sqlm_lock
SQLM_ELM_STMT                                 sqlm_stmt
SQLM_ELM_SUBSECTION                           sqlm_subsectiion
SQLM_ELM_TABLESPACE_LIST                      sqlm_tablespace_header
SQLM_ELM_TABLESPACE                           sqlm_tablespace
SQLM_ELM_ROLLFORWARD                          sqlm_rollfwd_info
SQLM_ELM_BUFFERPOOL                           sqlm_bufferpool
SQLM_ELM_LOCK_WAIT                            sqlm_lockwait
SQLM_ELM_DCS_APPL                             sqlm_dcs_appl, sqlm_dcs_applid_info,
                                              sqlm_dcs_appl_snap_stats,
                                              sqlm_xid, sqlm_tpmon
SQLM_ELM_DCS_DBASE                            sqlm_dcs_dbase
SQLM_ELM_DCS_APPL_INFO                        sqlm_dcs_applid_info
SQLM_ELM_DCS_STMT                             sqlm_dcs_stmt
SQLM_ELM_COLLECTED                            sqlm_collected
 
Event Monitor Variable Datastream Type        Structure
--------------------------------------        ---------
SQLM_ELM_EVENT_DB                             sqlm_db_event
SQLM_ELM_EVENT_CONN                           sqlm_conn_event
SQLM_ELM_EVENT_TABLE                          sqlm_table_event
SQLM_ELM_EVENT_STMT                           sqlm_stmt_event
SQLM_ELM_EVENT_XACT                           sqlm_xaction_event
SQLM_ELM_EVENT_DEADLOCK                       sqlm_deadlock_event
SQLM_ELM_EVENT_DLCONN                         sqlm_dlconn_event
SQLM_ELM_EVENT_TABLESPACE                     sqlm_tablespace_event
SQLM_ELM_EVENT_DBHEADER                       sqlm_dbheader_event
SQLM_ELM_EVENT_START                          sqlm_evmon_start_event
SQLM_ELM_EVENT_CONNHEADER                     sqlm_connheader_event
SQLM_ELM_EVENT_OVERFLOW                       sqlm_overflow_event
SQLM_ELM_EVENT_BUFFERPOOL                     sqlm_bufferpool_event
SQLM_ELM_EVENT_SUBSECTION                     sqlm_subsection_event
SQLM_ELM_EVENT_LOG_HEADER                     sqlm_event_log_header

sqlm_rollfwd_ts_info 構造体は変換されません。 これにはストリームから直接アクセスできる表スペース名だけが含まれます。 また、sqlm_agent 構造体も変換されません。 これにはストリームから直接アクセスできるエージェントの pid だけが含まれます。


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]