RESTORE DATASESSION

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

Jump to: navigation, search

Purpose

Save the status of the current data session


Syntax

RESTORE DATASESSION [ FROM <memvar>]

See Also

@...GET, CHANGE, EDIT, ON KEY, READ, REPLACE(), RESTORE RECORDVIEW, SAVE DATASESSION, SET CLIPPER, SET KEY, SET PCKEYS, SKIP


Description

The RESTORE DATASESSION command is used to restore the status of all open tables. The RESTORE DATASESSION command restores the following context pertaining to the saved session (See SAVE DATASESSION):

  • Currently selected workarea
  • Workarea number
  • database name
  • full path of table
  • all index files
  • Current record number
  • Current index order
  • Lock status
  • eof() status
  • bof() status
  • found() status

The SAVE DATASESSION command may be used to save the above information. SAVE and RESTORE DATASESSION can be used with Recital Wen session variables to maintain context between different .rsp web page requests.

Example

procedure check_value
  save datasession
  close all
  // open up some new tables using a new datasession
  restore datasession
return


Products

Recital, Recital Web