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. |
|
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 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 |
|---|---|
|
Discards a data sequence within a script. |
|
|
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. |
|
Returns the content of the current line of a data sequence. |
|
| LOAD_PROCESS | Loads a stored data sequence. |
Script Elements - Data Sequences
About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by Function