Embedded Query Language Considerations
This section points out the special considerations for EQUEL in returning to the top frame.
You should not return immediately from inside a display loop, a retrieve loop, or from a routine that has cursors open. Exit each of these cleanly, as follows, with the appropriate EQUEL statements before returning to the calling frame:
• Break out of a display loop with the breakdisplay or enddisplay statement.
• Exit from a retrieve loop with the endretrieve statement.
• Close open cursors with the close statement.
For example, the following section shows a program fragment that illustrates returning a status of "11" from inside a display loop.
Example (EQUEL Only)
## ACTIVATE MENUITEM "Top";
## {
## status = 11 ;
## BREAKDISPLAY /* drop out of display loop */
## /* don't want to do
## * 'return (11);' here because we're
## * inside a display loop */
## }
## finalize()
return ( status ) ;