Difference between revisions of "SAVE RECORDVIEW"

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

Revision as of 13:33, 26 May 2009

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, REPLACE(), RESTORE RECORDVIEW, SET CLIPPER, SET KEY, SET PCKEYS, SKIP


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