UniBasic Commands Reference - Rocket Software

Parameter Description
Reminder: The error message numbers you capture with RETURNING will vary,
depending upon which version of UniData you are running.
The ECL STACKCOMMON Command
The ECL STACKCOMMON command makes use of common areas more flexible,
although it requires additional memory. STACKCOMMON settings have the
following effects:
1-268 UniBasic Commands Reference
RTNLIST int.expr The RTNLIST clause must be an integer from 0–9, designating
the select list to return to the calling program. You can use the
resulting list with subsequent READNEXT statements or in the
PASSLIST clause of an EXECUTE statement. If an expression
is not given after RTNLIST, the generated select list replaces the
contents of list 0. If RTNLIST is not specified, no list is returned.
If you use EXECUTE to call a UniBasic program, no select list
is returned even though you specify RTNLIST. On the other
hand, PASSLIST is always effective and transfers a select list to
the called program.
PASSLIST int.expr The PASSLIST clause must evaluate to an integer 0, 1 or 2,
designating the select list to be sent to the called program. If you
do not specify int.expr, list 0 is assumed.
The passed list can be the result of previous SELECT or
GETLIST commands, or the result of the RTNLIST clause of a
PERFORM statement.
PASSCOM This parameter is provided for backward compatibility for
releases before 3.1.
EXECUTE Parameters (continued)
If STACKCOMMON is off when one program executes another, the
unnamed common is passed to the executed program and back to the
executing program.
If STACKCOMMON is on when one program executes another program,
the unnamed common is not passed to the program you execute. Instead,
unnamed common is saved, and the unnamed common of the called
program is initialized to 0. When control is passed back to the calling
program, unnamed common is restored to its value before the program call.
Unnamed common is never passed to a phantom program.