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

CREATE_PROCESS

Script function: Creates a new data sequence.

Syntax

CREATE_PROCESS(Mode, [Data sequence reference 1], [Data sequence reference 2])

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.

Comments

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.

Data sequences can also be created with the PREP_PROCESS* elements.

To add one or several lines to a data sequence, use the script function PUT_PROCESS_LINE.

Afterwards read the created data sequence using GET_PROCESS_LINE. The line-by-line processing of data sequences can be executed with :PROCESS loops.

Examples

The first example shows the creation an empty data sequence. Afterwards 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#)

Script element	Description
:CLOSE_PROCESS	Discards an unnecessary data sequence.
:PROCESS... :TERM_PROCESS... :ENDPROCESS	Loop for line by line processing of a data sequence - a sequential file or a command result, for example.
GET_PROCESS_LINE	Returns the content of the current line of a data sequence.
PUT_PROCESS_LINE	Adds a line to a specific data sequence