SAVE RECORDVIEW

From Recital Documentation Wiki
Revision as of 03:53, 3 June 2011 by Barrymavin (Talk | contribs)

Jump to: navigation, search

Purpose

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


Syntax

SAVE RECORDVIEW [ TO <memvar>]

See Also

@...GET, CHANGE, EDIT, ON KEY, READ, 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 Server, Recital