Automation Engine Script Guide > Ordered by Function > Data Sequences > SAVE_PROCESS

SAVE_PROCESS

Script 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 databaseA database is an organized collection of data including relevant data structures.. 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 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# 

 

See also:

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.

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function