Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
248
  
WHILE ... DO ... WEND    loop structure 
The WHILE ... DO ... WEND construct is a conditional loop construct which allows the conditional execution of one 
or more program lines according to the result of a test carried out at the beginning of the loop.  16 loops can be nested. 
 
If the result of the test condition is FALSE, the code within the loop (i.e. between the test condition and the WEND), is 
skipped, and execution proceeds with the command immediately following the WEND. 
 
If the result of the test condition is TRUE, all commands within the loop are executed before the test is re-applied.  This 
process is repeated until the test condition becomes FALSE. 
 
For example: 
10 A=1
20 WHILE A
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
249
  
XOFF    define XOFF character 
The XOFF command is used in a number of ways to control software handshaking during data transfer. 
 
There are 4 variations: 
XOFF#[port] 
When used on its own, XOFF halts data transmission from the specified serial port.  This provides a way to control the 
output data stream which otherwise can only be controlled via the CTS line.  XON is used to re-enable transmission. 
XOFF#[port], OFF 
This is used to disable software handshaking on the specified port. 
XOFF ON 
This is used to enable software handshaking on the specified port.  Transmission of data will be halted when an XOFF 
character is received, and will not start again until an XON has been received. 
XOFF [integer 0...255] 
The default value for the XOFF character is ASCII 19 ([Ctrl- S]).  This form of the XOFF command is used to redefine this 
value so than an alternative character may be used for software flow control.  It is the same as setting S-register 21 
(SREG21=[num]). 
 
