In der folgenden Tabelle stellt die Beschreibung den SQL-Datentyp bereit. Wenn Sie Ihr Skript in Java oder .NET schreiben, müssen Sie den entsprechenden Datentyp verwenden. Siehe SQL-Java-Datentypen und SQL-.NET-Datentypen.

In SQL-Skripten können Sie Ereignisparameter mit ihrem Namen oder mit einem Fragezeichen angeben. Die Verwendung von Fragezeichen ist veraltet und es wird empfohlen, benannte Parameter zu verwenden. Sie können nicht Namen und Fragezeichen in einem Skript mischen. Wenn Sie Fragezeichen verwenden, müssen die Parameter in der unten gezeigten Reihenfolge stehen und sind nur dann optional, wenn keine nachfolgenden Parameter angegeben wurden. (Sie müssen beispielsweise Parameter 1 verwenden, wenn Sie Parameter 2 verwenden möchten.) Wenn Sie benannte Parameter verwenden, können Sie beliebige Teilmengen der Parameter in beliebiger Reihenfolge angeben.

Der MobiLink-Server wählt eine Standardaktion. Sie können die Aktion im Skript ändern und einen Wert zurückgeben, der MobiLink anweist, wie fortgefahren werden soll. Der action_code-Parameter hat einen der folgenden Werte:

Der MobiLink-Server sendet im aktuellen Aktionscode. Anfangs ist dieser für jede Gruppe von Fehlern, die durch einen SQL-Vorgang verursacht wurden, auf 3000 festgelegt. Normalerweise tritt pro SQL-Vorgang nur ein Fehler auf, es können jedoch auch mehr sein. Wenn Zeilen in Batches hochgeladen werden, wird dieses Skript handle_error einmal pro Fehler im Batch aufgerufen. Während derselben Synchronisation wird der Aktionscode 3000 in den ersten Fehler übergeben. Nachfolgende Aufrufe werden in den Aktionscode übergeben, der vom vorigen Aufruf zurückgegeben wurde. Bei mehreren Aufrufen verwendet MobiLink den nummerisch höchsten Wert.

Weitere Hinweise zu Batch-Uploads von Zeilen finden Sie unter mlsrv16-Option -s .

Sie können den Aktionscode im Skript ändern und einen Wert zurückgeben, der MobiLink anweist, wie weitergearbeitet werden soll. Der Aktionscode vermittelt dem MobiLink-Server, was als Nächstes zu tun ist. Bevor der MobiLink-Server dieses Skript aufruft, setzt er den Aktionscode auf einen Standardwert, der davon abhängt, wie schwerwiegend der Fehler ist. Ihr Skript kann diesen Wert ändern. Ihr Skript muss einen Aktionscode zurückgeben.

Anhand des Fehlercodes und der Fehlermeldung können Sie die Art des Fehlers bestimmen.

Der MobiLink-Server führt dieses Skript aus, wenn ein ODBC-Fehler auftritt, während MobiLink ein Einfügungs-, Aktualisierungs- oder Lösch-Skript während des Uploads verarbeitet oder Downloadzeilen abruft. Wenn ein ODBC-Fehler zu einem anderen Zeitpunkt auftritt, ruft der MobiLink-Server das Skript report_error oder report_ODBC_error auf und bricht die Synchronisation ab.

Ist der Fehler aufgetreten, während eine bestimmte Tabelle bearbeitet wurde, wird der Tabellenname geliefert. Andernfalls ist dieser Wert NULL. Der Tabellenname ist der Name einer Tabelle in der Clientanwendung. Dieser Name verfügt möglicherweise nicht über eine direkte Entsprechung in der konsolidierten Datenbank, je nachdem, wie Ihre entfernten Tabellennamen den konsolidierten Tabellen zugeordnet werden.

SQL-Skripten für das Ereignis handle_error müssen als gespeicherte Prozedur implementiert werden.

Sie können einen Wert aus dem Skript handle_error folgende Arten zurückgeben.

