Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
58
  
DIAL    dial number 
This command will dial a number for you.  It is the same as ATD in modem mode, and is provided mainly to make your 
program easier to read. 
 
After the command DIAL, the system variable RESULT can be read to determine the status of the modem (BUSY, NO
ANSWER, CONNECT, etc.).  When a successful modem connection is made, DCD#3 will be set.  This can also be 
detected with the ON CONNECT event. 
Examples: 
DIAL TONE 2702719
DIAL PULSE VIDICODE$
Syntax: 
DIAL (TONE|PULSE) [string]
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
59
  
DIM    reserve space for arrays 
DIM (short for dimension), is used to reserve space for single dimension arrays of integers or strings.  The maximum 
number of elements allowed in integer arrays is theoretically 32767, but is in practice limited by the amount of memory 
available for variables after the program has been loaded.  The limitation of a maximum string length of 254 bytes still current 
in the Argus Communicator has now been removed. 
 
The command: 
DIM A(100)
defines A as being an array of 100 integers (indexed from 0099); i.e. the first element is numbered 0.  To access the fifth 
element use: 
A(4)
Similarly: 
DIM A$(8)
reserves space for the array A$ with 8 strings of up to 255 characters.  The actual amount of space used by the array will 
depend upon the values assigned to the elements. 
 
A very different use of the DIM command is to find and reserve free space in memory.  If you need free space just enter: 
DIM [num-var] [integer]
The number of bytes as given by the integer is reserved, and the numeric variable will point to the first location of the 
memory space reserved for you. 
Examples: 
DIM Names$(20) , ID$(5)
DIM Primes(10)
DIM A 256
 
Syntax: 
DIM [num-var] ( [integer])(,...)
DIM [string-var] ( [integer 0..254])(,...)
DIM [num-var] [integer]
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
60
  
DIR    list file directory 
The DIR command is used in its various forms to list and inform you about the contents of the RAM-disk. 
 
Because of the need to retain compatibility with earlier versions of Argus BASIC, DIR might be followed by FILE or !.  
This is optional however, and thus will not normally be used. 
 
The DIR command will list files stored in the RAM-disk.  The format and level of information given in the listing depends on 
the parameters used in the command.  The following options are available: 
DIR ([string])   standard listing 
DIR ([string]),A All available information 
DIR ([string]),B information Block listing 
DIR ([string]),D  standard listing plus file creation Date 
DIR ([string]),F special File information listing 
DIR ([string]),N file Names only listing 
DIR ([string]),R Restricted listing 
In each case the [string] parameter provides a template for filenames to be included in the listing.  The asterisk, *, can be 
used as a wildcard to match any valid character. 
If no [string] parameter is given, all files will be listed. 
 
The formats of the various directory listings are as follows: 
Standard 
[FN] [Size] [Name+Ext] 
,B (Blocks) 
[Information block contents] 
,A (All) 
[FN] [Name+Ext] [Date] [Time] [Read] [Type] 
,D (Date) 
[FN] [Size] [Name+Ext] [Date] [Time] 
,F (special) 
[FN] [Size] [Name] [Date] [Read] [Info] 
,N (Name) 
[Name] 
,R (Restricted) 
[FN] [Size] [Name] 
where the following definitions are used: 
[FN] 
the file number 
[Size] 
the number of 256-byte RAM disk blocks occupied by 
the file 
[Name+Ext] 
the full name of the file (including extensions) 
[Name] 
the first part of the file name (e.g. MESSAGE1) 
[Date] 
the creation date of the file (DD/MM) 
[Time] 
the creation time of the file (HH/MM) 
[Read] 
R for Read, U for Unread 
[Type] 
the type of file 
After these options there are two more, which can always be added 
 ,U   (Unread only) 
 ,M   (more function) 
The more function will, after sending a screenful of lines, ask you for confirmation before it will send the next screenful.  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
61
  
 
There are four possible file types: 
B 
: BASIC program 
T 
: Text file; created by RECEIVE ...,T 
X 
: binary file created by RECEIVE ...,X  (X-MODEM or Y-MODEM) 
The directory command lists files in date order, oldest first, and prints the number of free blocks remaining at the end of the 
list (not with DIR,N). 
 
