AppCtrlScript

MAY Computer

Help

Index

  1. General Description
  2. Variables and Values
  3. Available Structures
  4. Index of available Commands
  5. Available Commands grouped
  6. ReadMe (with Revision history)
  7. Contact Information 

Applies to  

AppCtrlScript (Module: wmACScr1.dll)

General Description

The application control script language interpreter is a set of commands that can be enhanced and reused by other applications to provide a simple scripting language. Therefore the here described language elements do not contain the language extensions provided by the different applications. This documentation contains only the common available variables, structures and commands.

Applications enhancing the application control script with further commands can also provide integration possibility to import the commands in the application control script namespace. This leads to the result that all enhancing modules can be used together in one application control script. If you use internal modules they can be referenced with the IMPORTMODULE command.

When using other modules providing commands with the same name you can access them by writing explicitly <ModuleName>. <Command> <ParameterList>.

In general the variables, structures and commands are case insensitive. This means that the following calls are all the same:

CALL MySubroutine
call MYSUBROUTINE
call mysubroutine
CALL MYSUBROUTINE

A line is treated as comment line if the first character of the line is a "'", "; ", "/" or "#" character. You cannot specify comments in the same line where you put other commands.

Parameters to commands and subroutines are always passed separated by commas (",") and can be enclosed with " characters which is usually not necessary if you do not have a "," somewhere in your parameter. If you have " characters in your parameters than you have to escape them by writing them in double (""). Samples:

MSGBOX "This, my dear, is a test", "Title"
MySubroutine "Param1", "MyFile= ""c:\Test.txt""", "%SCR.MyVars%"

Names in general may not contain extra characters - only letters numbers and the characters "_" and "." are allowed.

Variables and Values

Subroutine, label and variable names may not contain extra characters - only letters numbers and the characters "_" and "." are allowed.

The commonly available variables are shared with other modules and applications developed by MAY Computer and are provided through the wmGlob1.dll.

Script variables that you set with SETVAL can be retrieved by using % variables somewhere in your parameters of the form %SCR.<VariableName>% or %VARS.<VariableName>% . Sample:

SETVAL MyVar, "My bonnie is over the ocean."
MSGBOX "%SCR.MyVar%"

Parameters passed to the application interpreting the script are available using %GLB.<VariableName>% . Sample:

MSGBOX "%GLB.File%"

But there is a large set of other variables that are available by default as name of the workstation or user, system folder for temporary files and so on.

See Application Script Variables and Global Variables documentation for details.

If commands take a date/time format string as parameter, the allowed characters are described here .

Contact Information

Technical support and latest information on our products are available at http://support.may.co.at

E-Mail support: mailto:support@may.co.at

MAY Computer GmbH & Co KG
Microsoft Solution Provider
Galvanigasse 2
A-1210 Vienna / Austria
Tel.: +43/1/278 20 80 Fax: +43/1/278 20 80 /22
http://www.may.co.at
mailto:may@may.co.at