HELP
An object that executes a previously defined
User Function, Compiled Function, or Remote
Function.

USE
Use Call Function to execute (call) a
previously defined User Function, Compiled
Function, or Remote Function.  Each input and
output on the Call Function object
corresponds to the respective input/output on
the called function.  (For a User Function,
the inputs and outputs correspond directly to
the inputs and outputs on the original
UserObject that was made into the User
Function.)  Call Function inputs are passed
to the called function by position, not by
name.  For example, the Call Function object
may have as its inputs, A and B.  But the
called function may have as its inputs x and
y.  No matter, the first input (A) on Call
Function is passed as the first input (x) of
the called function.  Only position is
significant.

You may also call a User Function,
Compiled Function, or Remote Function by
including its name in any expression whose
evaluation is delayed until run time.  These
include expressions in Formula, If/Then/Else,
Set Field, Get Field, Get Values, or From
DataSet devices, or expressions in Sequencer
or I/O transactions.  For example, you can
call the function someUsrFunc by including
the expression 2+someUsrFunc(a) in a Formula
object.

You can select a function to call in two
ways.  You can execute Select Function in the
object menu and select a name from a list of
available functions, or you can type in the
name directly in the Function Name field.  In
either case, Call Function will automatically
configure its input and output pins for the
called function, if that function is
recognized by HP VEE.

Since Call Function can call User
Functions (either locally created or imported
from a library), Compiled Functions, or
Remote Functions, it is possible to have two
functions with the same name.  Naming
conflicts are resolved according to the
following rule:
* The libraries are searched in the following
order:  1) local User Functions, 2) imported
("external") User Functions, 3) Compiled
Functions, and 4) Remote Functions.

This rule also applies to all objects
capable of calling such functions from an
expression.  In all cases, the first
(top-most) output pin of the defined function
is the returned value for the expression.
If a function is defined with the same name
as a built-in HP VEE function, such as COS,
the user-defined function will override the
built-in function.

LOCATION
Device ==> Function ==> Call Function

OPEN VIEW PARAMETERS

* Function name - The name of the User
Function, Compiled Function, or Remote
Function to be called.

OBJECT MENU

* Select Function - Lists the functions
currently known to HP VEE.  Locally created
User Functions are listed first, followed by
an alphabetically arranged list of the
imported library functions (User Functions,
Compiled Functions, and Remote Functions).
When you select a function, the input and
output pins on this object are automatically
configured as defined by the called function.
(This selection will be grayed out if no
functions are known to the HP VEE model.)

* Configure Pinout - Automatically configures
the input and output pins on this object as
defined by the called function.  (This
selection will be grayed out if the named
function is not recognized.)

NOTES
The Call Function object acts much like a
math function call.  Any inputs act like the
formal arguments of an internal HP VEE
function, while any outputs act like return
values from that function.

The actual execution of Call Function is
synchronous -- a call to a User Function,
Compiled Function, or Remote Function will
suspend the execution of parallel threads
until the function is complete.

SEE ALSO
Delete Library, Import Library, Edit
UserFunction, User Function, and UserObject.
