Revision as of 13:51, 16 March 2009

RESTORE RECORDVIEW

Class

Fields and Records

Purpose

Restore a previously saved workarea status

Syntax

RESTORE RECORDVIEW FROM <memvar>

See Also

DO, ON KEY, SAVE RECORDVIEW, SKIP, SET KEY, SET KEY TO, SET PCKEYS, REPLACE()

Description

The RESTORE RECORDVIEW command restores a workarea status that was previously saved to the specified <memvar> with the SAVE RECORDVIEW command. RESTORE RECORDVIEW restores the following information:

• Workarea number
• Current record number
• Current index order
• Lock status

The SAVE and RESTORE RECORDVIEW commands are useful in validation and hot key procedures when you want to move off the current record, execute a validation procedure, and then return to the same record. The SKIP 0 command must be used prior to a GOTO command in order to flush locked records to the disk if they have been modified. SET CLIPPER must be ON for SKIP 0 to work correctly.

Example

procedure check_value
save recordview to m_recv
// Validate data
restore recordview from m_recv
return

Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer