Difference between revisions of "RESTORE RECORDVIEW"
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
| (7 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Purpose== | ==Purpose== | ||
Restore a previously saved workarea status | Restore a previously saved workarea status | ||
| Line 15: | Line 8: | ||
==See Also== | ==See Also== | ||
| − | [[DO]], [[ON KEY]], [[SAVE RECORDVIEW]], [[ | + | [[@...GET]], [[DO]], [[CHANGE]], [[EDIT]], [[ON KEY]], [[READ]], [[REPLACE()]], [[RESTORE DATASESSION]], [[RESTORE GETS]], [[RESTORE MENU]], [[RESTORE SCREEN]], [[RESTSCREEN()]], [[SAVE DATASESSION]], [[SAVE GETS]], [[SAVE MENU]], [[SAVE RECORDVIEW]], [[SAVE SCREEN]], [[SAVESCREEN()]], [[SET KEY]], [[SET KEY TO]], [[SET PCKEYS]], [[SKIP]] |
| Line 21: | Line 14: | ||
The RESTORE RECORDVIEW command restores a workarea status that was previously saved to the specified <memvar> with the SAVE RECORDVIEW command. RESTORE RECORDVIEW restores the following information: | The RESTORE RECORDVIEW command restores a workarea status that was previously saved to the specified <memvar> with the SAVE RECORDVIEW command. RESTORE RECORDVIEW restores the following information: | ||
| − | *Workarea number | + | * Workarea number |
| − | *Current record number | + | * Current record number |
| − | *Current index order | + | * Current index order |
| − | *Lock status | + | * Lock status |
| − | + | * eof() status | |
| − | + | * bof() status | |
| + | * found() status | ||
| + | The SAVE and RESTORE RECORDVIEW commands are useful in validation and hot key procedures when you want to move off the current record, execute a validation procedure, and then return to the same record. The SKIP 0 command must be used prior to a GOTO command in order to flush locked records to the disk if they have been modified. | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
procedure check_value | procedure check_value | ||
| − | save recordview to m_recv | + | save recordview to m_recv |
| − | // Validate data | + | // Validate data |
| − | restore recordview from m_recv | + | restore recordview from m_recv |
return | return | ||
</code> | </code> | ||
| Line 40: | Line 35: | ||
==Products== | ==Products== | ||
| − | Recital | + | Recital Server, Recital |
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
| + | [[Category:Screen Forms]] | ||
| + | [[Category:Screen Forms Commands]] | ||
Latest revision as of 10:24, 13 June 2011
Purpose
Restore a previously saved workarea status
Syntax
RESTORE RECORDVIEW FROM <memvar>
See Also
@...GET, DO, CHANGE, EDIT, ON KEY, READ, REPLACE(), RESTORE DATASESSION, RESTORE GETS, RESTORE MENU, RESTORE SCREEN, RESTSCREEN(), SAVE DATASESSION, SAVE GETS, SAVE MENU, SAVE RECORDVIEW, SAVE SCREEN, SAVESCREEN(), SET KEY, SET KEY TO, SET PCKEYS, SKIP
Description
The RESTORE RECORDVIEW command restores a workarea status that was previously saved to the specified <memvar> with the SAVE RECORDVIEW command. RESTORE RECORDVIEW restores the following information:
- Workarea number
- Current record number
- Current index order
- Lock status
- eof() status
- bof() status
- found() status
The SAVE and RESTORE RECORDVIEW commands are useful in validation and hot key procedures when you want to move off the current record, execute a validation procedure, and then return to the same record. The SKIP 0 command must be used prior to a GOTO command in order to flush locked records to the disk if they have been modified.
Example
procedure check_value save recordview to m_recv // Validate data restore recordview from m_recv return
Products
Recital Server, Recital
