Difference between revisions of "RESTORE RECORDVIEW"

From Recital Documentation Wiki
Jump to: navigation, search
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==Class==
 
Fields and Records
 
 
 
 
==Purpose==
 
==Purpose==
 
Restore a previously saved workarea status
 
Restore a previously saved workarea status
Line 12: Line 8:
  
 
==See Also==
 
==See Also==
[[DO]], [[ON KEY]], [[REPLACE()]], [[SAVE RECORDVIEW]], [[SET KEY]], [[SET KEY TO]], [[SET PCKEYS]], [[SKIP]]
+
[[@...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]]
  
  
Line 18: 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==
Line 37: Line 35:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Screen Forms]]
 +
[[Category:Screen Forms Commands]]

Latest revision as of 10:24, 13 June 2011

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