Isom.Services.Ediabas

 ISOM/L-Bibliothek für Serviceautoren: <br />Isom.Services.Ediabas

ISOM/L-Bibliothek
für Serviceautoren

Version 9.10.1.0 vom 25 November 2013

Namensraum Isom.Services.Ediabas

Beschreibung

Dieses Fachobjekt ermöglicht es, EDIABAS-Jobs auszuführen. Es orientiert sich dabei mit seiner Schnittstelle an der tatsächlichen Schnittstelle von EDIABAS.

Dieses Fachobjekt funktioniert nicht mit ISOM Didact. Die Funktionen zeigen keine Wirkung und/oder kehren mit dem Ergebnis 'Void' zurück.



Funktionen

Isom.Services.Ediabas.CallEdiabas

Statischer Aufruf eines EDIABAS-Jobs mit textbasierten Argumenten.

Isom.Services.EdiabasResultSetList Isom.Services.Ediabas.CallEdiabas  ( Isom.Base.String  sgbd,
Isom.Base.String  jobName,
Isom.Base.String  jobParams  )

Statischer Aufruf eines EDIABAS-Jobs mit textbasierten Argumenten.

Zu beachten:
Es wird immer der Default-N-Kanal verwendet.
Parameter:
sgbd  Name der zu verwendenden Steuergerätebeschreibungsdatei.
jobName  Name des EDIABAS-Jobs.
jobParams  Eventuelle Parameter für diesen Job. Werden keine Parameter benötigt, ist eine leere Zeichenkette zu übergeben.
Rückgabe:
Liste der EDIABAS-ResultSets.
Isom.Services.Ediabas.CallEdiabasBin

Statischer Aufruf eines EDIABAS-Jobs mit binären Argumenten (hex-codiert).

Isom.Services.EdiabasResultSetList Isom.Services.Ediabas.CallEdiabasBin  ( Isom.Base.String  sgbd,
Isom.Base.String  jobName,
Isom.Base.String  jobParams  )

Statischer Aufruf eines EDIABAS-Jobs mit binären Argumenten (hex-codiert).

Zu beachten:
Es wird immer der Default-N-Kanal verwendet.
Parameter:
sgbd  Name der zu verwendenden Steuergerätebeschreibungsdatei.
jobName  Name des EDIABAS-Jobs.
jobParams  Eventuelle Parameter für diesen Job. Werden keine Parameter benötigt, sollte CallEdiabas() verwendet werden.
   using Isom.Base.* 
   using Isom.Services.*; 
   ... 
      String sgbd   = "TMODE"; 
      String job    = "SETZE_SG_PARAMETER_ALLG"; 
      String params = "06 00 80 25 00 00 00 00 00 00 A0 0F C8 00 14 00 00 00 03 00"; 
      EdiabasResultSetList resultSetList = Ediabas.CallEdiabasBin (sgbd, job, params); 
Rückgabe:
Liste der EDIABAS-ResultSets.
Isom.Services.Ediabas.ResetTimeout

Setzt den Timeout-Wert zurück.

Isom.Base.Boolean Isom.Services.Ediabas.ResetTimeout  (  ) 

Setzt den Timeout-Wert zurück.

Alle folgenden Aufrufe von CallEdiabas und CallEdiabasBin werden ohne Timeout durchgeführt.

   using Isom.Base.* 
   using Isom.Services.*; 
   ... 
      Ediabas.SetTimeout( 10000 ); 
      EdiabasResultSetList resultSetList = Ediabas.CallEdiabas ("D_CAS", "IDENT", ""); 
      Ediabas.ResetTimeout(); 
Rückgabe:
Immer 'true'.
Isom.Services.Ediabas.RetainSession

Die Funktion 'RetainSession' bewirkt, dass die EDIABAS-Instanz nicht geschlossen wird, wenn permanent auf 'true' gesetzt wird.

Isom.Base.Boolean Isom.Services.Ediabas.RetainSession  ( Isom.Base.Boolean  permanent  ) 

Die Funktion 'RetainSession' bewirkt, dass die EDIABAS-Instanz nicht geschlossen wird, wenn permanent auf 'true' gesetzt wird.

Alle zukünftigen Ediabas-Jobs werden mit derselben Ediabas-Instanz durchgeführt. Dabei ist es unerheblich ob diese direkt (durch 'CallEdiabas' bzw. 'CallEdiabasBin') oder indirekt (also z.B. innerhalb 'CurrentVehicleContext.ReadOdometer()') aufgerufen werden.

Zu beachten:
Hinweis: Es ist nicht garantiert dass die EDIABAS-Instanz über die gesamte Sitzung geöffnet bleibt. So wird z.B. bei einem Baureihenwechsel (z.B. von 'Base' auf 'E60') ein neuer Fachdienst und damit auch eine neue EDIABAS-Instanz gestartet.
Parameter:
permanent  Gibt an, ob die EDIABAS-Instanz permanent geöffnet bleiben soll oder ob EDIABAS jedes Mal neu initialisiert und beendet wird.
   using Isom.Base.* 
   using Isom.Services.*; 
   ... 
      Ediabas.RetainSession( true ); 
      Ediabas.CallEdiabas ("mrkmsk16","seed_key","2"); 
      Ediabas.CallEdiabas ("mrkmsk16","steuern_fahrgestellnummer","WBAA0000001234567"); 
      Ediabas.CallEdiabas ("mrkmsk16","seed_key","1"); 
      Ediabas.RetainSession( false ); 
Rückgabe:
'true' im Erfolgsfall
Isom.Services.Ediabas.SetTimeout

Setzt einen Timeout-Wert für die Ausführung des EDIABAS-Jobs.

Isom.Base.Boolean Isom.Services.Ediabas.SetTimeout  ( Isom.Base.Number  timeoutValue  ) 

Setzt einen Timeout-Wert für die Ausführung des EDIABAS-Jobs.

Nach Ablauf dieser, in Millisekunden angegebenen, Zeitspanne wird versucht, den EDIABAS-Job abzubrechen. Der Wert darf nicht kleiner oder gleich '0' sein.

Zu beachten:
Der gesetzte Timeout gilt für alle folgenden Aufrufe von CallEdiabs und CallEdiabasBin. Daher muss anschließend der Timeout-Mechanismus mittels der Funktion 'ResetTimeout()' wieder deaktiviert werden.
Parameter:
timeoutValue  Zeitdauer in Millisekunden
   using Isom.Base.* 
   using Isom.Services.*; 
   ... 
   using Isom.Base.* 
   using Isom.Services.*; 
   ... 
      // Setze den Timeout für EDIABAS-Aufrufe auf 10 Sekunden 
      Ediabas.SetTimeout( 10000 ); 
      // Führe den EDIABAS-Aufruf aus 
      EdiabasResultSetList resultSetList = Ediabas.CallEdiabas ("D_CAS", "IDENT", ""); 
      // Deaktiviere den Timeout-Mechanismus 
      Ediabas.ResetTimeout(); 
Rückgabe:
'true' falls erfolgreich.

Version 9.10.1.0 vom 25 November 2013