Motif-Based MAINSAIL Tools Reference Guide, Appendix A

previous   next   top   contents   index   framed top   this page unframed


A. The INVOKABLE Compiler Directive and the invokableModules Parameter in the $GUIEXE Group

Two MAINSAIL features support the list of invokable MODULEs in the Invoke Module window displayed by Execution->Invoke module.... You can use these features to add your MODULEs to the list.

At present, the list is not available through a program interface.

A.1. INVOKABLE Compiler Directive

Use the $DIRECTIVE directive INVOKABLE in your source code to mark a MODULE as invokable. An invokable MODULE is one that it makes sense to run as a “top-level” MODULE from the GUI-based executive. The directive is:

$DIRECTIVE "INVOKABLE"; # include in the list of invokable MODULEs

If a MODULE marked as invokable is present in an open MODULE library, it is displayed in the MODULE list in the Invoke Module window.

At present, this directive affects only whether the MODULE is put in the list; no other places in MAINSAIL use this information.

A.2. The invokableModules Parameter in the $GUIEXE Parameter Group

Temporary feature: subject to change

You may have MODULE names that you want to appear on the list of invokable MODULEs in the Invoke Module window even when those MODULEs are not in an open object MODULE library. To do this, in your parameter file (e.g., v1620.prm), you can specify a value for a parameter named invokableModules in a group named $GUIEXE. For example:

$GROUP $GUIEXE

invokableModules myMod1 myMod2 myMod3

This causes the three MODULE names myMod1, myMod2, and myMod3 always to appear in the invokable MODULE list.


previous   next   top   contents   index   framed top   this page unframed

Motif-Based MAINSAIL Tools Reference Guide, Appendix A