Batchfile-Help
==============
The batchfile system of the Mediamat makes it possible to run
more than one command by clicking the start and/or user keys.
This is helpfull i.e. if you want to unzip a file in a folder
that does not exist. So you can create it and to start the 
unzip program with the file to enlarge. And maybe if there are
a diskerror you can remove the new created folder from the
harddisk.
The batchfile which is called "Batch.txt" can be opend from
the Mediamat by clicking the button "batchfile" in the edit
window. The batchfile is subdevided into modules. Each module has
his own name which is set in brackets like [module name].
To run a batchfile module you have to entry the module name in the
edit window in one of the three application lines. The format is
"batch/(module name)".
In the follow lines you see a list of all batchfile commands with
descriptions and examples. The pathes to the files to open can be
absolute (with ASD) or relative. An absolute path must begin with a
drive letter (like c:\...) and a relative path with a backslash
(like \...).

Command: ascii (#)
Descrip: to send an ASCII-Keycode (#) to the active window
Example: ascii 13

Command: beep
Descrip: to make a signal
Example: beep

Command: clipin (text)
Descrip: to copy a text into the clipboard
         clipout to read a text from the clipboard
Example: clipin \games\
         dir clipout

Command: confpath (path)
Descrip: to load an other Mediamat configuration
Example: confpath \sample\

Command: copy (path) to (path)
Descrip: to copy a file
Example: copy \systemfiles\any.dll to c:\windows\system\any.dll

Command: dir (path)
Descrip: to view a folder (does not work with empty folders)
Example: dir \games\

Command: errbatch (module name)
Descrip: on error goto (batch module)
Example: errbatch error handler

Command: errexit
Descrip: on error exit batch module
Example: errexit

Command: errignore
Descrip: on error resume at the next line
Example: errignore

Command: errmessage
Descrip: on error show error message and exit batch module
Example: errmessage

Command: errrepeat (n)
Descrip: on error repeat batch moduls for n-times
         in combination errbatch: on error after repeat goto...
Example: errrepeat 2
     or: errrepeat 1
       : errbatch error handler

Command: file(address)
Descrip: to open a html file in the standard browser
Example: file:///C|/own files/votesite.html

Command: GoFalseWin (WinTitle),(Max.Time)
Descrip: waits until a window with title (WinTitle) disappears, but only for (Max.Time) seconds
Example: GoFalseWin Connect*,5

Command: goto (module name)
Descrip: to jump to an other module
Example: goto undo chess installation

Command: GoTrueWin (WinTitle),(Max.Time)
Descrip: waits until a window with title (WinTitle) exists, but only for (Max.Time) seconds
Example: GoTrueWin Connect*,5

Command: hide
Descrip: to hide the Mediamat in the systray
Example: hide

Command: http(address)
Descrip: to open an url in the standard browser
Example: http://www.elmshorn.netsurf.de/~d.schaefer/

Command: kill
Descrip: to remove a file or empty folder
Example: kill \games\chess.exe
     or: kill \games\store

Command: mailto(address)
Descrip: to open the standard mail program
Example: mailto: schaefer.de@t-online.de

Command: makedir (path)
Descrip: to create a folder
Example: makedir \games\store

Command: message (text)
Descrip: to give out a message in the message requester
Example: message Ready!

Command: midplay (filename)
Descrip: plays a midifile
Example: midplay \sample\midi.mid

Command: midstop
Descrip: stops a running midi song
Example: midstop

Command: minimize
Descrip: to minimize the Mediamat window
Example: minimize

Command: move (path) to (path)
Descrip: to move a file
Example: move \games\lastgame.dat to \games\store\game990720.dat

Command: news(address)
Descrip: to open the standard news reader
Example: news://news.test.com/

Command: open (path)
Descrip: to open a file (with the standard viewer/editor)
Example: open c:\games\chess\chess.exe
     or: open \tools\cleaner.exe
     or: open \games\cards.bmp
     or: open http://www.elmshorn.netsurf.de/~d.schaefer/

Command: question (text)
Descrip: to ask the user to exit the batch module
Example: question Continue?

Command: qui?
Descrip: to ask the user to quit the Mediamat
Example: qui?

Command: quit
Descrip: to quit the Mediamat without asking the user
Example: quit

Command: rename (path) as (path)
Descrip: to rename a file or folder
Example: rename \games\chess.dat as \games\chess.bak

Command: text (text)
Descrip: to send a text string to the active window
Example: text Hello user!

Command: vdef (title) pre (input text)
Descrip: to show an input requester
         "title" for the window title text
         "pre" for a preset in the input line
         the keyword "pre" is required but can be left blank
         the user input will be stored in "result"
Example: vdef Please set path! pre \games\
         open result
     or: vdef Your input please! pre
         copy \games\chess.exe to result

Command: wait (sec)
Descrip: Pause for (sec) seconds
Example: wait 5

Command: wavplay (filename)
Descrip: plays a wavefile
Example: wavplay \sample\wave.wav

Command: wavstop
Descrip: stops a running wave song
Example: wavstop

Command: with (path)
Descrip: to open a defined application for the follow command
Example: with c:\programs\Internet Explorer\IEXPLORE.EXE
         open http://www.elmshorn.netsurf.de/~d.schaefer/

[sample]
errrepeat 2
errbatch error handler 1
clipin \temp
makedir clipout
copy \games\chess.exe to clipout

[error handler 1]
errrepeat 1
question Error! Should the created folder removed from harddisk?
kill clipout
