Comparaciones entre la API C de IBM Sync Client Versión 8.1 y la Versión 7.2

Este apartado resume los principales cambios efectuados en la API C de IBM Sync Client de Versión 8.1:

Ahora se dispone de tres descriptores de contexto: servicio, configuración y motor. (Si no desea realizar sincronizaciones, no es necesario que abra el descriptor de contexto del motor.)
Las preferencias en la API C de IBM Sync Client Versión 8.1 no son persistentes y algunas de ellas, las que constituyen realmente información esencial, se han eliminado. Por ejemplo, el nombre de host, el puerto, el nombre de usuario y la contraseña de la anterior función isyncSetPref son ahora parámetros obligatorios en la función iscOpenService para abrir un descriptor de contexto de servicio.
Ahora, la modalidad de sincronización es implícita a la aplicación, y el parámetro de modalidad de sincronización ya no es necesario cuando se invoca a una sincronización.
La interfaz con la función de escucha de sincronización se basa ahora en los sucesos. Ahora, las estructuras de sucesos que contiene información de los mismos se pasan a la aplicación.
El estado de sincronización de un conjunto de suscripción (de su última sincronización) es persistente y se puede consultar más tarde.
Se ha eliminado la función de escucha por omisión. Cuando se necesita una acción por omisión para un suceso, la aplicación simplemente devuelve el código ISCRTNCB_Default.
Ahora, DB2e Everyplace da soporte al cifrado de datos para proteger la tabla que contiene datos delicados. Cuando desarrolle una aplicación de cliente sincronizado para sincronizar tablas cifradas, puede implementar (en la función de escucha) la consulta del motor de sincronización para el nombre de usuario y la contraseña de DB2 Everyplace.
Los registros rechazados (incluyendo aquéllos que contienen conflictos u operaciones no permitidas) se pasan ahora a la aplicación a través de la función de escucha.
Ahora, la aplicación gestiona el archivo de anotaciones (LOGDB-ISYNC). Es decir, que el motor de sincronización de Versión 8.1 ya no genera el archivo de anotaciones (LOGDB-ISYN) en un idioma nativo, tal como sucedía en la versión 7.2.1. En lugar de esto, y a efectos de servicios, el motor de sincronización generará un archivo de rastreo (TRACE-ISYN), que sólo está en inglés
El motor de IBM Sync Client almacena todos los archivos (incluidos la configuración, el archivo de rastreo, los datos y las preferencias (si es pertinente) en un directorio:
- En sistemas operativos Windows CE^(R): \ (directorio raíz)
- En sistemas operativos EPOC: C:\Systems\Data\ISync\
- En sistemas operativos Palm: la memoria principal
- En otros sistemas operativos: el directorio actual
El funcionamiento de la API de IBM Sync Client Versión 7.2.1 se sigue soportando mediante un reiniciador de API (la biblioteca isynce), que manejará la compatibilidad anterior de la API. El reiniciador de API también genera el archivo de anotaciones (LOGDB-ISYN) en idiomas nativos, en el mismo directorio que en la Versión 7.2.1, es decir:
- En sistemas operativos Windows CE^(R): \Archivos de programa\ISync\
- En sistemas operativos EPOC: C:\Systems\Apps\ISync\
- En sistemas operativos Palm: la memoria principal
- En otros sistemas operativos: el directorio actual
Además, las opciones ISYNCOPTION_SkipConfig e ISYNCOPTION_UseAppSignature no funcionarán con las funciones isyncGo e isyncSetSyncMoe.
Nota:
No es necesario instalar la biblioteca del reiniciador de API (isynce) si se elige utilizar la API de IBM Sync Client Versión 8.1.

La Tabla 114 lista las diferencias principales entre las funciones de la API C de IBM Sync Client Versión 8.1 y la de IBM Sync Client Versión 7.2.

Tabla 114. Comparación de la API C de IBM Sync Client Versión 8.1 con la de la Versión 7.2

Versión 8.1	Versión 7.2	Observaciones
`iscGetVersion`	`isyncGetVersion`	No se necesita ningún descriptor de contexto en `iscGetVersion`.
`iscServiceOpen` `iscConfigOpeniscEngineOpen`	`isyncOpen`	Es necesario abrir tres descriptores de contexto. El host, el puerto, el nombre de usuario y la contraseña se especifican en `iscServiceOpen` y no son persistentes.
`iscServiceClose` `iscConfigClose` `iscEngineClose`	`isyncClose`	Es necesario cerrar tres descriptores de contexto.
`iscEngineSetListener`	`isyncSetListener`	Han cambiado el prototipo de escucha y la interfaz.
(Ninguna)	`isyncDefaultListener`	No existen más funciones de escucha externas por omisión. Para el manejo de sucesos por omisión, devuelve el código ISCRTNCB_Default.
`iscEngineSetPref` `iscEngineGetPref`	`isyncSetPref` `isyncGetPref`	Sólo se requieren dos preferencias (rastreo y tiempo de espera). Estas preferencias no son persistentes.
`iscEngineSync` `iscEngineSyncConfig`	`isyncGo`	Ya no se requiere modalidad de sincronización. Sólo puede actualizar la configuración con `iscEngineSyncConfig`.
`iscConfigEnableSubsSet` `iscConfigDisableSubsSet` `iscConfigResetSubsSet`	`isyncSetSyncMode`	No hay más valores de modalidad de sincronización generales. Se puede saltar (inhabilitar) la sincronización de un conjunto de suscripción mediante `iscConfigDisableSubsSet`.
`iscConfigOpenCursor` `iscConfigCloseCursor` `iscConfigGetNextSubsSet` `iscConfigSubsSetIsEnabled` `iscConfigSubsSetIsReset`	`isyncGetFirstApp` `isyncGetNextApp`	Abre un cursor antes de repetir conjuntos de suscripción. Para consultar un conjunto de suscripción, se necesita un ID de conjunto de suscripción.
`iscEngineGetInfo` `iscConfigPurge` `iscConfigGetSubsSetStatus`		API C nuevas en la Versión 8.1.

Conceptos relacionados

La aplicación Sync Client C/C++ de ejemplo

Tareas relacionadas

Desarrollo de aplicaciones DB2 Everyplace Sync Client utilizando C/C++

Consulta relacionada