UniBasic Commands Reference - Rocket Software

CALL
Syntax
CALL *sub.name [[(argument1[,argument2][MAT array1 [,MAT array2]]...)]
[ASYNC | SYNC] [ON connection]
CALL @var [[(argument1[,argument2][MAT array1 [,MAT array2]]...)]
[ASYNC | SYNC] [ON connection]
CALL sub.name [[(argument1[,argument2][MAT array1 [,MAT array2]]...)]
[ASYNC | SYNC] [ON connection]
Description
The UniBasic CALL command transfers program control to an external subroutine.
The first form of the syntax calls a globally cataloged subroutine.
The second form of the syntax calls a subroutine named in a variable.
The third form of the syntax calls a subroutine directly.
The called program or subroutine must contain a RETURN statement, which returns
control to the calling program or subroutine.
You can nest subroutines up to 1,024 levels deep.
Note: You must catalog subroutines before using them in a UniBasic CALL statement.
You must separate individual arguments by commas and enclose the set of arguments
within parentheses. You can place arguments on multiple lines. Each continued line
must end with a comma. Regardless of placement, the number and type of arguments
in the CALL statement must match the number and type of arguments in the
SUBROUTINE statement within the external subroutine. Arrays and singlevalued
arguments can be passed in the same CALL statement.
Tip: You can also pass variables through named and unnamed common areas.
Variables stored in common area(s) are accessible to both calling and called
programs without being passed as arguments. You cannot use the same variable
name in both a SUBROUTINE argument and a common variables list.
CALL 1-120