Difference between revisions of "RESTORE RECORDVIEW"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 1: Line 1:
=RESTORE RECORDVIEW=
 
 
 
 
==Class==
 
==Class==
 
Fields and Records
 
Fields and Records
Line 15: Line 12:
  
 
==See Also==
 
==See Also==
[[DO]], [[ON KEY]], [[SAVE RECORDVIEW]], [[SKIP]], [[SET KEY]], [[SET KEY TO]], [[SET PCKEYS]], [[REPLACE()]]
+
[[DO]], [[ON KEY]], [[REPLACE()]], [[SAVE RECORDVIEW]], [[SET KEY]], [[SET KEY TO]], [[SET PCKEYS]], [[SKIP]]
  
  
Line 32: Line 29:
 
<code lang="recital">
 
<code lang="recital">
 
procedure check_value
 
procedure check_value
save recordview to m_recv
+
  save recordview to m_recv
// Validate data
+
  // Validate data
restore recordview from m_recv
+
  restore recordview from m_recv
 
return
 
return
 
</code>
 
</code>

Revision as of 15:43, 26 May 2009

Class

Fields and Records


Purpose

Restore a previously saved workarea status


Syntax

RESTORE RECORDVIEW FROM <memvar>


See Also

DO, ON KEY, 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

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