Mit dieser gespeicherten Prozedur können dbmlsync-Fehler verarbeitet werden, die nicht als Datenbank- oder Verbindungsfehler erkannt werden. Sie können beispielsweise den Hook sp_hook_dbmlsync_misc_error einführen, um Fehler zu protokollieren oder beim Eintreten eines bestimmten Fehlers eine bestimmte Aktion durchzuführen.

Zeilen in der Tabelle #hook_dict

Bemerkungen

Wenn beim Start ein Fehler auftritt, bevor eine Synchronisation initiiert werden konnte, werden die #hook_dict-Einträge für den MobiLink-Benutzer und die Skriptversion auf eine leere Zeichenfolge zurückgesetzt, und in der #hook_dict-Tabelle werden keine publication_n-Zeilen eingestellt.

Diese Prozedur wird in einer eigenen Verbindung ausgeführt, damit sichergestellt ist, dass die dadurch bewirkten Vorgänge nicht verloren gehen, wenn ein Zurücksetzen der Synchronisationsverbindung erfolgt. Wenn dbmlsync keine getrennte Verbindung herstellen kann, wird die Prozedur nicht aufgerufen.

Auf Windows Mobile-Geräten werden Synchronisationstabellen exklusiv gesperrt. Das bedeutet, dass dieser Hook nicht erfolgreich ausgeführt werden kann, wenn er auf eine der Synchronisationstabellen zugreifen muss. Er kann auch nicht ausgeführt werden, wenn er auf Synchronisationstabellen zugreifen muss und Sie die erweiterte Option LockTables von dbmlsync auf EXCLUSIVE gesetzt haben. Weitere Hinweise finden Sie unter Erweiterte Option LockTables (lt).

Die Aktionen dieser Prozedur werden sofort nach ihrer Ausführung festgeschrieben.

Siehe auch

• Fehlerbehandlung und Warnungen in Hook-Prozeduren
• sp_hook_dbmlsync_communication_error
• sp_hook_dbmlsync_all_error
• sp_hook_dbmlsync_sql_error

Beispiele

Nehmen wir an, Sie verwenden die folgende Tabelle, um Fehler in der entfernten Datenbank zu protokollieren.

CREATE TABLE error_log
(
 pk INTEGER DEFAULT AUTOINCREMENT PRIMARY KEY,
 err_id INTEGER,
 err_msg VARCHAR(10240),
);

Im folgenden Beispiel werden alle Fehlermeldungen mithilfe von sp_hook_dbmlsync_misc_error protokolliert.

CREATE PROCEDURE sp_hook_dbmlsync_misc_error()
BEGIN
 DECLARE msg VARCHAR(10240);
 DECLARE id INTEGER;

 // get the error message text
 SELECT value INTO msg
  FROM #hook_dict
  WHERE name ='error message';

 // get the error id
 SELECT value INTO id
  FROM #hook_dict
  WHERE name = 'error id';

 // log the error information
 INSERT INTO error_log(err_msg,err_id)
  VALUES (msg,id);
END;

Um mögliche Fehler-IDs zu ermitteln, sollten Sie einen Testdurchlauf von dbmlsync durchführen. Die folgende dbmlsync-Befehlszeile bezieht sich beispielsweise auf eine ungültige Publikation:

dbmlsync -c eng=custdb;uid=DBA;pwd=sql -n test

Nun enthält die error_log-Tabelle die folgende Zeile, die sich auf den Fehler mit der Fehler-ID 9931 bezieht:

1,9931,
 'There is no synchronization subscription to publication "test"'

Um eine benutzerspezifische Fehlerbehandlung zu ermöglichen, überprüfen Sie die Fehler-ID 9931 in sp_hook_dbmlsync_misc_error.

ALTER PROCEDURE sp_hook_dbmlsync_misc_error()
BEGIN
 DECLARE msg VARCHAR(10240);
 DECLARE id INTEGER;

 // get the error message text
 SELECT value INTO msg
  FROM #hook_dict
  WHERE name ='error message';

 // get the error id
 SELECT value INTO id
  FROM #hook_dict
  WHERE name = 'error id';

 // log the error information
 INSERT INTO error_log(err_msg,err_id)
  VALUES (msg,id);

 IF id = 9931 THEN
  // handle invalid publication
 END IF;

END;