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