SAVE_PROCESS

ScriptEigener Objekttyp in der Automation Engine Function: Stores a certain data sequence.

Syntax

SAVE_PROCESS(Data sequence reference)

Syntax	Description/Format
Data sequence	The reference to the data sequence that should be stored. Format: script variable

Return Code
The term under which the data sequence is stored.

Comments

This script function stores a certain data sequence for the activity in the AE database. This ensures that other tasks can access this data sequence.

The return code is a term that is composed of the name of the data sequence's reference. To use stored data sequences in other tasks, you must load them with the script element LOAD_PROCESS by specifying this term.

You can load stored data sequences as often as you like from any tasks of your choice.

Note that SAVE_PROCESS stores the data sequence but it does not close it. This means that you still need to use the script element CLOSE_PROCESS.

The data sequences remain available until the statistical records of the tasks that have been used to store them will be reorganized.

Examples

The two Script objects SCRI.TEST.DS1 and SCRI.TEST.DS2 will be processed in a workflow one after the other.

The first task SCRI.TEST.DS1 creates a new data sequence and stores it to the AE database. The RunID"Kurzform für ""laufende Nummer"". Hierbei handelt es sich genauer um eine Zahl, welche die Durchführung einer Aufgabe eindeutig kennzeichnet. Die RunID kann zwischen 7 und 10 Stellen aufweisen. Sie wird von der Komponente Automation Engine vergeben." of the task and the internal name of the stored data sequence are made available to the workflow by using object variables. Finally, the data sequence is closed by using the following script:

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

The second task SCRI.TEST.DS2 inherits the workflow's object variables. This information is used to load the data sequence, read its content and write it to the activation protocol.

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

Script Element	Description
:CLOSE_PROCESS	Discards a data sequence within a script.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	The definition of a loop for the line by line processing of a data sequence such as the content of a sequential file or the text result of a command.
CREATE_PROCESS	Creates a new data sequence.
GET_PROCESS_LINE	Returns the content of the current line of a data sequence.
LOAD_PROCESS	Loads a stored data sequence.