Purpose

SET_CURR is used to select the initial cursor position within a set of records. 
 

Syntax

SET_CURR (key_var)
 

Control

key_var is part of a key for the primary file being examined.
 

Remarks

SET_CURR can be used to locate the cursor using a partial key (i.e. the entire value of the key does not need to be known, only an initial subset).

Since SET_CURR only positions the cursor, it does not matter how the records were selected. 

The records could be the primary file, or could be a subset selected by SEL-ONLY, SEL-PARTIAL, or SEL_RANGE.

Unlike the SEL commands, SET_CURR can position the cursor based on a search for records in files that have multiple keys, without the requirement to initialise preceding it.  For example, if SEL-PARTIAL uses the first two available keys to select records from a primary file, then SET_CURR can use the third key, or the fourth key, or any other key downstream from the first two (even if the intermediate keys are not initialized).

The use of SET_CURR, like the SEL commands, can be used only in logic in the Key Mapping on Sort/Select event process point.  However, it can be used any time you need to display data on a defined data set on a paging screen.
 

Example