Vidicode Argus Basic Programmers Reference Manual

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
138
  
ON BUTTON    USER button event handler 
ON BUTTON is used to automatically detect the operation of the USER buttons on the modems front panel.  Pressing one 
of these buttons will result in the immediate execution of the command following the ON BUTTON command. 
10 REM Button demo
20 ON BUTTON1 GOTO %Keypress
30 %Start
40 REPEAT
50 PRINT GET$;
60 UNTIL FALSE
70 %Keypress
80 PRINT BUTTON1...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
139
  
ON CONNECT    connection detect event handler 
This event handler can be used to automatically detect when a connection has been established with a remote system.  Thus 
waiting for an incoming call can be a background process for your modem.  This means that your modem can be doing many 
other things while waiting for a call.  The only thing you have to do is to tell your modem once which...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
140
  
ON DTD    DTR loss event handler 
There are two associated events, DTD (Data Terminal [Ready] Drop) and DTR (Data Terminal Ready).  These events help 
your program respond to the status of your terminal. 
 
For more information please refer to the description of ON DTR on the following page. 
Examples: 
ON DTD GOSUB Mailbox-entry
ON DTD OFF
Syntax: 
ON DTD ...
ON DTD OFF
See also: 
ON DTR, DTR
  

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
141
  
ON DTR    DTR event handler 
When you enable a terminal program, or switch a terminal on, DTR goes high on the port to the modem.  Your modem can 
react to this event with whatever procedure you like.  Like any event handler, this is a background process. 
 
A likely use of this command is to let your modem go from whatever it is normally doing (e.g. operating as a mailbox) to 
modem mode as...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
142
  
ON ERROR    error handler 
The ON ERROR event handler allows errors that occur during the execution of a program to be trapped so that the 
appropriate corrective action can be taken.  When ON ERROR is active, a run-time error will cause program execution to 
jump to the first command following ON ERROR. 
 
ON ERROR is often used with ERL, ERN and REPORT to obtain precise information about...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
143
  
ON ESCAPE    Escape event handler 
This event handler can be compared with ON ERROR, but will trap an escape only; and will only work when your BASIC 
program is running. 
 
ON ERROR will also trap an escape, but this event handler is easier to use if you want to trap escapes only. 
 
ESCAPE events can only occur when escapes have been enabled with the ESCAPE command. 
Examples: 
ON ESCAPE...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
144
  
ON ... GOSUB/GOTO    jump on value 
ON...GOSUB and ON...GOTO are used to jump to another section of code depending on the value of a variable.  For 
instance, if the user is asked to choose one item from a list of options, an ON...GOSUB command could be used to 
execute the appropriate section of code for each option: 
500%Menu
510 PRINT 1) Read message
520 PRINT 2) Send message
530 PRINT 3)...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
145
  
ON HANGUP    loss of connection event handler 
When the modem is used to process incoming calls the ON HANGUP event handler can be used to automatically detect 
when the connection has been lost. 
 
Both ON HANGUP and ON CONNECT remain active after program execution has ceased.  ON HANGUP OFF should 
therefore always used to disable the event handling at the end of a program. 
 
Pressing the...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
146
  
ON OFF    disable events 
The command ON OFF will disable all ON-events except ON RESET and 
ON ERROR. 
Example: 
ON OFF
Syntax: 
ON OFF
  

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
147
  
ON RESET    reset event handler 
ON RESET provides one of the most useful facilities in the modem, by allowing program operation to resume automatically 
at a predetermined point, following a RESET or power failure.  The result of the reset procedure is that you can depend on 
your modem to do exactly what you want it to when you power it up. 
 
There are four ways in which a reset may occur:...