home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / BASIC / SNOB01.ZIP / README.DOC < prev    next >
Encoding:
Text File  |  1985-07-15  |  6.4 KB  |  130 lines
  1. INFORMATION REGARDING FILES ON THIS DISK CAN BE FOUND IN THE FILE
  2.  
  3. DIREC.DOC
  4.  
  5. Documentation for SNOBASIC in a binder as well as source code
  6. for the basic routine ADVNT and SNOTERM, SNOBACK and SNOREST
  7. are available for $39.95 from Snowcrest Computer Specialties,
  8. 527 McCloud Ave., Mt. Shasta, CA  96067.
  9.  
  10. This file contains updates and documentation of new features in
  11. SNOBASIC. Please make notations in the manual to refer to the topics
  12. given here.
  13.  
  14. CTRL-S vs. CTRL-NUM LOCK
  15.  
  16.     SNOBASIC provides ctrl-s as a means to pause printed output. Ctrl-s
  17.     is used in place of ctrl-num lock since terminals attached to the
  18.     serial cards (COM1 and COM2) do not have a num lock key. Ctrl-num
  19.     lock also has the problem that it is implemented by actually stopping
  20.     the processor of the computer (placing it in a tight loop) until
  21.     the next key is pressed. If you use this feature, you will stop
  22.     all processing on your program (thus stopping your screen output
  23.     as you desired), but you will also stop all processing on all other
  24.     terminals which are attached to the system! If you use ctrl-s, you
  25.     will only stop your screen output and others may continue their
  26.     processing. To start your screen again, use ctrl-q.
  27.     
  28. NEW OPTION ON SAVE AND PSAVE COMMANDS
  29.     
  30.     A protection option has been added to the Save and Psave commands
  31.     which allows you to save a program in such a way that it may never
  32.     be listed. After saving in this manner, the program may be loaded
  33.     and run but the List command, Length command, Save command and Psave
  34.     command will be inhibited. The option immediately protects the version
  35.     of the program which is in memory also, so you must be sure that
  36.     you have another copy saved elsewhere before using this option.
  37.     In either the Save or Psave command, us the letter "p" and a comma ","
  38.     before the file name:
  39.         Save p,prog1
  40.     
  41. ENLARGING SYSTEM FILES - BASICLOGS, BASICACCTS
  42.  
  43.     The four system files, Basiclogs, Basicaccts, Basicerror and Basicmesgs
  44.     are opened by SNOBASIC as soon as the system starts. These files are
  45.     not closed until the "Kill" command is given to return to DOS. Thus,
  46.     the size of the files must not be changed "out from under" SNOBASIC.
  47.     The recommended procedure to be used to enlarge these files is as
  48.     follows:
  49.     
  50.     While SNOBASIC is running, create a new file with a different name
  51.     for one of the system files, making it as large as you desire it to
  52.     be (Create "newlogs",100). Then copy the present contents of the
  53.     old file to the new file (Copy "basiclogs","newlogs"). Bring the
  54.     system down (Kill), change to the directory which contains the
  55.     file (cd \dk0), delete the old file (del fbasiclogs) and rename
  56.     the new file (ren fnewlogs,fbasiclogs).
  57.     
  58. NEW ENVIRONMENT VARIABLES
  59.  
  60.     The "Configuring" section of the manual describes the environment
  61.     variables and discusses their use. Two new variables have been added:
  62.     
  63.     PC -- Print "shorthand" character. Usually 63 (?). This is the
  64.           character which will be interpreted by SNOBASIC as the word
  65.           "Print". If it is desired to use a character other than the
  66.           question mark, set PC to the ascii value (see appendix A)
  67.           of the character desired. Using an unshifted character
  68.           is sometimes easier than the shifted question mark.
  69.     
  70.     DS -- DOS output switch. If this variable is set to 1 (normal),
  71.           output to the screen will be passed through DOS. This allows
  72.           SNOBASIC to work on computers where the screen address in
  73.           memory is not in tbe B000 page. This also allows the use
  74.           of the ANSI.SYS screen driver (for output only - does not
  75.           work with the keyboard). Setting this variable to zero
  76.           (0), however, greatly speeds screen output since SNOBASIC
  77.           will then write directly to the screen, bypassing DOS.
  78.  
  79. NEW SYS FUNCTION
  80.  
  81.     Sys(17) has been added. This function will return the value of the
  82.     EIA port status word. The value returned may be interrogated as
  83.     follows:
  84.     10 Rem the variable A should be set to the bit number desired
  85.     15 Rem in this case we are checking carrier detect (see below)
  86.     20 Let A=7
  87.     30 Let S=mod(int(sys(17)/(2^A))/2)
  88.     40 If S=1 then Print "Caller is connected"
  89.     50 If S=0 then Print "Caller has hung up"
  90.     The table of status values by bit number is as follows:
  91.     
  92.      0 - Clear to send has changed
  93.      1 - Data set ready has changed
  94.      2 - Ring detect has changed
  95.      3 - Carrier detect has changed
  96.      4 - Clear to send (1=true)
  97.      5 - Data set ready (1=true)
  98.      6 - Ring indicator (1=true)
  99.      7 - Carrier detect (1=true)
  100.      8 - Received character ready to be read (not likely to be noticed
  101.      before SNOBASIC handles the character)
  102.      9 - Overrun error (not likely to occur)
  103.     10 - Parity error (can not happen - SNOBASIC initializes for no parity)
  104.     11 - Framing error (may happen as terminal connects or disconnects)
  105.     12 - Break detect (not likely to be noticed before SNOBASIC handles
  106.      the break)
  107.     13 - Transmitter holding register empty (will be true when not
  108.      transmitting characters)
  109.     14 - Transmitter shift register empty (same as 13)
  110.     15 - Time out (can not happen - SNOBASIC does not wait for clear to
  111.      send or Data set ready before transmitting)
  112.  
  113. ADDITIONAL FLEXIBILITY IN COPY COMMAND
  114.  
  115.     The Copy command no longer must have the destination file already
  116.     Created before use. If the destination file does not exist on the
  117.     directory specified, it will automatically be created with the same
  118.     size and attributes as the source file. If it already exists, it will
  119.     be checked to insure that it has the same attributes as the source
  120.     file and an error message will be issued if not. If the destination
  121.     file is larger than the source, the source will be copied into the
  122.     beginning of the destination file, leaving the rest of the destination
  123.     file undisturbed. If the destination file is smaller than the source,
  124.     it will be extended to the size of the source (this can be dangerous
  125.     if another user has the destination file open when the copy occurs.
  126.     The copy would extend the file. Then the other user would set it back
  127.     to its original size when he closed the file. Flexibility sometimes
  128.     must be used with caution!)
  129.  
  130.