Mit dieser gespeicherten Prozedur können Sie alle Fehlermeldungstypen von dbmlsync verarbeiten. Sie können beispielsweise den Hook sp_hook_dbmlsync_all_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

Jedes Mal, wenn eine dbmlsync-Fehlermeldung generiert wird, werden die folgenden Hooks aufgerufen:

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 Beenden des Hooks festgeschrieben.

Siehe auch

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

Beispiel

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 Fehler mithilfe von sp_hook_dbmlsync_all_error protokolliert.

CREATE PROCEDURE sp_hook_dbmlsync_all_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. Wenn dbmlsync beispielsweise den Fehler "Verbindung mit MobiLink-Server kann nicht hergestellt werden" zurückgibt, fügt sp_hook_dbmlsync_all_error folgende Zeile in error_log ein:

1,14173,
 'Unable to connect to MobiLink server'

Nun können Sie den Fehler "Unable to connect to MobiLink server" (Verbindung mit MobiLink-Server kann nicht hergestellt werden) mit der Fehler-ID 14173 in Verbindung bringen.

Im folgenden Beispiel werden Hooks so eingerichtet, dass die Synchronisation neu gestartet wird, sobald der Fehler 14173 auftritt.

CREATE PROCEDURE sp_hook_dbmlsync_all_error()
BEGIN
 IF EXISTS( SELECT value FROM #hook_dict 
    WHERE name = 'error id' AND value = '14173' )
 THEN
    UPDATE #hook_dict SET value = '1' 
       WHERE name = 'error hook user state';
   END IF;
END;

CREATE PROCEDURE sp_hook_dbmlsync_end()
BEGIN
 IF EXISTS( SELECT value FROM #hook_dict 
    WHERE name='error hook user state' AND value='1')
 THEN
    UPDATE #hook_dict SET value = 'sync' 
       WHERE name='restart';
   END IF;
END;

Weitere Hinweise finden Sie unter sp_hook_dbmlsync_end.