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#)

See also: