Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
198
  
REPEAT ... UNTIL    loop structure 
REPEAT ... UNTIL provides a conditional loop construct in which all commands within the loop are executed at least 
once before a test condition is checked to determine whether or not the loop should be repeated.  If the test condition 
evaluates to be TRUE, then the commands within the loop are repeated; otherwise execution continues at the next 
command following the UNTIL test. 
 
A REPEAT command may span more than one program line. 
 
The construct: 
REPEAT : ... : UNTIL FALSE
is commonly used to carry out a series of commands indefinitely.  This command is effectively the same as: 
REPEAT : ... : UNTIL FALSE=TRUE
Obviously FALSE never will equal TRUE, and so the commands within the loop are executed repeatedly until the program 
is halted. 
Examples: 
REPEAT PRINT GET$; : UNTIL FALSE
REPEAT PUT#7, GET#1 : UNTIL KEY$#2=27
REPEAT UNTIL ILINE(3)
Syntax: 
REPEAT .... UNTIL [test]
See also: 
FOR..TO..NEXT..(STEP), WHILE...DO
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
199
  
REPORT    report result or error 
REPORT is used to send a result code or error message to the specified port. 
REPORT ERN 
This command is used to report BASIC error messages. 
 
Two parameters may be given; the port number(s) and the number corresponding to the error message required.  If no error 
number is specified, the number of the last error encountered will be used, and the corresponding message given.  If no port 
is specified, the default output port as defined by OPORT will be assumed. 
REPORT or REPORT RESULT 
This command is used to report modem result messages. 
 
