Usage (Magic xpa 3.x)

The Usage property is enabled only when the Position property is not 0.

These properties are relevant only for the Main Source of the task. The linked tables cannot be ranged or located according to their position.

Once the Position was selected, the Usage property will enable selecting from these options:

Range On (default) – Lets you enter an expression that indicates the position of a single record to which the task displays. Magic xpa will perform a get current operation, and no open cursor.

Range From – Lets you enter an expression that indicates the position of the record from which the task will range. Magic xpa will perform an open cursor with this position as start position.

For both the range options, there will be an AND operation between the range on the variables, the range expression on the task and this condition.

For both the range options, if the record does not exist - no records are displayed.

Locate – Lets you enter an expression that indicates that all records (according to all other task ranges) will be displayed, and Magic xpa will locate on the record with the specified position.

There will be an AND operation between the locate on the variable, the locate expression on the task and this condition.

If this record does not exist - the locate operation will fail (“Record not found - positioning at beginning” warning message is displayed.