Difference between revisions of "SAVE RECORDVIEW"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 32: Line 32:
 
<code lang="recital">
 
<code lang="recital">
 
procedure check_value
 
procedure check_value
save record view to m_recv// Validate data
+
save record view to m_recv
 +
// Validate data
 
restore recordview from m_recv
 
restore recordview from m_recv
 
return
 
return

Revision as of 13:01, 16 March 2009

SAVE RECORDVIEW

Class

Fields and Records


Purpose

Save the status of the currently active workarea to a memory variable


Syntax

SAVE RECORDVIEW TO <memvar>


See Also

ON KEY, RESTORE RECORDVIEW, SKIP, SET KEY, SET PCKEYS, REPLACE()


Description

The SAVE RECORDVIEW TO command is used to save the status of the active workarea to the specified memory variable <memvar>. The SAVE RECORDVIEW command saves the following information pertaining to the active workarea:

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

The RESTORE RECORDVIEW command may be used to restore the above information from the specified memory variable. The SAVE and RESTORE RECORDVIEW commands are particularly useful in validation and hot key procedures when you want to move off and then back on the current record. The SKIP 0 command must be used prior to a GOTO command in order to flush locked records to disk if they have been modified. SET CLIPPER must be ON for SKIP 0 to work correctly.


Example

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


Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer