Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
68
  
DUTCH    select language and screen mode 
The command DUTCH will, like ENGLISH, select the language for the few written messages that are part of the system.  
The reason for this is that these messages will also occasionally be sent over the telephone line to remote users.  This is 
especially the case when the modem is used as an electronic mail computer. 
 
The 5 possible parameters behind DUTCH will have effect on the SEND,T and FAX SEND commands. 
DUTCH ,,,,
   = 0-255 = Characters per Line (0=OFF) 
   = 0-255 = Lines per Page (0=OFF) 
   = 0/1 = No/Yes Left Margin 
   = 0/1 = No/Yes Page Fillout 
   = 0/1 = No/Yes Clear Screen (ASCII 12) after Verder 
Examples: 
DUTCH
DUTCH 80, 23, 1, 0, 1
DUTCH 255, 66, 1, 1, 0
Syntax: 
DUTCH ( [int 0..255] ), ( [int 0..255] ), ( [int 0..1] ), ( [int 0..1]
), ( [int 0..1] )
See also: 
ENGLISH
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
69
  
ECHO    enable/disable character echo 
ECHO is used to turn local character echo on or off.  While in command mode or when using the INPUT or AT commands, 
characters received via the input port are echoed back so that the sender can see what has been received (or, in the case of 
a terminal, what he is typing).  This is known as local echo.  If both the modem and the users terminal provide echo in this 
way, the user will see two of everything he types, and echo should then be disabled on either the modem or the terminal. 
Examples: 
ECHO ON
ECHO OFF
Syntax: 
ECHO (#[PORT],) (#...,) ON|OFF
See also: 
AT, INPUT, RECEIVE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
70
  
END    end of program 
The END command is used to terminate program execution and return to command mode.  For example: 
50 Ch$=GET$
60 IF Ch$=Q or Ch$=q THEN END
END is also used in conjunction with the TIMEOUT command to indicate the end of a timeout subroutine. 
Example: 
END
Syntax: 
END
See also: 
ON TIMEOUT, STOP
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
71
  
ENGLISH    select language and screen mode 
The command ENGLISH will, like DUTCH, select the language for the few written messages that are part of the system.  
The reason for this is that these messages will also occasionally be sent over the telephone line to remote users.  This is 
especially the case when the modem is used as an electronic mail computer. 
 
The 5 possible parameters behind ENGLISH will have effect on the SEND,T and FAX SEND commands. 
ENGLISH ,,,,
   = 0-255 = Characters per Line (0=OFF) 
   = 0-255 = Lines per Page (0=OFF) 
   = 0/1 = No/Yes Left Margin 
   = 0/1 = No/Yes Page Fillout 
   = 0/1 = No/Yes Clear Screen (ASCII 12) after More 
Examples: 
ENGLISH
ENGLISH 80, 23, 1, 0, 1
ENGLISH 255, 66, 1, 1, 0
Syntax: 
ENGLISH ( [int 0..255] ), ( [int 0..255] ), ( [int 0..1] ), ( [int
0..1] ), ( [int 0..1] )
See also: 
DUTCH 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
72
  
EOR    logical Exclusive OR 
EOR performs a bitwise logical Exclusive OR operation on two numeric values; i.e. each bit of the first operand is Exclusive 
ORed with the equivalent bit in the second operand.  The result of 12 EOR 5 is therefore calculated as follows: 
 operand1 12 = 00000000 00001100 
 operand2   5 = 00000000 00000101 
 result 9 = 00000000 00001001 
The most common use of EOR is to toggle a bit value within an item of data. 
For example, to toggle the state of user port line 5 you would use: 
OLINE(5) = OLINE(5) EOR 1
If the state of the line was previously high, the command is the same as: 
1 EOR 1
which gives 0 - i.e OLINE(5) goes low. 
 
If OLINE(5) was already low, the command is the same as: 
0 EOR 1
which gives 1 and sets OLINE(5) high. 
 
Examples: 
DCD=DCD EOR 1
PRINT 15 EOR 4
Syntax: 
[num-var] = [integer] EOR [integer]
See also: 
AND, OR, NOT 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
73
  
ERL    error line 
ERL is a system variable that contains the number of the line that is currently being executed.  As a result of this, when an 
error occurs, ERL contains the line number in which the error occurred.  Therefore you should be careful.  ERL should be 
stored or printed in the first line of the error handler routine. 
Examples: 
ON ERROR PRINT ERL
ON ERROR PRINT Program halted due to error at
line ;ERL : STOP
Syntax: 
[num-var] = ERL
See also: 
ERN, ON ERROR, REPORT
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
74
  
ERN    error number 
ERN is a system variable that contains the number of the last error that occurred.  A complete list of error messages and the 
associated codes generated by the Argus BASIC interpreter is given in the Error Messages section of this manual. 
 
ERN is also an important variable for the filing system. 
Example: 
PRINT ERN
Syntax: 
[num-var] = ERN
See also: 
ERL, ON ERROR, RECEIVE, REPORT, SEND
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
75
  
ESCAPE    set Escape character 
The ESCAPE command is used to define the ASCII character that the modem treats as an Escape code (this is only 
sometimes related to the [Esc] key on your keyboard). 
An Escape is used to interrupt the execution or listing of a program. 
 
The default value for ESCAPE is [Ctrl-C]. 
 
For instance, to use ASCII character 04 ( [Ctrl-D] ), as the ESCAPE character you would use the command: 
ESCAPE=4
On reception of the ESCAPE character, error number 3 will be generated and any pending ON ERROR routine will be 
executed.  All I/O buffers will be emptied, all RTS lines will be activated, and all output buffers will be enabled. 
 
There can be only one escape character for all ports at any time. 
 
Escape recognition can be disabled using ESCAPE OFF, and is re-enabled using ESCAPE ON.  Enabling and disabling 
of escape recognition can be per port.  When no port number is specified, the default port as defined by OPORT will be 
assumed.  In any other case you must specify the port; e.g. ESCAPE#3 OFF. 
 
After pressing the STOP button, the Escape character for each port will be reset to [Ctrl-C], with handling of ESCAPE 
characters being enabled for port 1, and disabled for all other ports. 
Examples: 
ESCAPE 3
ESCAPE=27
ESCAPE#1,#2,#3,1
ESCAPE ON
Syntax: 
ESCAPE ( #[port], ) (#...) (=) [integer 1..128]
ESCAPE ( #[port], ) (#...) ON|OFF
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
76
  
FALSE    Boolean system variable 
FALSE is a system variable which returns the value 0, and it is used in many logical operations to make programs more 
readable.  A further advantage of using FALSE (in the correct context), is that it uses only 1 byte of storage, whereas the 
integer 0 occupies 2 bytes. 
Examples: 
Ready=FALSE
REPEAT ... UNTIL FALSE
IF X=FALSE
Syntax: 
[num-var] = FALSE
See also: 
NOT, TRUE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
77
  
FAX MODEM ON/OFF    enable/disable selector 
This is used in the programming environment to enable/disable 
the Fax  Modem selector.  Same as AT *F3. 
 
The selector is used during the first stage after answering a call. It will wait some time for a Fax or Modem Calling Tone 
(1100 or 1300 Hz). Default 5 seconds is waited and this can be changed by setting SREG62 per 100 ms. 
If no Calling Tone is ‘seen’ the modem continues as a Fax (bit0 in SREG62 is 0) or as a modem (bit0 in SREG62 is 1). 
Example: 
ON HANGUP FAX MODEM ON
Syntax: 
FAX MODEM [ON|OFF]
See also: 
ANSWER, FAX