Script Statement: It writes the content of a data sequence to a static Variable object.
Syntax
:PUT_VAR_PROCESS Variable, Data Sequence Reference
|
Syntax |
Description/Format |
|---|---|
|
Variable |
The name of the static Variable object in which the values should be stored
. |
|
Data Sequence Reference |
The reference of the data sequence whose content should be written to the variable.
|
Comments
You can use this script element in order to fill a static variable with the content of a data sequence. The columns of the data sequence are written to the columns of the Variable object (including the Key column).
Keep the following in mind:
- The script element :PUT_VAR_PROCESS removes all entries of the Variable object before it re-fills it. The result is that the Variable object will include the exact entries of the data sequence once you have successfully run this script element.
- Static Variable objects include 6 columns (the Key column plus five value columns). The script element :PUT_VAR_PROCESS fills these columns with the first 6 columns of the data sequence. This means that when the data sequence includes more than 6 columns, these will be ignored.
- When :PUT_VAR_PROCESS tries to write in variable values which are not accepted because they duplicate a key or there is only one accepted entry, it returns the error number 20683 via sys_last_err_nr() and the location of error via sys_last_err_ins().
You cannot specify dynamic Variable objects because they retrieve their values dynamically and do not store them statically.
Note that certain rules and limitations apply to the values of static Variable objects.
See also:
| Script Element | Description |
|---|---|
| :PUT_VAR | Stores value in a static Variable object. |
| :DELETE_VAR | Deletes one or all values of a static Variable object. |
| GET_VAR | This returns the value of a Variable object. |
|
|