1. C開発者ガイド
  2. TimesTenユーティリティAPI
  3. ttRamPolicy

ttRamPolicy

説明

接続文字列で指定したデータベースをTimesTenがシステムRAMにロードするタイミングを決定するためのポリシーを定義します。

必要な権限

インスタンス管理者

構文

ttRamPolicy (ttUtilHandle handle, const char* connStr,
             ttRamPolicyType policy)

パラメータ

パラメータ 型 説明

handle

ttUtilHandle

ttUtilAllocEnvを使用して割り当てられるTimesTenユーティリティ・ライブラリ環境ハンドルを指定します。

connStr

const char*

これは、RAMポリシーを設定するデータベースについて記述する接続文字列を指定する、空文字で終了する文字列です。

policy

ttRamPolicyType

指定したデータベースをTimesTenがシステムRAMにロードするタイミングを決定するためのポリシーを指定します。有効な値は、次のとおりです。

  • TT_RAMPOL_ALWAYS: データベースが常時RAMに存在するように指定します。

  • TT_RAMPOL_MANUAL: ttRamLoad C関数またはttAdmin -ramLoadコマンドのいずれかを使用して、データベースが明示的にRAMにロードされるように指定します。同様に、データベースは、ttRamUnload C関数またはttAdmin -ramUnloadコマンドを使用して明示的にRAMからアンロードできます。

  • TT_RAMPOL_INUSE: アプリケーションでデータベースに接続する場合にデータベースがRAMにロードされるように指定します。このRAMポリシーは、ttRamGrace C関数またはttAdmin -ramGraceコマンドを使用して、さらに変更できます。

指定したデータベースに対して明示的にRAMポリシーを設定しない場合、デフォルトのRAMポリシーはTT_RAMPOL_INUSEとなります。

ノート: TT_RAMPOL_INUSEは、TimesTen Scaleoutではサポートされていません。

例

この例では、payrollというDSNのRAMポリシーをmanualに設定します。 

ttUtilHandle   utilHandle;
int            rc;
rc = ttRamPolicy (utilHandle, "DSN=payroll", TT_RAMPOL_MANUAL);

関連項目