CREATE_PROCESS

Script function: Creates a new data sequence.

Syntax

CREATE_PROCESS (Mode [[ , Data sequence1] , Data sequence2])

Syntax	Description/Format
Mode	The mode how the data sequence should be created Format: AE name Allowed values: NEW - Create a new empty data sequence JOIN - 2 data sequences combined into 1 DUPLICATE - Create a copy of an existing data sequence
Data sequence reference 1	The reference to the data sequence that should either be duplicated or combined (depending on mode). Format: script variable This parameter is only required for the JOIN or DUPLICATE Mode.
Data sequence reference 2	The reference to the data sequence that should be combined with data sequence 1. Format: script variable This parameter is only required for the JOIN Mode.

Syntax

Description/Format

Mode

The mode how the data sequence should be created
Format: AE name

Allowed values:

NEW - Create a new empty data sequence
JOIN - 2 data sequences combined into 1
DUPLICATE - Create a copy of an existing data sequence

Data sequence reference 1

The reference to the data sequence that should either be duplicated or combined (depending on mode).
Format: script variable

This parameter is only required for the JOIN or DUPLICATE Mode.

Data sequence reference 2

The reference to the data sequence that should be combined with data sequence 1.
Format: script variable

This parameter is only required for the JOIN Mode.

Return code
The reference to the newly created data sequence.

The script function creates a new data sequence and returns its reference as a return code. You use the parameter Mode to specify whether the data sequence is empty or filled with lines from other data sequences.

Tips:

You can also create data sequences with the PREP_PROCESS* script elements. For more information, see Script Elements for Data Sequences.
Use the following script elements to work with the data sequence that you create:
- PUT_PROCESS_LINE
  Adds one or several lines to the data sequence
- GET_PROCESS_LINE
  Reads the data sequence
- :PROCESS... :TERM_PROCESS... :ENDPROCESS
  Processes the data sequence line by line

Examples

The first example shows the creation an empty data sequence. Afterward 2 lines each with 3 columns are added.

:SET &HND# = CREATE_PROCESS(NEW)
:SET &LINE1# = "Test1,Test2,Test3"
:SET &RET# = PUT_PROCESS_LINE(&HND#, &LINE1#, ",")
:DEFINE &LINE2#, string, 3
:FILL &LINE2#[] = GET_VAR(TEST.VAR, KEY1)
:SET &RET# = PUT_PROCESS_LINE(&HND#, &LINE2#[],)

In the second example a data sequence is duplicated.

:SET &HND1# = PREP_PROCESS_VAR(VARA.DB,"*WIN*")
:SET &HND2# = CREATE_PROCESS(DUPLICATE,&HND1#)

The last example shows how two data sequences are combined to one.

:SET &HND1# = PREP_PROCESS_VAR(VARA.DB1,"*WIN*")
:SET &HND2# = PREP_PROCESS_VAR(VARA.DB2,,"*JOBS*",1)
:SET &HND# = CREATE_PROCESS(JOIN,&HND1#,&HND2#)