Vidicode Argus Basic Programmers Reference Manual

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
78
  
FAX ON/OFF    turn FAX on or off 
With FAX ON the modem will wait for an answer tone after dialing and then return with result code 19 (=ESCAPE).  The 
FAX SEND and FAX RECEIVE commands will both automatically set FAX ON. 
With FAX OFF the modem tries to connect as a modem. 
Examples: 
FAX ON
DIAL TONE 123456
IF RESULT=19 GOTO Continue ELSE GOTO Error
Syntax: 
FAX [ON|OFF]
See also: 
FAX SEND,...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
79
  
FAX RECEIVE    receive fax 
The FAX RECEIVE command is a powerfull tool that allows the Argus to receive a fax directly onto the disk filing system.  
Before using the FAX command a RAM buffer of at least 1024 bytes big must be defined with the BUFFER command. 
 
The FAX RECEIVE command consists of three parts. 
FAX RECEIVE [file] 
Filename can have a maximum of 10 characters.  No wildcards are...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
80
  
FAX SEND ...TO...    send fax 
The FAX SEND command is a powerfull tool that allows the Argus to send a fax from the disk filing system.  Before using 
the FAX command a RAM buffer of at least 1024 bytes big must be defined with the BUFFER command. 
 
The FAX SEND ... TO ... command consists of three parts. 
FAX SEND [file] 
The file name can be any name up to 16 characters long. If the file...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
81
  
 
When a file name ends with ‘.G‘ it will be treated as a G3 file with an unknown resolution. How the file is sent depends on 
the negotiation of the 2 fax machines and on the way the resolution is set with S-register 17. 
 
Page numbers can be maximum of .99 (after that it will continue with .AO, .A1, .....til .Z9). 
FAX SEND [file], [option] 
Some options can be added to the command: 
,U
;...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
82
  
During the handshaking process, the two faxes exchange their IDs.  The ID numbers are strings with a maximum length of 
20 characters and may (officially) only contain numbers and the characters + and -.  The ID of the receiving fax machine 
will be stored at address &2950 after leaving the FAX SEND command, while your own ID must be stored at address 
&2970 before executing the FAX SEND...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
83
  
After FAX SEND, it contains the total number of files sent. 
After FAX RECEIVE, it contains the number of pages received. 
RESULT is a function which holds the status of the last modem activity: 
 
RESULT = 0 OK
:  Sending or Receiving was successful 
RESULT = 2 RING
:  File not found with FAX SEND (special case) 
RESULT = 3 NO CARRIER
:  Initiate handshake with other fax has failed 
RESULT = 4...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
84
  
Setting this parameter to 0 will disabled the automatic page-break generation.  A new page is also forced if the file contains a 
control-character 12 (=CTRL-L=Form Feed).  If  a control-character 26 (=CTRL-Z=End Of File) is encountered the sending 
stops. 
 
3. Left margin: 
 
Enabling the left margin will add some spaces in front of a line, if that line is less than 80, 96 or 136 characters....

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
85
  
FOR ... (TO) ... (NEXT) ... (STEP)    loop structure 
The Argus BASIC FOR ... NEXT loop construct is very similar to that used in most versions of BASIC, and allows a 
sequence of commands to be executed a fixed number of times depending upon the value of a loop variable. 
 
For example: 
10 PRINT Start
20 FOR X=1 TO 10 : PRINT X; ; : NEXT X
30 PRINT End
will display: 
Start
12345678910
End...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
86
  
The trailing comma in this example is necessary to ensure that the outer NEXT loop variable is incremented. 
Examples: 
FOR Code = 32 TO 126 : PRINT CHR$(Code) : NEXT
FORX=0TO-10STEP -2 : PRINT X : NEXT
Syntax: 
FOR [num-var] = [integer] TO [integer] (STEP [integer]) : [command] :
.... NEXT ([num-var]) (,)
See also: 
REPEAT ... UNTIL, WHILE ... WEND
  

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
87
  
FREQ    frequency measurement 
The frequency of the signal on the telephone line is permanently measured by the modem.  When the modem is off-hook, the 
command FREQ will read this value.  This is only useful for specialist applications; but we can think of some very special 
ways of using it for access control of your computer. 
 
The value is updated every 100ms by the operating system....