Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
218
  
SCAN   set answering speed/scan 
In the programming environment, the SCAN command is used to configure the answering procedure of the modem.  The 
command does the same as setting S-register 53: 
 
0 = Speed is determined by S-register 51
1 = Scan: V22bis >> V23 >> V21 >> V23(orig)
2 = Scan: V22bis >> V23 >> V21
3 = Scan: V23 >> V21 >> V22bis >> V34/V32bis
4 = Scan: V23 >> V22bis >> V34/V32bis
5 = Scan: V21 >> V22bis >> V34/V32bis
6 = Auto-mode V8 (default)
7 = Scan: V22bis >> V34/V32bis
Examples: 
SCAN 6
SCAN OFF (=0)
Syntax: 
SCAN [integer] 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
219
  
SEC    read/set seconds value 
SEC is used to read or set the seconds value on the internal clock/calendar. 
 
When reading it returns an integer from 0 to 59. 
 
Similarly, when setting, a value from 0 to 59 must be specified. 
 
An incorrect value will leave the current setting unchanged. 
Examples: 
SEC=40
PRINT SEC
Syntax: 
SEC = [integer 0..99]
[num-var] = SEC
See also: 
  CLOCK$, HOUR, MIN, TIME$  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
220
  
SEND    send file or data 
SEND is one of the most powerful commands available for use by the modem, and provides a simple means of transferring 
data from the modem under program control, with the minimum of effort. 
 
There are 3 basic forms of the command: 
SEND [port],[address]   : send data using Xmodem 
SEND [port],[filename],[type],[option] :  send file 
SEND ALL: send a backup of the disk 
 
In addition, the second form can be used with one of a number of file type specifiers and options, which are dealt with 
individually in the following sections. 
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
221
  
SEND #[port], [address], [address]    send data 
This form of the SEND command is used to transfer data from the modems memory to other systems.  The Xmodem error 
correction protocol is used to prevent errors occurring during the transfer, so the facility cannot be used if the destination 
system does not support Xmodem. 
 
A port number may be specified (1 to 3 only), but if this is omitted the default port as defined by OPORT will be assumed.  
Following this, two integer parameters are used to specify the start and end addresses for the data to be transmitted.  If 
these are omitted it is assumed that you wish to send the currently loaded BASIC program; i.e. the area of memory starting 
from PBOT and extending to PTOP. 
 
During the SEND, ESCAPE and XOFF are disabled for the specified port, and the character length is set to 8 bits.  On 
completion the original settings are restored. 
 
Error number 27 will be generated if no data is transferred for a period of 180 seconds, or when more than nine sequential 
block errors have occurred. 
 
