Automation Engine Script-Leitfaden > Funktionelle Gliederung > Script-Aufbau und -Prozessierung > :SET

:SET

Script-Anweisung: Weist einer Script-Variablen einen Wert zu.

Syntax

:S[ET] Script variable = Value

Syntax	Beschreibung/Format
Script-Variable	Name der Script-Variable, die mit einem Wert versorgt werden soll. Der Name einer Script-Variablen besteht aus maximal 32 alphanumerischen Zeichen einschließlich der Sonderzeichen "$", "_", "@", "§" und "#". Umlaute sind nicht erlaubt. Das erste Zeichen des Namens darf keine Zahl sein. Im Script sind Variablen immer mit dem Kennzeichen "&" vor dem Namen anzugeben! Format: Script-Variable
Wert	Wert, welcher der Script-Variablen zugewiesen werden soll. Format: Script-Literal, Script-Variable oder Script-Funktion

Syntax

Beschreibung/Format

Script-Variable

Name der Script-Variable, die mit einem Wert versorgt werden soll.

Der Name einer Script-Variablen besteht aus maximal 32 alphanumerischen Zeichen einschließlich der Sonderzeichen "$", "_", "@", "§" und "#". Umlaute sind nicht erlaubt. Das erste Zeichen des Namens darf keine Zahl sein. Im Script sind Variablen immer mit dem Kennzeichen "&" vor dem Namen anzugeben!

Format: Script-Variable

Wert

Wert, welcher der Script-Variablen zugewiesen werden soll.
Format: Script-Literal, Script-Variable oder Script-Funktion

Anmerkungen

Beachten Sie die Besonderheiten im Umgang mit Script-Variablen.

Existiert die angegebene Variable noch nicht, so wird sie neu erstellt. In diesem Fall besitzt die Variable keinen bestimmten Datentyp.

Mit dem Scriptsprachmittel können auch arithmetische Terme aufgelöst werden. Mehr dazu siehe: Rechnen.

Werden vordefinierte Variablen in Klammern ( ) als Wert angegeben, die numerische Werte liefern (z.B.: &$CLIENT#), so werden diese automatisch in das 16-stellige Standardformat umgewandelt.

Wenn Sie mit den Scriptsprachmitteln :SET und :RSET die gleiche Scriptvariable mit unterschiedlichen Werten versorgen, dann werden diese Werte sowohl mit :SET, als auch mit :RSET gesetzt, wenn der zugehörige Job ausgeführt wird. Bei einem Wiederanlauf dieses Jobs werden die Werte von beiden Variablen jedoch durch das Scriptsprachmittel :SET gesetzt. Dies erfolgt, weil :RSET automatisch Objektwerte erstellt und :SET automatisch den Wert für den Fall eines Wiederanlaufes speichert. Dies ist eine Veränderung des Verhaltens im Vergleich zu Version 8, wo :RSET Aussagen keine Objektwerte erstellten.

Variablen, die bereits mit :SET festgelegt wurden, können mit :DEFINE nachträglich geändert werden.

Beispiele

Das Beispiel zeigt die Zuweisung eines Dateinamens zur Script-Variablen "&DATEI#".

:SET &FILE# = "L.LST.FILE"

Im Beispiel wird der Script-Variablen das aktuelle Tagesdatum zugewiesen, welches von einer Script-Funktion zurückgeliefert wird.

:SET &TODAY# = SYS_DATE(YYMMDD)

Natürlich kann eine Script-Variable auch Zahlen aufnehmen.

:SET &NUMBER# = 1

Die Zuweisung eines Wertes einer anderen Script-Variable ist ebenfalls möglich.

:SET &NR# = &NUMBER#

Siehe auch:

Script-Sprachmittel	Beschreibung
:DEFINE	Deklariert eine Script-Variable mit einem bestimmten Datentyp.
:PSET	Weist einer Objektvariablen einen Wert zu.
:RSET	Weist einer Script-Variablen einen Wert zu und speichert diesen im Aktivierungsreport.
:SET_SCRIPT_VAR	Setzt die Werte von Script-Variablen per indirektem Zugriff.

Script-Sprachmittel - Script-Aufbau und -Prozessierung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support