Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
118
  
LOAD ROM    load BASIC programs from socket 2 
This is used to load a file from ROM or RAM in socket 2 into the program memory.  This is only possible in an Argus 
Programmable Modem with RAM-disk filing system.  To initialize the RAM chip in socket 2, the command CLEAR ROM 
must be entered first. 
Example: 
LOAD ROM FAX.PROG
Syntax: 
LOAD ROM [FILE]
See also: 
LOAD, ROM
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
119
  
LTRIM$    remove leading spaces 
LTRIM$ is used to remove all leading spaces from a string. 
Examples: 
PRINT LTRIM$  Test 
Adjusted$ = LTRIM$ Input$
Syntax: 
[string-var] = LTRIM$ [string]
See also: 
RTRIM$, TRIM$
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
120
  
MATCH    find matching files/data 
There are two main forms of the MATCH command, which provides the means for searching data streams and file 
directories for keywords or names. 
Searching for strings 
The first form of the command is used to search incoming data from the specified port for occurrences of a specified string.  
For example: 
50 MATCH#1,Password
will search the incoming data stream for the string Password, and suspend operation until a match is found.  The program 
will then resume at the next command.  An optional timeout period may be specified by following the command with a 
number, e.g. 
50 MATCH#1,Password,10
will cause the program to wait for up to 10 seconds for the string Password to be received, before resuming execution at the 
next line. 
 
Within the string to be searched for, wildcards may be used.  There are two types of wildcards: 
  .    for one character only;  and 
  *    for any possible string. 
MATCH A*B
will find AxxB as well as AxB 
 
while 
MATCH A.B
will only find AxB. 
 
If you need to find a string that includes * or ., then you will have to use the command: 
MATCH#n, ALL
because this command is similar to MATCH, but will not accept wildcards. 
 
If ECHO is added after the command, all characters received while searching for a string will be echoed. 
 
As the MATCH command returns a logical TRUE or FALSE value, an IF test can be used to check the result of the 
operation. 
MATCH PRINTER,10 : IF MATCH=0 GOTO %AGAIN
If no port number is specified, the default input port as defined by IPORT will be assumed.  The MATCH command does not 
affect the operation of any active ON ... event handlers. 
Searching for files 
When the MATCH command is followed by an exclamation mark or the word file and a string, the string is treated as a 
filename and a search is made of the file directory to determine if the file exists.  For instance, the command: 
MATCH FILE TELEX
will search for a file called TELEX.  As with the previous form of the command, the result is a logical value which can be 
acted upon by a suitable IF test: 
MATCH FILE TELEX : IF MATCH=0 GOTO %NO 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
121
  
With this syntax of match * is the only possible wildcard character.  The wildcard character can be used to search for 
multiple filenames, in which case MATCH will return the total number of matches found.  To show a count of all stored files 
you could use the command: 
MATCH FILE *.*.*
PRINT Total number of files found: ; MATCH
Finally, the U parameter can be used to specify a match with only unread files; e.g.: 
MATCH FILE *.*,U
PRINT Number of Unread messages : ; MATCH
Examples: 
MATCH CONNECT
MATCH STATION*AUT
MATCH#2, X$
MATCH Message$, 600
MATCH FILE File$+.INP, U
Syntax: 
strings: 
MATCH ( #[port], ) (ALL) [string/string with wildcards] ( , [integer] )
(,ECHO)
files: 
MATCH [FILE|!][string] ( ,U )
See also: 
FAX RECEIVE, FAX SEND, MATCH ROM
 
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
122
  
MATCH ROM    find matching files in socket 2 
This is used to search the ROM or RAM in socket two for matching files, file directories, keywords or names.  This is only 
possible in an Argus Programmable Modem with RAM-disk filing system.  To initialize the RAM chip in socket 2, the 
command CLEAR ROM must be entered first. 
Examples: 
MATCH ROM CONNECT
MATCH ROM STATION*AUT
Syntax: 
MATCH ROM [FILENAME]
See also: 
MATCH, ROM
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
123
  
MID$    extract middle portion of string 
MID$ is used to extract a number of characters from the middle of a string. 
Three parameters are required.  The first is the original string, the second is a number indicating the start position within the 
string, and the third specifies the number of characters to be extracted.  In the following example the variable Num$ is set to 
TWO: 
50 Num$=MID$(ONE TWO THREE, 5, 3)
If the specified start position is greater than the length of the string, a null string is returned. 
 
If the number of characters requested is greater than those to the right of the start position, all remaining characters are 
returned. 
 
If the last parameter is omitted, all characters to the right of the start position are returned. 
Examples: 
Mi$=MID$(CLOCK$,4,2)
X$=MID$(Y$,6)
Syntax: 
[string-var] = MID$( [string], [integer 0..255], ([integer 0..255] ))
See also: 
LEFT$, RIGHT$
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
124
  
MIN    set/read minute value 
MIN is used to read or set the minute value of the internal clock/calendar. 
 
When reading it returns an integer from 0 to 59; similarly, when setting, the specified value must be between 0 and 59.  An 
incorrect value will leave the current setting unchanged. 
Examples: 
MIN=15
Duration=(HOUR * 60)+MIN
PRINT MIN
Syntax: 
MIN = [integer 0..59]
[num-var] = MIN
See also: 
CLOCK$, HOUR, SEC, TIME$
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
125
  
MNP (4/5) ON/OFF    turn MNP on/off 
This is used in the programming environment to turn MNP error correction and compression on or off and has the same 
effect as the modem commands &E0, &E4 and &E5. To turn MNP2 only on use &E2 and to turn MNP3 only on use &E3, 
 
There are no BASIC commands to turn on or off V42 and V42bis, which is a more modern protocol.  This must be done with 
the modem commands &E0, &E6 and &E7. 
 
To turn on MNP and V42 (no compression) use &E1C0, which is also the default.  Using compression (MNP5 or V42bis) is 
not recommended in BASIC mode, because there is not enough system memory. 
Examples: 
MNP4 ON
MNP OFF
Syntax: 
MNP (4|5) ON|OFF
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
126
  
MOD    integer remainder operator 
MOD returns the integer remainder from an integer division operation. 
For example the result of 
 17 MOD 5would be 2. 
Examples: 
Res=Total MOD Fact
PRINT 12 MOD 5
Syntax: 
[num-var] = [integer] MOD [integer]
See also: 
DIV
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
127
  
MODEM    select standard modem mode 
MODEM is used to go from the BASIC environment to the standard modem environment.  The modem can only return to 
BASIC with help of the command AT*B, or because of an ON RESET event.  The only other method to go from BASIC to 
standard modem mode is to press the STOP button while the S/A button is in the in position. 
 
To jump to modem mode in a T.C.Lite the keys > + >> + >>> on the keyboard must be pressed at the same. This can be 
disabled by setting bit7 on address &49D (POKE &49D,&80), but care must be taken because the modem can lock-up if 
an error occurs in the program and the ON ERROR command is not defined correct. 
Examples: 
MODEM
ON DTR MODEM
Syntax: 
MODEM
See also: 
ON RESET