The array insert feature for network and mainframe environments improves application performance by allowing iterative requests to be grouped together into a single step, resulting in a decrease of the step‑processing overhead per request. Only single INSERT statements and references to arrays of variables are supported. References to arrays of structures are not supported.
To accommodate this feature, the EXEC SQL statement is modified to:
EXEC SQL FOR (<countval) <sql statement string>;
FORindicates that this is an array statement
Note: Ensure that <countval> does not exceed the smallest defined dimension in the list of arrays. An error is generated if this condition is violated and countval is specified as a literal. At precompile time, no check is made when countval is specified as a variable.
Literal integer constants that are embedded in the SQL string are not iterated; they are propagated in every inserted row.
The same host variable can be specified for two or more fields. Any given iteration will obtain the same value.
EXEC SQL BEGIN DECLARE SECTION;
long cNewEmployees = 50;
short e_nameind = 0, e_numind =0, e_salind =-1;
EXEC SQL END DECLARE SECTION;
EXEC SQL PREPARE exInsert01 FROM insert into employee values (?, ?, ?);
EXEC SQL FOR cNewEmployees
EXECUTE exInsert01 USING :empname, :empnum, :empsal;