Difference between revisions of "SAVEGETS()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Class==
 
Screen Forms
 
 
 
 
==Purpose==
 
==Purpose==
 
Save status of current GETS
 
Save status of current GETS
Line 12: Line 8:
  
 
==See Also==
 
==See Also==
[[@...GET]], [[CLEAR GETS]], [[FMT()]], [[READ]], [[RESTGETS()]], [[RESTORE GETS]], [[RESTORE SCREEN]], [[SAVE SCREEN]]
+
[[@...GET]], [[CLEAR GETS]], [[FMT()]], [[READ]], [[RESTGETS()]], [[RESTORE GETS]], [[RESTORE SCREEN]], [[SAVE GETS]], [[SAVE SCREEN]]
  
  
 
==Description==
 
==Description==
The SAVEGETS() function lets you save a description of the GETS in the current screen form for subsequent retrieval by the RESTGETS() function. Always assign the return value of SAVEGETS() to a memory variable, as the variable name is required by the RESTGETS() function.
+
The SAVEGETS() function lets you save a description of the GETS in the current screen form for subsequent retrieval by the RESTGETS() function. Always assign the return value of SAVEGETS() to a memory variable, as this is required by the RESTGETS() function.
  
  
Line 25: Line 21:
 
   parameters check
 
   parameters check
 
   save screen
 
   save screen
   // Specify SAVE GETS and CLEAR GETS before @...gets
+
   // Specify SAVEGETS() and CLEAR GETS before @...gets
 
   m_save=savegets()
 
   m_save=savegets()
 
   clear gets
 
   clear gets
Line 49: Line 45:
  
 
==Products==
 
==Products==
Recital Mirage Server, Recital Terminal Developer
+
Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]

Latest revision as of 15:26, 7 December 2009

Purpose

Save status of current GETS


Syntax

SAVEGETS()


See Also

@...GET, CLEAR GETS, FMT(), READ, RESTGETS(), RESTORE GETS, RESTORE SCREEN, SAVE GETS, SAVE SCREEN


Description

The SAVEGETS() function lets you save a description of the GETS in the current screen form for subsequent retrieval by the RESTGETS() function. Always assign the return value of SAVEGETS() to a memory variable, as this is required by the RESTGETS() function.


Example

// Set up validation procedure
procedure checkit
  parameters check
  save screen
  // Specify SAVEGETS() and CLEAR GETS before @...gets
  m_save=savegets()
  clear gets
  @0,1 get field4
  // Activate gets in validation procedure
  read
  // Reactivate reads in main screen form
  if not empty(field4)
      set validate on
  endif
  restgets(m_save)
  restore screen
return
 
clear
@1,1 get field1
@2,1 get field2 when field1="g"
@3,1 get field3 validate with checkit
read


Products

Recital