Automation Engine Script-Leitfaden > Funktionelle Gliederung > Datensequenzen > SAVE_PROCESS

SAVE_PROCESS

Script-Funktion: Speichert eine bestimmte Datensequenz.

Syntax

SAVE_PROCESS(Data sequence reference)

Syntax	Beschreibung/Format
Datensequenz	Referenz auf die Datensequenz, die gespeichert werden soll. Format: Script-Variable

Rückgabewert
Begriff, unter dem die Datensequenz abgelegt wird.

Anmerkungen

Die Script-Funktion speichert eine bestimmte Datensequenz für die Aktivität in der Datenbank. Dadurch können andere Aufgaben auf diese Datensequenz zugreifen.

Als Rückgabewert wird ein Begriff zurückgeliefert, der sich aus dem Namen der Datensequenz-Referenz zusammensetzt. Um gespeicherte Datensequenzen in anderen Aufgaben verwenden zu können, sind diese zuerst mit dem Sprachmittel LOAD_PROCESS unter Angabe dieses Begriffs zu laden.

Gespeicherte Datensequenzen können beliebig oft von beliebigen Aufgaben geladen werden.

Beachten Sie, dass SAVE_PROCESS die Datensequenz zwar speichert, jedoch nicht automatisch schließt. Die Verwendung des Sprachmittels CLOSE_PROCESS ist daher nach wie vor notwendig!

Die Datensequenzen bleiben bis zur Reorganisation der Statistiksätze jener Aufgaben erhalten, über welche sie gespeichert wurden.

Beispiele

Zwei Script-Objekte SCRI.TEST.DS1 und SCRI.TEST.DS2 werden in einem Workflow hintereinander ausgeführt.

Die erste Aufgabe SCRI.TEST.DS1 erstellt eine neue Datensequenz und speichert diese in die Datenbank. Die RunID der Aufgabe und der interne Name der gespeicherten Datensequenz werden dem Workflow via Objektvariablen zur Verfügung gestellt. Zum Abschluss wird die Datensequenz geschlossen. Dies wird schließlich mit folgendem Script bewerkstelligt:

:SET &HND# = PREP_PROCESS_VAR(VARA.DB)
:PSET &HND_KEY# = SAVE_PROCESS(&HND#)
:PSET &RUNID# = SYS_ACT_ME_NR()
:CLOSE_PROCESS &HND#

Die zweite Aufgabe SCRI.TEST.DS2 erbt die Objektvariablen des Workflows. Mit Hilfe dieser Informationen wird die Datensequenz geladen, deren Inhalt ausgelesen und im Aktivierungsprotokoll ausgegeben.

:SET &HND# = LOAD_PROCESS(&RUNID#,&HND_KEY#)
:PROCESS &HND#
: SET &LINE# = GET_PROCESS_LINE(&HND#,2)
: P &LINE#
:ENDPROCESS
:CLOSE_PROCESS &HND#

Siehe auch:

Script-Sprachmittel	Beschreibung
:CLOSE_PROCESS	Verwirft eine Datensequenz innerhalb eines Scripts.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	Definition einer Schleife zur zeilenweisen Bearbeitung einer Datensequenz, wie beispielsweise den Inhalt einer sequentiellen Datei oder das textmäßige Ergebnis eines Kommandos.
CREATE_PROCESS	Erstellt ein neue Datensequenz.
GET_PROCESS_LINE	Ermittelt den aktuellen Zeileninhalt einer Datensequenz.
LOAD_PROCESS	Lädt eine gespeicherte Datensequenz.

Script-Sprachmittel - Datensequenzen

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