Restore a screen saved with the SaveScreen Tag
The Simulated Host allows multiple screens to be saved by name, for later restoration. This is particularly useful when implementing a "stack" organized transaction where a PF key can load one screen, and the PF3 might return to the previous screen.
By using SaveScreen and RestoreScreen, the contents of a screen (including input from the client/emulator) can be restored faithfully rather than from the fixed format of the originating MAP.
In addition, if the send attribute is not set to "no", the screen will be sent to the user and the "last screen received" at the time of the SaveScreen will be set to handle the next OnInput event.
Attributes:
Attribute |
Default / Required |
Description |
name |
"save" |
Name of the screen to restore-- if omitted, the default of "save" is used. There is no limit to the number of names used, but only one screen at a time may be saved under each name. |
send |
"yes" |
If this is "yes" (the default) then the screen buffer will be restored, and the screen sent to the client. The next onInput event will be for the screen preceeding the screen containing the original SaveScreen. |
RestoreScreen has no children.
Example:
<Script event="input">
<RestoreScreen name="helpsave"/>
</Script>
