TolliumControllerBase::StartApplication (open)

Send a message to an application, launch it if needed

Syntax

LOADLIB "mod::tollium/lib/internal/controllerbase.whlib";

MACRO StartApplication(STRING app, RECORD target, RECORD message, RECORD options)

Parameters

STRING app

Name of the application to start (usually 'modulename.applicationname')

RECORD target

The target (eg document, schema) of the application. May be an empty record. An application instance only matches if it has the same application name and target

RECORD message

If an existing record is passed, this is sent to the 'onmessage' handler of the application

RECORD options
reusemode

When to reuse an existing application. Possible values: "never", "always", "whennotbusy". If reusing an existing application, the message is sent to its onmessage handler.

Description

Application messages offer a one-way communication channel between applications, and allows for a way to start new applications