イメージ、オーディオ、およびビデオ・エクステンダー 管理およびプログラミングの手引き

DBiEnableTable


イメージ オーディオ ビデオ
O

表を画像 (DB2Image データ) 用に使用可能にします。 この API は、表ごとに 1 回呼び出します。 表の画像列属性を保管し、管理するためのメタデータ表を作成します。 ロッキングが発生する可能性を回避するため、アプリケーションでトランザクションをコミットしてから、この API を呼び出してください。 この API を呼び出す前に、アプリケーションをデータベースに接続する必要があります。

許可

Control、Alter、SYSADM、DBADM

ライブラリー・ファイル
OS/2 および Windows AIX、HP-UX、および Solaris
dmbimage.lib libdmbimage.a (AIX)

libdmbimage.sl (HP-UX)

libdmbimage.so (Solaris)

インクルード・ファイル

dmbimage.h

構文

long DBiEnableTable(
      char *tableSpace,
      char *tableName
      );

パラメーター

tableSpace (in)
管理表を保管する先のコンテナーの集まりである表スペースの名前。 表スペースの指定は、datats、indexts、longts という 3 つの部分からなります。 ここで、datats はメタデータ表を作成する表スペース、indexts はメタデータ表の索引を作成する表スペース、さらに longts はメタデータ表の長い列 (たとえば、LONG VARCHAR および LOB データ・タイプが入っている列) の値が保管される表スペースです。 表スペース指定のいずれかの部分にヌル値を指定すると、その部分の省略時の表スペースが使用されます。

表スペース指定のいずれかの部分にヌル値を指定すると、その部分の省略時の表スペースが使用されます。

EEE のみ: 指定された表スペースは、ユーザー表と同じノード・グループになければなりません。

tableName (in)
画像列が入っている表の名前。

エラー・コード

MMDB_SUCCESS
正常に処理された API 呼び出し。

MMDB_RC_NO_AUTH
呼び出し側のアクセス権限が正しくありません。

MMDB_WARN_ALREADY_ENABLED
表はすでに使用可能になっています。

MMDB_RC_NOT_CONNECTED
アプリケーションのデータベース接続が有効ではありません。

MMDB_RC_TABLE_DOESNOT_EXIST
表がありません。

MMDB_RC_TABLESPACE_NOT_SAME_NODEGROUP
指定された表スペースが、ユーザー表と同じノード・グループにありません。 (EEE のみ)

表スペース MYTS で、従業員表を画像 (DB2Image データ) 用に使用可能にするには、次のようにします。 索引表スペースおよび長形式表スペースには省略時値を使用します。

#include <dmbimage.h>
rc = DBiEnableTable("myts,,",
       "employee");

従業員表を画像 (DB2Image データ) の場合に使用可能にするには、次のようにします。省略時表スペースを使用します。

#include <dmbimage.h>
rc = DBiEnableTable(NULL,
       "employee");


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