A common use for this form of the SEND command is to upload the current BASIC program in system memory into a PC to 
use as a backup copy. 
Examples: 
SEND
SEND#2
SEND &8000,&C000
SEND#Port,Addr1,Addr2
Syntax: 
SEND ( #[port], ) ( [integer], [integer] )
See also: 
RECEIVE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
222
  
SEND [filename], [type], [option]    send file 
[With filing system software only.] 
 
When followed by an exclamation mark and a filename, the SEND command is used to transmit complete files from the disk 
filing system.  Wildcards may be used in the filename, so that a single SEND command may be used to transfer more than 
one file: 
SEND *.TXT
SEND MESSAGE*.*
The system variable MATCH can be read afterwards to check how many file there were send. 
 
If a file with the specified filename does not exist, the message Not found will be given (system variable ERN is set to 
73).  You may of course use MATCH FILE to check for the existance of the file before using SEND. 
 
The following types of transfer may be initiated: 
SEND#[port],[filename],B
: read file information block only 
SEND#[port],[filename],C
: make copy of file using Xmodem protocol 
SEND#[port],[filename],F
: binary output 
SEND#[port],[filename],N
: text output with NNNN protocol 
SEND#[port],[filename],P
: read part of a file 
SEND#[port],[filename],T
: text output 
SEND#[port],[filename],X
: use Xmodem or Ymodem protocol  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
223
  
If no port number is specified, the default output port as defined by OPORT will be assumed.  More than one output port may 
be specified for transfers other than those using Xmodem or Ymodem.. 
 
Data may be copied into the BUFFER by specifying port 8.  In this case you must ensure that the buffer is large enough to 
accommodate the file.  Once in the buffer, the file contents may be manipulated using commands such as INPUT#8, 
KEY#8, PUT#8, etc.  KEY$#8 is particularly useful for reading the file as it simplifies end-of-file detection: 
IF KEY$#8= THEN Eof=TRUE
If wildcards are used to specify multiple files, each will be separated from the next by four [CR] characters, and the MATCH 
command may be used on completion to show the number of files transferred. 
Options 
Two further options may be used in conjunction with some of the above types of transfer.  These are: 
 SEND ... ,[type],U: send Unread files only 
 SEND ... ,[type],M: send with More? prompt (text only) 
In most cases options may be used in conjunction with each other; i.e Unread files may be sent with the M option. 
SEND [filename] 
SEND without a type or an option will use the text output and is therefor the same as SEND,T.  As SEND uses the CTRL-Z 
character (ASCII 26) to determine the end of file, a binary file containing a CTRL-Z will not transmit correctly, and should be 
sent using the F or X type specifier. 
 
Both the U and M options may be used. 
SEND [filename],B 
SEND,B is used to copy the 32-byte information block, available in each file, into memory locations &2BE0 to &2BFF.  This 
block may then be manipulated using PEEK and POKE.  It can be written back to the file with the RECEIVE,B command.  
Wildcards are allowed, but only the first encountered file is taken. 
 
The U option can be specified. 
SEND [filename],C 
SEND,C takes one or more files and sends it as one file with Xmodem-CRC (PROTOCOL 1 is set automatically).  The 
contents of that file is unique to an Argus filing system; for each file it will hold the name, type, date & time, length and 
information block.  It is used to create backups and to transfer files from one Argus system to another as an exact copy. For 
example, to transfer a copy of all the program files: 
SEND *.PRG,C
SEND [filename],F 
SEND,F can be used to transfer any type of file as a stream of binary data, i.e. no formatting is carried out, and no error 
correction is provided.  It is recommended that this type of transfer is used for local purposes on a serial port or, if connected 
as a modem, in conjunction with MNP or V42 error correction. 
 
The U option can be specified. 
SEND [filename],N 
This is similar in operation to SEND,T but there are differences in the way multiple files are handled when using wildcards 
in the filename.   Individual files will be separated by [CR]NNNN[CR], and the last file in sequence will be terminated with 
[CR]NNNNE[CR].  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
224
  
 
Both the M and U options may be used. 
SEND [filename] (,[type]) ,P, (,[option]) 
This SEND command allows you to send a part of a file.  Each part contains between 1 and 2048 bytes, depending on the 
filing system (RAM/FLASH-disk or Hard-disk/LAN). 
The number of bytes in the requested part is returned in the system variable MATCH.  When the last part is sent, the system 
variable ERN is set to 92 (“End Of File”), else ERN will be 0 (“OK”). 
ERN can also be set to 73 (“Not found”), when the file is not found in the filing system.  A none existing part will cause ERN
91 (“Bad part”). 
 
A part can be sent with the T (Text) or F (Binary) type specifier, if not specified then Text is taken as the default.  Also the U 
and M options may be used. 
 
Example program: 
10 Num=0
20 REPEAT
30 Num=Num+1
40 SEND file,T,P,Num
50 UNTIL ERN
To sort out a binary file: 
10 BUFFER &1000
20 Numb=0
30 REPEAT
40 Numb=Numb+1
50 SEND#8,file,F,P,Numb
60 Part=MATCH : Last=ERN
70 FOR Coun=1 TO Part
80 Byte=KEY#8
90 REM do some stuff here with Byte
100 NEXT
110 UNTIL Last
SEND [filename],T 
SEND,T is used to send a file as text to a port.  A [Ctrl-Z] character (ASCII 26) in the file will be treated as an end-of-file 
character, and will terminate transmission.  Both the U and M options may be used. 
 
The format of the output to the specified port(s) depends on the 5 parameters set with the DUTCH or ENGLISH command: 
 
1. Characters per line: 
   
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
225
  
0  =  Word Warp disabled 
1-255  =  Word Wrap enabled for 1 till 255 characters per line 
 
Word Warp means that a whole word is started on a new line if it doesn’t fit on the current line. 
A new line is always generated after a character with the value equal to S-register 3 which defaults to control-character 13 
(=Cariage Return).  After each new line, a linefeed character is sent with the value equal to S-register 4 which defaults to 
control-character 10 (=LineFeed).  Automatic linefeeds can be enabled or disabled with LINEFEED ON/OFF. 
 
2. Lines per page: 
 
The maximum number of lines per page can be set with this parameter.  This is only of importance if the file is sent with the 
M option or if ‘page fillout’ is enabled. 
 
3. Left margin: 
 
Enabling the left margin will add some spaces in front of a line, if that line is less than the ‘characters per line’ parameter. 
 
4. Page fillout: 
 
Enabling the page fillout will fill the page with empty lines on the bottom until the ‘lines per page’ is reached. This is done for 
each page if the file is sent with the M option and always at the end of the text. 
 
5. FormFeed: 
 
If a file is sent with the M option, a control-character 12 (=FormFeed) is sent after the ‘lines per page’ is reached. 
SEND [filename],X 
SEND,X can be used to send any type of file using Xmodem or Ymodem error correction.  The PROTOCOLcommand 
must be set first to select the transfer protocol.  
As Xmodem breaks files down into 128- or 1024-byte blocks, the last block will be automatically padded with NULs (zero 
bytes) to the correct length. 
The Ymodem-Batch protocol does not include the date & time of the files, only filenames and length. 
SEND ROM [filename], [type], [options] 
SEND ROM is used to send one or more file on the ROM or  RAM chip in socket 2 of an Argus Programmable Modem. See 
ROMfor further details. 
The type and options are used in the same manner as with the normal SEND command. 
Examples: 
SEND TELEX.TXT
SEND *.TXT
SEND *+VAL$(Nr)+.CCI
SEND#3, Name$+CHR$(Nr)+.VIEW
SEND LETTER*.TXT, X
SEND#1, *.*, U
SEND#7, Name$, U
SEND 2000a.VIEW, B
Syntax:  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
226
  
SEND ( #[port] , ) (#...) [filename] ( , [type] ) ( , [option] )
SEND ROM ...
See also: 
MATCH, RECEIVE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
227
  
SEND ALL    make a backup of RAM disk 
The SEND ALL command is normally used to make a backup of the RAM-disk.  It sends the complete contents of the RAM 
chip as one file.  This file can be used later to restore a RAM-disk with RECEIVE ALL or the file can be used directly to fill 
an EEPROM chip that can be put into socket 2 of an Argus Programmable Modem. 
 
In a RAM-disk filing system this command differs from the command SEND,C which creates file copies. 
 
In a Hard-disk filing system, this command is exactly the same as SEND *.*.*.*.*.*,C. 
 
The Xmodem-CRC protocol is used for this purpose; PROTOCOL 1 is set automatically. 
Example: 
SEND ALL
Syntax: 
SEND (ROM) ALL
See also: 
RECEIVE ALL, ROM