Difference between revisions of "RESTORE RECORDVIEW"

From Recital Documentation Wiki
Jump to: navigation, search
(Description)
Line 14: Line 14:
 
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:
 
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
+
* Workarea number
*Current record number
+
* Current record number
*Current index order
+
* Current index order
*Lock status
+
* Lock status
 
+
* eof() 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.
+
* 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==
 
==Example==

Revision as of 03:57, 3 June 2011

Purpose

Restore a previously saved workarea status


Syntax

RESTORE RECORDVIEW FROM <memvar>


See Also

@...GET, DO, CHANGE, EDIT, ON KEY, READ, REPLACE(), SAVE RECORDVIEW, 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