The command DIR, B is used to list the contents of the information block associated with the file.  This block contains 32 
bytes of application-dependent information and is terminated with [CR] (see SEND and RECEIVE for further information). 
 
Directories are listed to the specified port, or if this is omitted, to the default output port as defined by OPORT. 
Examples: 
DIR, U
DIR, M
DIR#2
DIR#1 *.MSG?, N
DIR !LETTER+VAL$(nn), D
DIR !A$
DIR FILE PETE.+Ext$, N
Syntax: 
DIR ( #[port] , ) (FILE|!) ( [string])(,[option] )
[option]=A|B|D|F|N|R|U|M
See also: 
LOAD, SAVE, RECEIVE, SEND
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
62
  
DIR ROM    list ROM directory 
The DIR ROM command is used to access the ROM or RAM disk in socket 2.  The command is used in its various forms 
the same as listed in the DIR command. 
 
However, to access a RAM disk in socket 2, the command CLEAR ROM must be entered first. 
See also: 
DIR, ROM
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
63
  
DIV    integer divide 
The DIV command is used to carry out integer division operations.  As the modem does not support real numbers, DIV is 
exactly equivalent to division using the / operator. 
Examples: 
Result=XDIV5
Q1 = (Q2*4) DIV (Q3+2)
Syntax: 
[num-var] = [integer] DIV [integer]
See also: 
MOD
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
64
  
DSR    Data Set Ready 
DSR is an RS232 signal used by modems to indicate that they are powered-up and ready to transfer data.  DSR will be 
active dependant on the setting with the modem command &S.  The signal is an output to the modem. 
 
The DSR command is used to set or read the status of the DSR line on the specified port.  When used for reading it returns 
TRUE if DSR is active, and FALSE otherwise. 
Examples: 
DSR ON
DSR=0
Status = DSR
PRINT DSR
Syntax: 
DSR= [num-var]
DSR ON/OFF
[num-var] = DSR
See also: 
DCD, DTR
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
65
  
DTMF ON/OFF    dial tone multiple frequency 
DTMF ON turns on the DTMF receiver.  Reading the first DTMF value and the command VOICE will also turn it on.  
Therefore, use of the command, is optional. 
 
DTMF OFF turns off the DTMF receiver. 
 
In most cases, the modem has 2 DTMF receivers build in. They can be selected with S-register 23 bit6 as follows: 
SREG23=SREG23 AND &BF: Select External DTMF-chip (default) 
SREG23=SREG23 OR &40: Select Modem-chip
Example: 
DTMF ON
Syntax: 
DTMF ON | OFF, VOICE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
66
  
[var] = DTMF    read DTMF receiver 
Reading this function will return 0 or an ASCII number.  When it is used for the first time, it will also turn on the DTMF 
receiver. 
 
Values:  0 =  No DTMF detected 
  48 =  0 detected 
  49 =  1 detected 
  50 =  2 detected 
  51 =  3 detected 
  52 =  4 detected 
  53 =  5 detected 
  54 =  6 detected 
  55 =  7 detected 
  56 =  8 detected 
  57 =  9 detected 
  42 =  *  detected 
  35 =  # detected 
  65 =  A detected 
  66 =  B detected 
  67 =  C detected 
  68 =  D detected 
Examples: 
PRINT DTMF
Var=DTMF
REPEAT D=DTMF : UNTIL D
IF DTMF=52 GOTO %TONE4
Syntax: 
[var] = DTMF
See also: 
DTMF ON/OFF, PLAY [filename], VOICE 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
67
  
DTR    Data Terminal Ready 
DTR is the RS232 signal used by data terminals - also (host-) computers - to indicate that they are powered up and ready to 
transfer data.  The modem will automatically control the response to DTR according to the instructions given with the modem 
command &D. 
 
The DTR function is used to read the status of this signal on the specified port.  If no port is specified the default port defined 
by IPORT will be assumed. 
 
We would suggest that if you wish to make use of the DTR signal from within your BASIC application, you disable the 
automatic response to DTR. 
 
For enabling or disabling the automatic response (and also the ON DTR and ON DTD events), we suggest that you use 
the modem commands &D0 and &D1,&D2,&D3. 
Examples: 
PRINT DTR
IF DTR Welcome_User
X=DTR
Syntax: 
[num-var] = DTR ( #[port] )
See also: 
CTS, DCD, DSR, RTS