Two parameters may be given; the port number(s) and the number corresponding to the result messages required.  If no 
number is specified, the number of the last result message will be used, and the corresponding message given.  If no port is 
specified, the default output port as defined by OPORT will be assumed. 
Examples: 
REPORT
REPORT RESULT
REPORT#2 ERN 3
REPORT#1,#2 ERN Err
Syntax: 
REPORT ( #[port],)(#... ) (RESULT/ERN) ([integer 1..79])
See also: 
ERL, ERN, ON ERROR, RESULT 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
200
  
RESET    generate hardware reset 
RESET is used to generate a hardware reset from within a program, the result of which is equivalent to pressing the RESET 
button on the front panel.  It is generally used in conjunction with an ON RESET command to restart the program at a 
particular point. 
 
Because there is a special chip in your modem (known as the watchdog & power monitor), the RESET command will 
effectively reset all ICs in the modem. 
Syntax: 
RESET
See also: 
ON RESET
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
201
  
RESET ALL SREG    reset all S-registers 
Used to reset all S-registers to factory settings (same as AT&F). 
Syntax: 
RESET ALL SREG
See also: 
SREG
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
202
  
RESET MODEM 2    reset modem-chip  
This command is used to software reset the modem-chip only.  If the modem-chip was in sleep-mode it will be waken up first.  
The command is used to switch between the different modes; modem, fax or voice.  After RESET MODEM 2 the modem 
is in modem-mode. 
 
Sleep-mode brings the modem-chip in low power mode.  This feature is default enabled.  The commands ANSWER,
CONNECT, DIAL, FAX, RESET MODEM 2and VOICE will wake up the modem-chip so it is ready for use.  
This takes about 500 ms.  The HANGUP and HOOK ON commands will put the modem-chip back into sleep-mode. 
 
Sleep-mode can be disabled by clearing bit6 in S-register 64 (SREG64=SREG64 AND &BF). 
Syntax: 
RESET MODEM 2 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
203
  
RESTORE    pointer to data command/buffer/RAM-disk 
RESTORE is used in conjunction with the DATA and READ commands to reset the data pointer to a particular DATA 
command which is identified by its line number or label, and therefore allows data to be read in a non-sequential manner. 
The RESTORE command is followed by the line number or label of the line containing the requisite DATA command. 
 
RESTORE BUFFER will set one of the user buffer pointers back to the beginning, so that the last data read may be read 
again.  For example: 
10 BUFFER 100
20 PRINT#8, HELLO
30 INPUT#8, A$
40 PRINT A$
50 RESTORE BUFFER
60 GOTO 30
The command RESTORE FILE or RESTORE! will recover a RAM-disk from CLEAR!.  This can only be done if no 
other files have been written to the RAM-disk between the deletion and the restoring.  The command is not valid in a Hard-
disk filing system. 
 
The command RESTORE ROM is used in an Argus Programmable Modem when a RAM chip is fitted in socket 2.  If 
accidental erasure or corruption occurs, use this command before new data is stored in this chip. 
Examples: 
RESTORE 500
RESTORE %NameList
RESTORE!
RESTORE ROM
Syntax: 
RESTORE [line-num| label]
RESTORE BUFFER
RESTORE FILE
RESTORE ROM
See also: 
CLEAR, DATA, READ, ROM 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
204
  
RESULT    status of modem 
RESULT is a function which holds the status of the last modem activity after a modem command. 
   RESULT  DESCRIPTION 
0OK
: Modem command was successful 
1 CONNECT
: Connection at 300 baud (or fax connection) 
2 RING
: A ring is being received 
3 NO CARRIER
: Handshake with other modem or fax has failed 
4 ERROR
: Error in executing a modem command 
5 CONNECT 1200
: Connection at 1200 baud  
6 NO DIALTONE
: No dial tone found before dialing out 
7 BUSY
: Other modem or fax found busy after dialing out 
8 NO ANSWER
: No answer after dialing out 
9 CONNECT 75
: Connection at 75/1200 split baud 
10 CONNECT 2400
: Connection at 2400 baud 
11 CONNECT 4800
: Connection at 4800 baud 
12 CONNECT 9600
: Connection at 9600 baud 
13 CONNECT 14400
: Connection at 14400 baud 
14 CONNECT 19200
: Connection at 14400 baud 
15 CONNECT 600
: Connection at 600 baud 
16 CONNECT 7200
: Connection at 7200 baud 
17 CONNECT 12000
: Connection at 12000 baud 
18 OFF-HOOK
: Modem is not connected to telephone system 
: or line is already in use 
19 ESCAPE
: Escape detected in modem mode or ‘continue’ for 
: FAX command 
20 VOICE
: Human voice (or noise) found after dialing out 
26 CONNECT 1275
: Connection at 1200/75 split baud 
32 CONNECT 16800
: Connection at 16800 baud 
33 DATA
: Message to terminal 
34 CONNECT 24000
: Connection at 24000 baud 
35 FAX
: Message to terminal 
36 CONNECT 28800
: Connection at 28800 baud 
38 CONNECT 38400
: Message to terminal 
39 CONNECT 57600
: Message to terminal 
40 CONNECT 115200
: Message to terminal 
41 CONNECT 21600
: Connection at 21600 baud 
42 CONNECT 26400
: Connection at 26400 baud 
43 VCON
: Voice Class 8 message 
44 CONNECT 31200
: Connection at 31200 baud (V34plus only) 
45 CONNECT 33600
: Connection at 33600 baud (V34plus only)  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
205
  
Example: 
R=RESULT
IF RESULT GOTO Error
Syntax: 
RESULT 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
206
  
RETURN    Return from procedure/set return character 
The command RETURN is used for two purposes: 
1. Return from procedure 
(see GOSUB ... RETURN) 
2. Set value of RETURN character. 
The ASCII value of the return character as sent by the modem can be set with use of the command RETURN or the modem 
S-register S3. 
Examples: 
RETURN
RETURN=13
Syntax: 
RETURN
RETURN = [num-var]
See also: 
LINEFEED 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
207
  
RIGHT$    extract right portion of string 
RIGHT$ extracts the specified number of characters from the right-hand side of a string.  The command: 
R$=RIGHT$(ABCDEFGH,3)
will assign the string FGH to the string variable A$. 
 
The number of characters extracted must be between 0 and 255.  Attempts to extract more characters than exist in the string 
will return the entire string. 
 
Examples: 
Lastname$=RIGHT$(Name$,6)
Secs=RIGHT$(CLOCK$,2)
PRINT RIGHT$(and so, the story ends., 10)
Syntax: 
[string-var] = RIGHT$ ( [string], [integer 0.255] )
See also: 
LEFT$, LEN, MID$