Difference between revisions of "RESTORE DATASESSION"

From Lianjapedia
Jump to: navigation, search
m (1 revision)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Save the status of the current data session
 
Save the status of the current data session
 
  
 
==Syntax==
 
==Syntax==
Line 7: Line 6:
  
 
==See Also==
 
==See Also==
[[@...GET]], [[CHANGE]], [[EDIT]], [[ON KEY]], [[READ]], [[REPLACE()]], [[RESTORE RECORDVIEW]], [[SAVE DATASESSION]], [[SET CLIPPER]], [[SET KEY]], [[SET PCKEYS]], [[SKIP]]
+
[[REPLACE()]], [[RESTORE RECORDVIEW]], [[SAVE DATASESSION]], [[SET CLIPPER]], [[SKIP]]
 
+
  
 
==Description==
 
==Description==
Line 46: Line 44:
 
restore datasession from statevar
 
restore datasession from statevar
 
</code>
 
</code>
 
+
==Products==
+
Recital, Recital Web
+
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 
[[Category:Screen Forms]]
 
[[Category:Screen Forms]]
 
[[Category:Screen Forms Commands]]
 
[[Category:Screen Forms Commands]]

Revision as of 09:08, 16 November 2011

Purpose

Save the status of the current data session

Syntax

RESTORE DATASESSION [ FROM <memvar>]

See Also

REPLACE(), RESTORE RECORDVIEW, SAVE DATASESSION, SET CLIPPER, 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 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 SAVE DATASESSION command may be used to save 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

save datasession
close all
 
// open up some new tables in a new datasession
 
restore datasession
save datasession to statevar
_session[ "statevar" ] = statevar
 
// you can then restore the session on the next web page request like this
 
statevar = _session[ "statevar" ]
restore datasession from statevar