IBM 同期クライアント C-API バージョン 8.1 とバージョン 7.2 の比較

本セクションでは、バージョン 8.1 で IBM 同期クライアント C-API に加えられた主な変更点を要約します。

サービス、構成、およびエンジンという 3 つのハンドルが使用できるようになりました。 (同期化を実行しない場合、同期エンジン・ハンドルをオープンする必要はありません。)
IBM 同期クライアント C-API バージョン 8.1 ではプリファレンスが永続的なものではなくなり、実際には必須の情報である一部のプリファレンスが廃止されました。例えば、旧 isyncSetPref 関数のホスト名、ポート、ユーザー名、およびパスワードは、サービス・ハンドルをオープンする iscOpenService 関数の必要パラメーターになりました。
同期モードはアプリケーションに対して暗黙的なものとなり、同期化を実行する際、同期モードのパラメーターは不要になりました。
同期リスナーへのインターフェースが、イベント・ベースとなりました。アプリケーションには、イベント情報を含むイベント構造体が渡されるようになりました。
サブスクリプション・セットの同期状況 (その最後の同期化以降の) が永続的なものとなり、後から照会を行うことができるようになりました。
デフォルトのリスナーが廃止されました。イベントのデフォルトのアクションが必要な場合、アプリケーションは単に ISCRTNCB_Default コードを戻します。
DB2e Everyplace が、機密データを含む表を保護するためのデータ暗号化をサポートするようになりました。暗号化された表を同期化するための同期クライアント・アプリケーションを開発する際、 DB2 Everyplace のユーザー名とパスワードを問い合わせる、同期エンジンからの照会を (リスナーに) インプリメントすることができます。
リジェクトされたレコード (競合または無許可の操作が発生したレコードを含む) が、リスナーを介してアプリケーションに渡されるようになりました。
ログ・ファイル (LOGDB-ISYNC) がアプリケーションによって管理されるようになりました。つまり、バージョン 8.1 の同期エンジンでは、バージョン 7.2.1 のような、各国語でのログ・ファイルの生成は行われません。代わりに、サービスを目的として、同期エンジンがトレース・ファイル (TRACE-ISYN) を生成します (英語のみ)。
IBM 同期クライアントのエンジンでは、すべてのファイル (構成、トレース・ファイル、データ、およびプリファレンス (該当する場合)) を、以下に示す 1 つのディレクトリーに保管します。
- Windows CE^(R) オペレーティング・システムの場合: ¥ (ルート・ディレクトリー)
- EPOC オペレーティング・システムの場合: C:¥Systems¥Data¥ISync¥
- Palm オペレーティング・システムの場合: メイン・メモリー
- その他のオペレーティング・システムの場合: 現行ディレクトリー
IBM 同期クライアント API バージョン 7.2.1 の機能も、 API の後方互換性を処理する API ラッパー (isynce ライブラリー) を通して、引き続きサポートされます。また、API ラッパーは、バージョン 7.2.1 と同一の以下に示すディレクトリーに、ネイティブ言語のログ・ファイル (LOGDB-ISYN) を生成します。
- Windows CE^(R) オペレーティング・システムの場合: ¥Progran Files¥ISync¥
- EPOC オペレーティング・システムの場合: C:¥Systems¥Apps¥ISync¥
- Palm オペレーティング・システムの場合: メイン・メモリー
- その他のオペレーティング・システムの場合: 現行ディレクトリー
また、isyncGo 関数および isyncSetSyncMoe 関数では、 ISYNCOPTION_SkipConfig オプションおよび ISYNCOPTION_UseAppSignature オプションは機能しません。
注:
IBM 同期クライアント API バージョン 8.1 を使用する場合は、 API ラッパー (isynce) ライブラリーをインストールする必要があります。

表 114 は、IBM 同期クライアント C-API バージョン 8.1 と IBM 同期クライアント API バージョン 7.2 の間における関数の主な違いをリストしたものです。

表 114. IBM 同期クライアント C-API バージョン 8.1 とバージョン 7.2 の比較

バージョン 8.1	バージョン 7.2	注釈
`iscGetVersion`	`isyncGetVersion`	`iscGetVersion` ではハンドルは必要ありません。
`iscServiceOpen` `iscConfigOpeniscEngineOpen`	`isyncOpen`	3 つのハンドルをオープンする必要があります。ホスト、ポート、ユーザー名、およびパスワードは `iscServiceOpen` に指定され、永続的なものではありません。
`iscServiceClose` `iscConfigClose` `iscEngineClose`	`isyncClose`	3 つのハンドルをクローズする必要があります。
`iscEngineSetListener`	`isyncSetListener`	リスナーのプロトタイプおよびインターフェースが変更されました。
(なし)	`isyncDefaultListener`	外部デフォルト・リスナーは廃止されました。デフォルトのイベント処理のためには、ISCRTNCB_Default コードが戻されます。
`iscEngineSetPref` `iscEngineGetPref`	`isyncSetPref` `isyncGetPref`	2 つのプリファレンス (トレースおよびタイムアウト) のみが必要です。これらのプリファレンスは永続的ではありません。
`iscEngineSync` `iscEngineSyncConfig`	`isyncGo`	同期モードは必須ではなくなりました。構成は、`iscEngineSyncConfig` でのみ更新できます。
`iscConfigEnableSubsSet` `iscConfigDisableSubsSet` `iscConfigResetSubsSet`	`isyncSetSyncMode`	汎用の同期モード設定は廃止されました。サブスクリプション・セットの同期化は、`iscConfigDisableSubsSet` によってスキップ (使用不可に) することができます。
`iscConfigOpenCursor` `iscConfigCloseCursor` `iscConfigGetNextSubsSet` `iscConfigSubsSetIsEnabled` `iscConfigSubsSetIsReset`	`isyncGetFirstApp` `isyncGetNextApp`	サブスクリプション・セットを繰り返す前にカーソルをオープンします。サブスクリプション・セットの照会を行うには、サブスクリプション・セット ID が必要です。
`iscEngineGetInfo` `iscConfigPurge` `iscConfigGetSubsSetStatus`		バージョン 8.1 からの新規 C-API です。

関連した概念

同期クライアント C/C++ サンプル・アプリケーション

関連したタスク

C/C++ を使用した DB2 Everyplace 同期クライアント・アプリケーションの開発

関連した解説

IBM 同期クライアント C-API バージョン 8.1 と バージョン 7.2 の比較

IBM 同期クライアント C-API バージョン 8.1 とバージョン 7.2 の比較