Difference between revisions of "SAVE DATASESSION"

From Recital Documentation Wiki
Jump to: navigation, search
(Description)
(Description)
Line 13: Line 13:
 
The SAVE DATASESSION command is used to save the status of all open database tables.  The SAVE DATASESSION command saves the following information pertaining to the current session for each open table:
 
The SAVE DATASESSION command is used to save the status of all open database tables.  The SAVE DATASESSION command saves the following information pertaining to the current session for each open table:
  
* Currently selected workarea
+
* Currently selected cursor/workarea
* Workarea number  
+
* Cursor/Workarea number  
* database name
+
* Database name
* full path of table  
+
* Full path of table  
* all index files
+
* All index files
 
* Current record number
 
* Current record number
 
* Current index order
 
* Current index order

Revision as of 07:32, 3 June 2011

Purpose

Save the status of the current data session


Syntax

SAVE DATASESSION [ TO <memvar>]

See Also

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


Description

The SAVE DATASESSION command is used to save the status of all open database tables. The SAVE DATASESSION command saves the following information pertaining to the current session for each open table:

  • Currently selected cursor/workarea
  • Cursor/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 RESTORE DATASESSION command may be used to restore the above information. SAVE and RESTORE DATASESSION can be used with Recital Web session variables ( _SESSION[ ] ) 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