Note that after pressing the STOP button, the XOFF character for each port will be set to 19 ([Ctrl-S]) and XON to 17 ([Ctrl-
Q]).  All ports are also set to XOFF ON. 
Examples: 
XOFF
XOFF#1, ON
XOFF#2,#3,#4,OFF
XOFF=19
Syntax: 
XOFF ( #[port],)(#... )
XOFF ( #[port],)(#... ) ON/OFF
XOFF = [integer 0..255]
See also: 
HANDSHAKE, XON 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
250
  
XON    define XON character 
The XON command is used in a number of ways to control software handshaking during data transfer. 
 
There are three variations: 
XON #[port] 
When used on its own, XON re-enables data transmission after it has been halted using XOFF.  If no port is specified, the 
default port as defined by OPORT is assumed. 
 
Note that CLEAR OUTPUT and ESCAPE will also re- enable transmission, as will pressing either of the RESET and 
STOP buttons. 
XON [integer 0 - 255] 
The default value for the XON character is ASCII 17 ([Ctrl- Q]).  This form of the XON command is used to re-define this 
value so that an alternative character may be used for software flow control. .  It is the same as setting S-register 22 
(SREG22=[num]). 
 
Note that after pressing the STOP button, the XOFF character for each port will be set to 19 ([Ctrl-S]) and XON to 17 ([Ctrl-
Q]). 
Examples: 
XON
XON#1,#2
XON=17
Syntax: 
XON ( #[port],)(#... )
XON = [integer 0..255]
See also: 
XOFF 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
251
  
YEAR    read/set year value 
YEAR is used to read or set the year value on the internal clock/calendar. 
 
When reading it returns an integer from 0 to 99. 
 
When setting, the year number from 0 to 99 must be specified. 
 
An incorrect value will leave the current setting unchanged. 
Examples: 
YEAR=89
PRINT YEAR
Syntax: 
YEAR = [integer 0..99]
[num-var] = YEAR
See also: 
DATE$, DAY, DDAY, MONTH 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
252
  
 Error Messages 
The ARGUS can generate about 100 different error messages. 
 
The associated text can be requested via the REPORT ERN command. 
 
The number of the last error message can be obtained via ERN; and the line which caused this error with ERL. 
 
Almost all error messages can be trapped and handled with ON ERROR, except: 
 
 - NMI/STOP 
 
 - STOP 
 
 - Out of memory 
 
 - Error in TIMEOUT-SUB (ON ERRORmust be redefined 
      in timeout subroutine) 
 
 - RESET (can be handled with ON RESET) 
 
 
A list of all error numbers and messages is given on the following pages.  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
253
  
 
No. message  cause 
0 OK
File transfer was successful. 
2 BASIC 6.xx
BASIC version number. 
3 ESCAPE
Escape character  received and ESCAPE was ON. 
4 RESET
A reset has occurred (power failure, button, RESET). 
5 STOP
Program execution has stopped by command STOP. 
6 Cancelled
File transfer cancelled with SEND or RECEIVE. 
7 Failed
FAX RECEIVE not successful or too many errors in 
SEND/RECEIVE file transfer or timed out. 
8 Calculation error
Error in calculation expression. 
9 Division by zero
Division by zero not allowed. 
10 Bad string
Error in a string. 
11 Bad button
A button command out of the range 1-3. 
12 String expected
No string found where one was expected 
13 No DATA
RESTORE on a line which does not start with DATA 
14 Out of DATA
A READ where no more DATA is available. 
15 Mistake
Something is not recognized as a command. 
16 Bad line
A line number for a GOTO is not in range (32767) 
17 Bad program address
PBOT has been set to an invalid address 
18 Syntax error
All non-specific errors in commands. 
19 Not allowed
Command is not allowed inside a program (NEW, DELETE,
RENUM, AUTO). 
20 Bad LED
LED number not in range. 
21 Memory corrupted
Program or variables or RAM-disk damaged. 
22 Out of memory
No more space for new variables or lines or files (try BUFFER
OFF).  During RECEIVE, disk became full. 
23 Subscript
Array element out of range. 
24 Array
A non-existent array is accessed. 
25 Bad time/date
Wrong value for time or date. 
26 Bad setting
A communication parameter has wrong value. 
27 No RAM expansion
No extra memory is plugged in for filing system usage. 
28 No filing system
No filing system software (ROM) on board. 
29 Printer using line
One of the I/O lines is accessed while printer is active. 
30 Bad I/O line
I/O line number not in range (ILINE/OLINE). 
31 Bad port
Port number not in range. 
32 Bad S-register
S-register not in range (SREG). Must be 0-79. 
33 Aborted
File transfer aborted by remote. 
34 ON out of range
An ON GOTO/GOSUB line number out of range.  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
254
  
35 Array exist
DIM of an already existing array. 
36 ON/OFF expected
ON or OFF missing after a command. 
37 Type mismatch
Integer and string in same expression. 
38 No number/variable
A number or variable is expected or missing. 
39 Variable expected
Variable name expected. 
40 Bad DIM
Syntax error in DIM command. 
41 Label/Line expected
A label or line number is expected. 
42 = missing
Equal sign missing. 
43 Line too long
Length of a program line is longer than 255 bytes. 
44 Number too big
A number exceeds 32767. 
45 Variable not found
Integer variable does not exist. 
46 Bad HEX
Wrong format for HEX number. 
47 String not found
String variable does not exist. 
48 Line not found
Line number in GOTO/GOSUB does not exist. 
49 [ missing
Left bracket missing. 
50 ] missing
Right bracket missing. 
51  missing
Signs with text missing. 
52 , missing
Sign missing. 
53 Label not found
Label does not exist. 
54 FOR not found
A NEXT followed by an unknown variable. 
55 No FOR
A NEXT without FOR. 
56 Too many FORs
More than 16 nested FORs. 
57 No REPEAT
UNTIL without REPEAT. 
58 Too many REPEATs
More than 16 nested REPEATs. 
59 No GOSUB
A RETURN without GOSUB. 
60 Too many GOSUBs
More than 16 nested GOSUBs. 
61 No WHILE
WEND without WHILE. 
62 Too many WHILEs
More than 16 nested WHILEs. 
63 No WEND
A WHILE without WEND. 
64 TO expected
TOforgotten in FOR command. 
65 DO expected
DO forgotten in WHILE command. 
66 Error in TIMEOUT sub:
Error encountered in ON TIMEOUT subroutine. 
67 TIMEOUT END expected
A program ends in a TIMEOUT subroutine. 
68 No ON TIMEOUT
TIMEOUT END found outside timeout subroutine. 
69 (Timeout.
Used during trace mode. 
70 End)
Used during trace mode. 
71 No FAX system
No fax system ROM available.  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
255
  
72 Bad name
File name not correct. 
73 Not found
File(s) not found 
74 Duplicate name
File already exists while using RENAME. 
75 * RESET *
Used during trace mode. 
76 * ERROR *
Used during trace mode. 
77 *AT*
Used during trace mode. 
78 * SLASH *
Used during trace mode. 
79 * RING *
Used during trace mode. 
80 * CONNECT *
Used during trace mode. 
81 * HANGUP *
Used during trace mode. 
82 * BRK *
Used during trace mode. 
83 * DTD *
Used during trace mode. 
84 * DTR *
Used during trace mode. 
85 * SEQUENCE *
Used during trace mode. 
86 * ESCAPE *
Used during trace mode. 
87 * BUTTON3 *
Used during trace mode. 
88 * BUTTON2 *
Used during trace mode. 
89 * BUTTON1 *
Used during trace mode. 
90 Not implemented
Used by filing system. 
91 Bad part
Used by filing system. 
92 End of File
Used by filing system. 
93 Not last
Used by filing system. 
94 File not opened
Used by filing system. 
95 File not closed
Used by filing system. 
96 No/Bad BUFFER
Too small BUFFER in FAX SEND/RECEIVE or 
PLAY/RECEORD. 
97 No disk
No hard disk found. 
100 No net
No LAN filing system (NETWORK). 
101 No server
No network server found (doesn’t react).  
102 No clock
No network clock found. 
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
256
  
BASIC Keywords and associated short forms 
ABS AB. 
ELSE EL. 
ADC AD. 
END E. 
ALL AL. 
ENGLISH ENG. 
ANSWER AN. 
ERL ERL 
ASC AS. 
ERN ERN 
AT AT 
ERROR ER. 
AUTO A. 
ESCAPE ES. 
BAUD BA. 
FALSE FA. 
BRK BR. 
FILE FI. 
BUFFER B/ 
FOR F. 
BUTTON BUT. 
FREQ FR. 
CALL CA. 
GERMAN GE. 
CHR$ CH. 
GET GET 
CLEAR C. 
GET$ GET. 
CLOCK$ CLO. 
GOSUB GOS. 
CONNECT CO. 
GOTO G. 
COPY COP. 
HANDSHAKE HAND. 
CRC CR. 
HANGUP H. 
CTS CT. 
HOOK HO. 
DATA DA. 
HOUR HOU. 
DATE$ DATE. 
IF IF 
DAY DAY 
ILINE IL. 
DCD DC. 
INPUT I. 
DDAY DD. 
IPORT IP. 
DELETE DE. 
KEY KEY 
DIAL DI. 
KEY$ KE. 
DIM DIM 
LCASE LCASE 
DIR DIR 
LCASE$ LC. 
DO D. 
LED LED 
DSR DS. 
LEFT$ LE. 
DTD DTD 
LEN LEN 
DTR DT. 
LENGTH LEN. 
DUTCH DU. 
LINEFEED LIN. 
ECHO EC. 
LINK | 
LIST . 
RIGHT$ RI. 
LOAD LO. 
RING RIN. 
LTRIM$ LT. 
RND RN. 
MATCH MA. 
RPT$ RP. 
MID$ MI. 
RTRIM$ RT. 
MIN MIN 
RTS RTS 
MODEM M. 
RUN R. 
MONTH MON. 
SAVE SA. 
NEW NEW 
SBITS SB. 
NEXT N. 
SEC SEC 
NOT NO. 
SEND SE. 
OFF OF. 
SEQUENCE SEQ. 
OLD O. 
SGN SG. 
OLINE OLI. 
SLASH SL. 
ON ON 
SOUND SO. 
OPORT OP. 
SPC$ SPC. 
ORI OR. 
SPEAKER SP. 
OUTPUT OU. 
SREG SR. 
PARITY PA. 
STEP STE. 
PBOT PB. 
STOP S.  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
257
  
PEEK PEEK 
THEN TH. 
PEEK$ PE. 
TIME$ TIME$ 
PLAY PL. 
TIMEOUT TI. 
POKE POKE 
TO TO 
POKE$ PO. 
TONE TO. 
PORT POR. 
TRACE T. 
PRINT ? 
TRIM$ TRI. 
PRINTER P. 
TRUE TRU. 
PTOP PT. 
UCASE UCASE 
PULSE PU. 
UCASE$ UC. 
PUT PUT 
UNTIL U. 
PUT$ PU. 
VAL VAL 
READ REA. 
VAL$ VA. 
RECEIVE REC. 
VOICE VO. 
RECORD RECO. 
VOLUME VOL. 
REM REM 
WAIT W. 
RENAME RENA. 
WEND WE. 
RENUM RE. 
WHILE WH. 
REPEAT REP. 
XOFF X. 
REPORT REPO. 
XON XON 
RESET RESE. 
YEAR Y. 
RESTORE RES. 
  
RESULT RESU. 
  
RETURN RET.