CREATE_PROCESS

Use the CREATE_PROCESS script function to create a data sequence. The script function returns a reference to the data sequence created. The script function lets you 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

Syntax

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

Parameters

CREATE_PROCESS
Creates a data sequence
Mode
Specifies how the data sequence is created
Allowed values:
- NEW
  Creates an empty, new data sequence
- JOIN
  Combines two data sequences
- DUPLICATE
  Copies an existing data sequence
Data sequence reference 1
(JOIN and DUPLICATE modes only) Reference to the data sequence to combine or duplicate
Data sequence reference 2
(JOIN mode only) Reference to the data sequence to combine with the first data sequence

Examples

The following example creates an empty data sequence. The script adds 2 lines with 3 columns each to the data sequence. The second line is filled with values retrieved from a VARA object.

: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#[],)

The following example creates a duplicate of an existing data sequence.

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

The following example creates a new data sequence by combining two existing data sequences.

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