Die Beispielanwendung CustDB enthält Fehlerbehandlungsroutinen für verschiedene Datenbank-Managementsysteme.

• Skriptparameter
• Hinzufügungen und Löschungen von Skripten
• report_error (Verbindungsereignis)
• report_odbc_error (Verbindungsereignis)
• handle_odbc_error (Verbindungsereignis)
• Entfernte IDs und MobiLink-Benutzernamen in Skripten
• Datenskripten

Das folgende Beispiel eignet sich für eine konsolidierte SQL Anywhere-Datenbank. Es gestattet Ihrer Anwendung, redundante Einfügungen zu ignorieren.

Der nachfolgende Aufruf einer MobiLink-Systemprozedur weist die gespeicherte Prozedur ULHandleError dem Ereignis handle_error zu.

CALL ml_add_connection_script(
    'ver1',
    'handle_error',
    'CALL ULHandleError(
      {ml s.action_code}, 
      {ml s.error_code}, 
      {ml s.error_message}, 
      {ml s.username}, 
      {ml s.table} )' )

Die folgende SQL-Anweisung erstellt die gespeicherte Prozedur ULHandleError.

CREATE PROCEDURE ULHandleError(
   INOUT action integer,
   IN error_code integer,
   IN error_message varchar(1000),
   IN user_name varchar(128),
   IN table_name varchar(128) )
BEGIN
  -- -196 is SQLE_INDEX_NOT_UNIQUE
  -- -194 is SQLE_INVALID_FOREIGN_KEY
  IF error_code = -196 or error_code = -194 then
      -- ignore the error and keep going
      SET action = 1000;
  ELSE
      -- abort the synchronization
      SET action = 3000;
  END IF;
END

Der folgende Aufruf einer MobiLink-Systemprozedur registriert eine Java-Methode namens handleError als das Skript für das Verbindungsereignis handle_error, wenn die Skriptversion ver1 synchronisiert wird.

CALL ml_add_java_connection_script(
    'ver1',
    'handle_error',
    'ExamplePackage.ExampleClass.handleError' )

Im Folgenden sehen Sie die Java-Beispielmethode handleError. Sie verarbeitet einen Fehler basierend auf den Daten, die übergeben werden. Außerdem legt sie den sich daraus ergebenden Fehlercode fest.

package ExamplePackage;
public class ExampleClass
{
    public void handleError( ianywhere.ml.script.InOutInteger	actionCode,
			     int				errorCode,
			     String				errorMessage,
			     String				user,
			     String				table ) 
    {
	// -196 is SQLE_INDEX_NOT_UNIQUE
	// -194 is SQLE_INVALID_FOREIGN_KEY
	if( errorCode == -196 || errorCode == -194 ) {
	    // ignore the error and keep going
	    actionCode.setValue( 1000 );
	} else {
	    // abort the synchronization
	    actionCode.setValue( 3000 );
	}
    }	
}

Der folgende Aufruf einer MobiLink-Systemprozedur registriert eine .NET-Methode namens HandleError als das Skript für das Verbindungsereignis handle_error, wenn die Skriptversion ver1 synchronisiert wird.

CALL ml_add_dnet_connection_script(
  'ver1',
  'handle_error',
  'TestScripts.Test.HandleError' )

Im Folgenden sehen Sie die .NET-Beispielmethode HandleError.

namespace TestScripts
{
    public class Test
    {
	public void HandleError( ref int 	actionCode,
				 int		errorCode,
				 string		errorMessage,
				 string		user,
				 string		table ) 
	{
	    // -196 is SQLE_INDEX_NOT_UNIQUE
	    // -194 is SQLE_INVALID_FOREIGN_KEY
	    if( errorCode == -196 || errorCode == -194 ) {
		// ignore the error and keep going
		actionCode = 1000;
	    } else {
		// abort the synchronization
		actionCode = 3000;
	    }
	}	
    }
}