Vidicode Argus Basic Programmers Reference Manual

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
178
  
PTOP    program top 
This is an important (read-only) system variable that contains the address where a BASIC program ends.  The length of the 
program can be determined by subtracting the value of PBOT from PTOP: 
PRINT PTOP-PBOT
PTOP is useful when more than one program is stored in memory: 
start1=PBOT
PBOT=PTOP-1
(NEW)
LOAD ...
PBOT=start1
RENUM
Examples: 
End=PTOP
PRINT ~PTOP
Syntax:...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
179
  
PULSE    pulse dialing 
PULSE is used to select pulse dialing in dial commands, or to dial just one or more digits. 
Examples: 
DIAL PULSE 123456
PULSE 8
PULSE 2,6,4
Syntax: 
DIAL PULSE [string]
PULSE [integer] (,[...])
See also: 
TONE
  

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
180
  
PUT    write byte value to port 
PUT is used to write single byte values to the specified output port(s). 
 
If the port number is omitted, the default output port as defined by OPORT will be assumed.  The character to be written is 
given as a single byte which represents its ASCII value. 
 
For example, the command: 
PUT#1,65
will write ASCII character 65 (the letter A), to port 1 and is...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
181
  
PUT$    write character to port 
PUT$ is used to write single ASCII characters to the specified output port(s). 
If the port number is omitted, the default output port as defined by OPORT is assumed.  The character to be written is given 
as a single character string. 
For example: 
PUT$#1,A
will print the character A to port 1.  If the parameter string is longer than a single character, only...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
182
  
READ    read data items 
READ is used to read information stored in DATA commands into integer or string variables.  As many items of data are 
read as is necessary to assign to the variables given in the READ command. 
 
If there is insufficient data to satisfy the READ, an Out of Data error message will be given. 
Examples: 
READ Name$,Code
READ Port(I),Rate(I),Wlen(I)
READ X,X$(X),Y,Y$(Y)...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
183
  
RECEIVE    receive file or data 
RECEIVE is one of the most powerful commands available with this modem, and provides a simple means of transferring 
data into the modem under program control, with minimum effort. 
 
There are 3 basic forms of the command: 
RECEIVE [port],[address]   : receive data using Xmodem 
RECEIVE [port],[filename],[type] : receive file 
RECEIVE ALL: receive a backup of...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
184
  
RECEIVE #[port], [address]    receive data 
Here, RECEIVE is used to transfer data as opposed to a file, using the Xmodem file transfer protocol to prevent the 
occurrence of errors. 
 
The command is followed by a port number (1 - 3 only) and an address, which are both optional. 
 
If the parameters are omitted, the default input port as defined by IPORT, and the start address defined by...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
185
  
RECEIVE [filename], [type]    receive file 
When followed by a string, the RECEIVE command is used to receive and store complete files in the filing system: 
RECEIVE [filename]
All types of files discussed under the DIR command may be received, and there are various options which are discussed 
below. 
RECEIVE [filename] (,T/N) 
RECEIVE without a parameter, or with the ,T parameter, prepares...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
186
  
30 REPEAT
40 INPUT Enter Source file : ; Src$
50 MATCH Src$
60 IF NOT MATCH PRINT No such file : GOTO 40
70 INPUT Enter Destination file : ; Dest$
80 CLEAR#8
90 SEND#8, Src$, F
100 RECEIVE#8, Dest$, F
110 Print File copied OK
120 UNTIL FALSE
In this case, no timeout condition is applied and the RECEIVE will terminate automatically when the buffer is empty.  The 
buffer size specified must be...

ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
187
  
 
If Ymodem-Batch is used, the system variable MATCH contains the number of files received. 
RECEIVE [filename],C 
The RECEIVE,C command is very useful in combination with the SEND,C command to create and restore file copies.  
The used filename is not important (but must be filled in), because the received file contains all the original Argus filenames.  
All other Argus-filing-system related...