Definition:

#include <aTEAvm.h>
object code: aTEAvm shared library



aLIBRETURN aTEAvm_Launch(

teavmRef teavmRef, aTEAvmLaunchBlock* pLB, aErr* pErr);

Parameters:

teavmRef	-	A pointer to the opaque library reference of the TEA virtual machine.
pLB	-	The launch block describing the program to launch in the TEA virtual machine.
pErr	-	A pointer to an aErr variable that recieves the error code on exit from this routine.

Return Value:

This library routine returns an aLIBRETURN type that is non-zero if there are errors, and zero if the routine completes with no errors.

Description:

This routine launches a TEA process in the virtual machine and returns the process ID in the launch block.  The launch block fully describes the initial data, whether the process is a debug or standard process, and also includes the actual program bytes to run.  A process is always created, even if it has a mal-formed header, invalid stack data size, etc.  Once created, the process will then run until an exit state is reached.  Once the process has exited, the process ID becomes invalid until it is potentially re-issued by a subsequent launch.  The TEA virtual machine must be initialized using the aTEAvm_Initialize routine before launching any processes.

Related:

aTEAvm_Initialize