launch {filename} [data]

launch module slot [data]

This Console command launches a TEA object file on either the BrainStem® module's or the host's TEA Virtual Machine implementation.

filename

The file to launch.  Typically this is a file with a .cup extension.  If no extension is specified, a ".cup" is appended to this command.  The file is sought in the aObject File Area.

module

The module to launch the object file on.  This file must first be loaded onto the module.

slot

The module's file slot that holds the file to launch.  This slot must first be loaded with a file.

data (optional)

Data to send to the program being launched.  This is typically the main routine parameters of the TEA file that was compiled to create the .cup file being launched.

Example:

launch "hello"

This would launch the program "hello.cup" from the aObject File Area on the host.

launch 2 0 3

This would launch the program in file slot 0 on module 2 with the byte 0x03 as the entry parameter data.

launch "hello.cup" 3

This would launch the program "hello.cup" from the aObject File Area on the host with the byte 0x03 as the entry parameter data.

Related:

steep, load