新しい自己記述形式の単一の論理データ要素 (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 パラメーター
使用上の注意
サポートされている変換可能なデータ要素のリストを以下に示します。
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 だけが含まれます。