The //START-SELECTION statement is used to select records which satisfy a predefined selection condition. The edited records are stored in a separate work file for each selection condition; each file is identified by a number.
This takes place in one step, i.e. each input file is read only once.
The output result of the statement is the number of edited records per work file.
START-SELECTION | ||||||||||||||||||||
| ||||||||||||||||||||
FROM-FILE = 0 / <integer 0..9> / *INPUT-FILES
Source of the records.
FROM-FILE = 0 / <integer 0..9>
The records are selected from the work file with the specified number.
FROM-FILE = *INPUT-FILES
The records are selected from the SATUT input files that were selected in the SELECT-INPUT-FILES statement.
TO-FILE = *PARAMETERS(...)
This specifies the condition and the output destination after editing.
FILE = 0 / <integer 0..9>
This specifies the work file to which the selected records are to be written.
CONDITION-NAME = <name 1..8>
The name of the selection condition that was specified in the //ADD-SELECTION-CONDITIONS statement.
Notes
If a work file that is specified for output in the TO-FILE operand has already been used in a SATUT run, it will be overwritten.
If the same file is specified in the FROM-FILE and TO-FILE operands, the work file will be overwritten.
Example
Records from the input files are selected according to selection condition COND1 and are stored in work file 3.
//start-selection from-file=*input-files, -// to-file=*parameters(file=3,condition=cond1)
The output result of the statement is the number of edited records:
SAE7001: START-SELECTION TERMINATED.‘123‘ RECORDS SELECTED IN WORK
FILE‘3‘