Programmer Guide/Macro Library/Kernal/StdLib

• File: STDLIB.STX, linked to library STX.LIB
• Title: STx main library

---

Content

Variables and items used by this library

name	type	description

AppLoad

APPLOAD appname [ ; appargs ]

Load and run a registered STx application.

argument	description	default
appname	Name of a registered STx application.
appargs	Arguments for the application.
RESULT	description
void	This macro has no return value.

Examples

• Start the realtime analyser: appload rtanalyse
• Start a script: appload bscript run ; $@root\scripts\myscript.sts ; mymacro ; arg1 arg2

AppMain

This is the STx application main macro. It is called by the application management system to initialize, run and finish STx applications. This macro can not be called from other macros.

To end an application and return directly to APPMAIN the command EXIT -1 can be used.

Note

At the end of an application, the sourcecode is unloaded. To avoid unloading the variable AppNoUnload must be set to 1 before returning to APPMAIN.

AppCleanup

This macro is called by APPMAIN to cleanup shell items. It deletes all shell items created by an application. It can also be called from the application to remove all shell items (APPCLEANUP ALL) or spu-items only (APPCLEANUP SPU).

AppHelp

This macro implements an interface to the online-help for STx. It is currently under development.

PostMessage

POSTMESSAGE shellid msgid [ msgpar ]

Post a message to a shell. The meaning of the message depends on the target shell. The target shell must implement message handling for shell messages.

argument	description	default
shellid	Unique id of the target shell.
msgid	The message id.
msgpar	The optional message parameter(s).
RESULT	description
0	success
1	failed

The following special values can be used for the argument shellid to the specify the target shell(s):

• CALLER → the caller of the application
• MASTER → the STx master shell
• SELF or THIS → the shell itself
• ALL or * → all running shells except the sender

Notes:

• The id of the current shell and the calling shell are stored in the variable SHELL: SHELL = current_shell_id calling_shell_id. The shell id is 8 digit hex number.

See also

command MESSAGE