Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (Deutsch) » MobiLink - Clientadministration » SQL Anywhere-Clients für MobiLink » Ereignis-Hooks für SQL Anywhere-Clients

 

sp_hook_dbmlsync_communication_error

Verwenden Sie diese gespeicherte Prozedur, um Verbindungsfehler zu bearbeiten.

Zeilen in der Tabelle #hook_dict

Name

Wert

Beschreibung

publication_n (in)

Publikation

Die synchronisierten Publikationen, wobei n eine Ganzzahl ist. Es gibt einen publication_n-Eintrag für jede Publikation im Upload. Die Nummerierung von n beginnt bei Null.

MobiLink user (in)

MobiLink-Benutzername

Der MobiLink-Benutzer, für den Sie synchronisieren

script version (in)

Skriptversionsname

Die MobiLink-Skriptversion, die für die Synchronisation verwendet werden soll

error message (in) Fehlermeldungstext Dies ist der Text, der auch im dbmlsync-Log angezeigt wird.
error id (in) Nummerisch Eine ID, die die Meldung eindeutig identifiziert. In dieser Zeile können Sie die Fehlermeldung identifizieren, da der Meldungstext abweichen kann.
error hook user state (in|out) Ganzzahl

Dieser Wert kann vom Hook eingestellt werden, um Statusinformationen in zukünftigen Aufrufen an die Hooks sp_hook_dbmlsync_all_error, sp_hook_dbmlsync_communication_error, sp_hook_dbmlsync_misc_error, sp_hook_dbmlsync_sql_error oder sp_hook_dbmlsync_end zu übergeben. Wenn einer dieser Hooks zum ersten Mal aufgerufen wird, beträgt der Wert der Zeile "0". Wenn der Hook den Wert der Zeile ändert, wird der neue Wert im nächsten Hook-Aufruf verwendet.

Wenn Sie mit diesem Hook Statusinformationen an den Hook sp_hook_dbmlsync_end übergeben, können Sie den _end-Hook veranlassen, bestimmte Aktionen durchzuführen, beispielsweise die Synchronisation erneut zu starten.

stream error code (in) Ganzzahl Der Fehler, der vom Datenstrom gemeldet wurde
system error code (in) Ganzzahl Ein systemspezifischer Fehlercode.
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.

Wenn zwischen dbmlsync und dem MobiLink-Server Verbindungsfehler auftreten, können Sie mit diesem Hook auf datenstromspezifische Fehlerinformationen zugreifen.

Der Parameter stream error code ist eine Ganzzahl, die für den Fehlertyp des Verbindungsfehlers steht.

Eine Liste der möglichen Fehlercodewerte finden Sie unter Fehlermeldungen zur MobiLink-Kommunikation.

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
Beispiel

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

CREATE TABLE communication_error_log
(
  error_msg VARCHAR(10240),
  error_code VARCHAR(128)  
);

Im folgenden Beispiel werden Verbindungsfehler mithilfe von sp_hook_dbmlsync_communication_error protokolliert.

CREATE PROCEDURE sp_hook_dbmlsync_communication_error()
BEGIN
 DECLARE msg VARCHAR(255);
 DECLARE code INTEGER;

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

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

 // log the error information
 INSERT INTO communication_error_log(error_code,error_msg)
  VALUES (code,msg);
END