RESTORE RECORDVIEW

Purpose

Restore a previously saved workarea status

Syntax

RESTORE RECORDVIEW FROM <memvar>

See Also

@...GET, DO, CHANGE, EDIT, ON KEY, READ, REPLACE(), RESTORE DATASESSION, RESTORE GETS, RESTORE MENU, RESTORE SCREEN, RESTSCREEN(), SAVE DATASESSION, SAVE GETS, SAVE MENU, SAVE RECORDVIEW, SAVE SCREEN, SAVESCREEN(), SET KEY, SET KEY TO, SET PCKEYS, SKIP

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
• eof() status
• bof() status
• found() 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.

Example

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

Products

Recital Server, Recital