AMCAF Extension V1.40 Manual  Index

Extension Commands


Again some commands and functions for advanced users.
Before using these, think about what you are doing, then again, and once more, and more important, save your program before starting it.


EXTDEFAULT
instruction: call the default routine of an extension
Extdefault extnb

This command has been written especially for advanced users.
With this one you can call the routine in the AMOS extension in slot 'extnb' which is normally executed after the start of a program or by the Default command.
Often this routine resets the interior database to the default values.

Extdefault should be called after re-linking an extension with Extreinit.

If no extension is loaded in slot number 'extnb', this instruction has no effect.


EXTREMOVE
instruction: remove an extension from memory
Extremove extnb

The Extremove command removes the extension in the slot 'extnb' from memory like when exiting AMOS.
After this command no further instructions requiring this extension may be called.
As AMOS tries to unlink the extension itself on quitting, this could cause some trouble.
So don't remove an extension too long, revoke it with Extreinit before exiting.


EXTREINIT
instruction: try to restart a previously removed extension
Extreinit extnb

This command causes a restart of the extension numbered 'extnb'.
Extreinit may only be called on a extension that has been removed using Extremove.
Otherwise, you can lose memory or even crash your computer.


AMOS TASK
function: return the address of the amos task structure
address=Amos Task

For advanced programmers. This function returns the address of the AMOS task structure.
Using this you can for example increase the task priority:

Areg(1)=Amos Task
Dreg(0)=3
dummy=Execall(-$12C)

This program sets the task priority to +3.


AMCAF VERSION$
function: return an amcaf version string
Print Amcaf Version$

This command returns the current AMCAF version number and a greetings list.


AMCAF BASE
function: return the base address of the amcaf database
address=Amcaf Base

This command returns the base address of the AMCAF database.


AMCAF LENGTH
function: return the length of the amcaf database
length=Amcaf Length

This command returns the length of the AMCAF database.