PUSH DATASESSION

From Lianjapedia
Jump to: navigation, search

Purpose

Save the current data session

Syntax

PUSH DATASESSION

See Also

DATASESSIONLEVEL(), POP DATASESSION, RESTORE DATASESSION, RESTORE RECORDVIEW, SAVE DATASESSION, SAVE RECORDVIEW

Description

The PUSH DATASESSION command is used to save the current data session. It can then be restored using the POP DATASESSION command. Data sessions can be pushed and popped up to 256 levels deep and operate on a last in, first out basis. All tables are closed by the PUSH DATASESSION command.

The SAVE DATASESSION and RESTORE DATASESSION commands can also be used to save and restore the current data session, optionally saving and restoring from a memory variable.

Example

? datasessionlevel()  // returns 0
// save the current data session
push datasession
? datasessionlevel()  // returns 1
// Carry out other operations with different data
// then save this second data session
push datasession
? datasessionlevel()  // returns 2
// Carry out other operations with different data
// then restore the second data session
pop datasession
? datasessionlevel()  // returns 1
// Carry out other operations with different data
// then restore the original data session
pop datasession
? datasessionlevel()  // returns 0