Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
208
  
RING    ring counter 
The ring counter is increased with 1 on every ring that is received.  The ring counter is the same as the modem S-register 1. 
 
You can read or set the value of the ring counter, but of course, it is fairly meaningless to set the value, unless you have a 
specific reason for doing so. 
Examples: 
IF RING=8 THEN GOTO %Answer
PRINT RING
Beep=RING
Syntax: 
[num-var] = RING
See also: 
ON RING 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
209
  
ROM    access RAM/ROM disk in socket 2 
The ROM command is used to access the RAM/ROM-disk in socket 2 of an Argus Programmable Modem with RAM-disk 
filing system. 
Socket Organization 
There are 2 sockets to put a RAM chip into 
  Socket 1 is the one nearest the 32k system RAM. 
  Socket 2 is the one with the jumpers above it. 
If you want to have a RAM-disk filing system, there must always be a RAM chip in socket 1.  A RAM chip in socket 2 is 
optional and the jumpers must be set to RAM in this case. 
 
The RAM chips used can be any combination of a 32k, 128k, 256k or 512k chip.  So, the smallest possible RAM disk is 32k 
(a 32k chip in socket 1) and the largest possible RAM disk is 1Mb (2 x 512k chips in sockets 1 and 2). 
 
If a ROM is put into socket 1, then the filing system can access it only with LOAD and READ commands (LOAD, RUN, 
SEND, MATCH, DIR).  This is handy for putting in a BASIC application program, which requires no further RAM disk. 
 
If a ROM is put into socket 2 and the jumpers are set correctly, the filing system can access it only with LOAD and READ 
commands.  This is handy for putting in a BASIC application program, which requires a RAM-disk in socket 1. 
 
The ROM commands: 
 
The word ROM can be used in all existing filing system commands: 
 
SEND ROM RECEIVE ROM
LOAD ROM SAVE ROM
DIR ROM COPY ROM
MATCH ROM RENAME ROM
RUN ROM CLEAR ROM
RESTORE ROM
 
The commands in the first column can be used if a ROM chip is in socket 2. 
 
The commands in both columns can be used if a RAM chip is in socket 2. 
 
To initialize a RAM chip in socket 2, the command CLEAR ROM must be entered first.  After that all other commands can 
be used. 
 
If there is a RAM chip in socket 2, there are two (2) RAM disk filing systems at that time. 
  The first will access the RAM in socket 1, and  
  The second will access the RAM in socket 2. 
The first filing system uses all the normal commands, without the word ROM in it. 
 
The second filing system uses these commands as listed above.  Normally, the second filing system is only used for 
developing software for a ROM chip, which can be used later.  Or the second filing system is never used at all, in which 
caseall the RAM can be used by the first filing system. 
 
The first filing system uses both RAMS in socket 1 and 2.  So, the number of blocks free, shown with DIR, is for both 
sockets.  If you are using the second filing system in socket 2, you must be careful that the RAM in socket 1 doesnt become 
full and overwrite data from the first filing system in socket 2. 
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
210
  
All commands work exactly the same as the command without ROM in it, except the command LOAD ROM.  LOAD ROM 
will look first in socket 1 and if it cant find the file there it will look in socket 2, when there is a ROM in it.  Software can be 
developed then in such a way that the program in ROM can be overwritten or replaced by a program in RAM. 
See also: 
CLEAR, COPY, DIR, LOAD, MATCH, RECEIVE, RENAME, RESTORE, RUN, SAVE, SEND 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
211
  
RPT$    repeat string 
RPT$ is used to produce a string containing multiple repetitions of another string.  The result of the following example will be 
to set X$ to ********** : 
X$=RPT$(*,10)
Similarly, 
ab$=RPT$(ab,5)
will set ab$ to ababababab. 
 
The resulting string must not be longer than 255 characters. 
Examples: 
Line$=RPT$(-,80)
H$=RPT$(H,20)
PRINT RPT$(>,15)
Syntax: 
[string-var] = RPT$ ( [string] , [integer 0..255] )
See also: 
SPC$ 
						

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

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
213
  
