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.

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, load the data sequence with a script by specifying this term. For more information, see LOAD_PROCESS.

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

Note: SAVE_PROCESS stores the data sequence, but does not close it. You still need to include a script function to close the data sequence. For more information, see :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. For more information, see Variables Page. 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 report.

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

See also: