Script-Variablen

Erste Schritte

JCL

---

Script-Funktionen

Ziele:
- Script-Funktion aufrufen
- Rückgabewert der Funktion in eine Script-Variable speichern
- Variable im Aktivierungsprotokoll ausgeben

Lektion 4

Script-Funktionen sind AE-Sprachmittel, die Rückgabewerte liefern. Viele Funktionen liefern nicht nur Werte, sondern führen auch bestimmte Aktionen aus. Script-Funktionen dürfen nicht am Zeilenbeginn stehen und können somit nur im Zusammenhang mit Script-Anweisungen verwendet werden. Sie werden im Script-Editor des UserInterface rot hervorgehoben.
Der Funktions-Name ist gefolgt von Klammern ( ), die Parameter enthalten können.

In folgender Lektion werden wir eine Rechenoperation mit Hilfe einer Script-Funktionen durchführen.

Zuerst erstellen wir eine Script-Variable mit dem Datentyp "float" (siehe auch Lektion 3).

:DEFINE &result#, float

Danach verwenden wir die Script-Funktion DIV um eine Division durchzuführen. Die Funktion besitzt 2 Parameter: Zahl 1 und 2.
Zahl 1 wird dabei durch Zahl 2 dividiert. Rückgabewert der Funktion ist das Ergebnis der Divison. Dieses speichern wir in eine Script-Variable, wodurch die Script-Anweisung :SET notwendig ist.

Wenn wir nun Script-Anweisung :SET, Script-Variable &ergebnis# und Script-Funktion DIV kombinieren, erhalten wir folgende Zeile:

:SET &result# = DIV(1,4)

Nun wollen wir das Ergebnis im Aktivierungsprotokoll ausgeben.

:PRINT "Result: 1/4 = &result#" 

Ergebnis im Aktivierungs-Report:

2011-04-06 14:48:17 - U0020408 Result: 1/4 = +0000000000000000.2500000000000000

Ein weiteres Beispiel für eine Script-Funktion ist FORMAT, mit der Sie nun das Ergebnis der Division formatieren können. In unserem Fall entfernen wir unnötige führende und abschließende Nullen.

:SET &format# = FORMAT(&result#,"0.00")
:PRINT "Formatted result: &format#" 

Aktivierungsprotokoll:

2011-04-06 14:48:17 - U0020408 Formatted result:0.25