RTS    ready to send 
RTS is one of the hardware handshaking signals defined in the RS232 standard, and the two serial ports of the modem 
normally respond to the RTS input by stopping the outgoing data stream. 
 
The RTS signal is used in conjunction with CTS (Clear to Send) as part of the RS232 handshaking sequence which prevents 
loss of data when a receiving piece of equipment cannot handle data from the sender at full speed. 
 
The RTS function is used to read the status of RTS on a specified port.  If no port is specified when reading RTS, the default 
port as defined by IPORT will be assumed.  If no port is specified when setting RTS, the default port as defined by OPORT 
will be assumed. 
 
Automatic control of RTS by the modem can be enabled using the command HANDSHAKE RTS.  This will take the RTS 
line low when there are only 5 free bytes remaining in the input buffer.  It will only be set high when 50% of the input buffer is 
free. 
 
If hardware handshaking using RTS/CTS is not available for some reason, software handshaking using XON/XOFF can be 
enabled using the command HANDSHAKE XOFF. 
 
If the modem is to ignore the RTS signal, then use the command RTS OFF. 
Examples: 
Req=RTS
Hand=RTS#2
RTS#1 ON|OFF
Syntax: 
[num-var] = RTS ( #[port] )
RTS ( #[port] ) (, #...) ON|OFF
See also: 
CTS, HANDSHAKE, XOFF 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
214
  
RUN    run a program 
RUN is used to initiate the execution of a program. 
 
There are three forms of the command, the first of which is used to execute the program currently residing in memory at 
PBOT.  In this case no parameter is required, and before execution commences all variables are cleared, and the data 
pointer restored to the first DATA command. 
 
The second form allows programs to be executed from a specified line number or label, in which case variables are not 
cleared.  This is particularly useful when RUN is used in conjunction with STOP for debugging programs; i.e. a program can 
be stopped to allow the current value of variables to be examined, and then restarted by typing RUN with the line number of 
the line following the STOP command. 
 
Finally, RUN can be used to execute programs stored in the filing system.  For example: 
RUN MAILBOX.PRG 
will cause the program stored on disk to be copied on PBOT and executed.  Variables are not cleared. 
Examples: 
RUN
RUN 50
RUN Menu
RUN START.PRG
RUN Name$+.BASIC
Syntax: 
RUN ( [line-num] | [label] )
RUN [string]
See also: 
PBOT 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
215
  
RUN ROM    run a program in ROM/RAM 
This command is used to run a program stored in a ROM/RAM in socket 2, in an Argus Programmable Modem. 
Example: 
RUN ROM MYPROG.BAS
Syntax: 
RUN ROM [FILENAME]
See also: 
ROM, RUN 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
216
  
SAVE    save program or data to memory 
SAVE is used to store BASIC programs on the disk.  The command must be followed by the filename. 
 
 It is recommended that you use extensions like .PRG or .BAS, to keep your programs separate from data files, faxes or 
messages.  You can then use something like DIR *.PRG to list all your BASIC programs. 
 
SAVE is also used to save a block of memory to the disk.  You will have to specify the start address and end address of the 
memory block to be saved, as well as the filename. 
Examples: 
SAVE Name$+.PROG
SAVE PROG1.BASIC
SAVE &7000,&7FFF,EDI12.DATA
Syntax: 
SAVE (FILE|!) [string]
SAVE (FILE|!), [num], [num], [string]
See also: 
DELETE, DIR, LOAD, RESTORE 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
217
  
SAVE ROM    save files in RAM disk in socket 2 
This command is used to save files to a RAM-disk in socket 2 in an Argus Programmable Modem.  To initialize a RAM chip in 
socket 2, the command CLEAR ROM must be entered first. 
Syntax: 
SAVE ROM [FILENAME]
See also: 
ROM, SAVE