Difference between revisions of "SAVE RECORDVIEW"
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
| (9 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Purpose== | ==Purpose== | ||
Save the status of the currently active workarea to a memory variable | Save the status of the currently active workarea to a memory variable | ||
| Line 11: | Line 4: | ||
==Syntax== | ==Syntax== | ||
| − | SAVE RECORDVIEW TO <memvar> | + | SAVE RECORDVIEW [ TO <memvar>] |
| − | + | ||
==See Also== | ==See Also== | ||
| − | [[ON KEY]], [[RESTORE RECORDVIEW]], [[ | + | [[@...GET]], [[CHANGE]], [[EDIT]], [[ON KEY]], [[READ]], [[REPLACE()]], [[RESTORE DATASESSION]], [[RESTORE GETS]], [[RESTORE MENU]], [[RESTORE RECORDVIEW]], [[RESTORE SCREEN]], [[RESTSCREEN()]], [[SAVE GETS]], [[SAVE MENU]], [[SAVE DATASESSION]], [[SAVE GETS]], [[SAVE MENU]], [[SAVE SCREEN]], [[SAVESCREEN()]], [[SET CLIPPER]], [[SET KEY]], [[SET PCKEYS]], [[SKIP]] |
| Line 21: | Line 13: | ||
The SAVE RECORDVIEW TO command is used to save the status of the active workarea to the specified memory variable <memvar>. The SAVE RECORDVIEW command saves the following information pertaining to the active workarea: | The SAVE RECORDVIEW TO command is used to save the status of the active workarea to the specified memory variable <memvar>. The SAVE RECORDVIEW command saves the following information pertaining to the active workarea: | ||
| − | *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 RESTORE RECORDVIEW command may be used to restore the above information from the specified memory variable. The SAVE and RESTORE RECORDVIEW commands are particularly useful in validation and hot key procedures when you want to move off and then back on the current record. The SKIP 0 command must be used prior to a GOTO command in order to flush locked records to disk if they have been modified. | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
procedure check_value | procedure check_value | ||
| − | save record view to m_recv | + | save record view to m_recv |
| − | // Validate data | + | // Validate data |
| − | restore recordview from m_recv | + | restore recordview from m_recv |
return | return | ||
</code> | </code> | ||
| Line 40: | Line 34: | ||
==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:23, 13 June 2011
Purpose
Save the status of the currently active workarea to a memory variable
Syntax
SAVE RECORDVIEW [ TO <memvar>]
See Also
@...GET, CHANGE, EDIT, ON KEY, READ, REPLACE(), RESTORE DATASESSION, RESTORE GETS, RESTORE MENU, RESTORE RECORDVIEW, RESTORE SCREEN, RESTSCREEN(), SAVE GETS, SAVE MENU, SAVE DATASESSION, SAVE GETS, SAVE MENU, SAVE SCREEN, SAVESCREEN(), SET CLIPPER, SET KEY, SET PCKEYS, SKIP
Description
The SAVE RECORDVIEW TO command is used to save the status of the active workarea to the specified memory variable <memvar>. The SAVE RECORDVIEW command saves the following information pertaining to the active workarea:
- Workarea number
- Current record number
- Current index order
- Lock status
- eof() status
- bof() status
- found() status
The RESTORE RECORDVIEW command may be used to restore the above information from the specified memory variable. The SAVE and RESTORE RECORDVIEW commands are particularly useful in validation and hot key procedures when you want to move off and then back on the current record. The SKIP 0 command must be used prior to a GOTO command in order to flush locked records to disk if they have been modified.
Example
procedure check_value save record view to m_recv // Validate data restore recordview from m_recv return
Products
Recital Server, Recital
