home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / packet / ad14 / ad14dist.exe / README < prev    next >
Text File  |  1990-12-05  |  13KB  |  279 lines
  1.                    README file for ARES/DATA  Version 1.4
  2.  
  3. Welcome to ARES/DATA!  Your diskette contains the following files:
  4.  
  5. README          (This file itself)
  6.  
  7. DOCUMENTATION FILES:
  8.  
  9.         USERMAN.DOC     Packet operator full user manual
  10.         QUIKREF.DOC     Quick Reference Card for the packet operator
  11.         DRSI.DOC        Notes on the DRSI PC*PA packet adapter
  12.         SYSOP.DOC       Summary of SYSOP procedures and commands
  13.                         - READ THIS BEFORE ATTEMPTING TO RUN ARES/DATA
  14.         CONFIG.DOC      Notes on the config file
  15.         ARESDA01.PAP    Revised text of paper on previous version, 0.1
  16.         ARESDA10.PAP    Revised text of paper on previous version, 1.0
  17.  
  18.         INPUT.HLP
  19.         SEARCH.HLP
  20.         SUMMARY.HLP       These files are short reminders of the A/D
  21.         LIST.HLP          syntax and functions.  Put them in the \PUBLIC
  22.         CHANGE.HLP        subdirectory so that users can download them.
  23.         CONFBRGE.HLP
  24.  
  25. ARESDATA.CFG      An example configuration file
  26. STARTUP.TN1       An example startup file for a WA8DED TNC-1
  27. STARTUP.PCP       An example startup file for a DRSI PC*PA board
  28. STARTUP.P87       An example startup file for an AEA PK-87 w/ DED firmware
  29. STARTUP.TN2       An example startup file for a TNC-2 with DED firmware
  30. INFO              An example INFO file for ARES/Data - put in \public
  31.  
  32. ARESDATA.BAT      The startup batch file for running the program
  33. ARESDA14.EXE      The ARES/DATA program version 1.4
  34.                     Searches available on all 4 index fields
  35.                     Generated for 10,000 record database
  36. AD14-3.EXE        ARES/Data program with searches for fields 1, 2, or 3 only
  37. AD14-2.EXE        ARES/Data program with searches for fields 1, or 2    only
  38. AD14-1.EXE        ARES/Data program with searches for field  1          only
  39.                   (These three versions of the program may not be present on
  40.                    your disk.  If you want them, contact us.)
  41.  
  42. MBBIOS.COM        The MBBIOS memory-resident program for handling serial ports
  43. MBBCONFG.EXE      The configuration program for MBBIOS
  44.  
  45. ZAPDB.BAT         A batch file to move the current database files to
  46.                       another set of names and start anew with an empty
  47.                       database
  48.  
  49.                   These files describe commands for TNC's using WA8DED
  50.                         firmware:
  51. TNC1DED.DOC       Documentation for the WA8DED TNC-1 Firmware Version 1.3
  52. TNC2DED.DOC       Documentation for the WA8DED TNC-2 Firmware Version 2.5
  53. PK87DED.DOC       Documentation for the WA8DED AEA PK-87 Firmware
  54.  
  55.  
  56.  
  57.           Introduction and Overview for ARES/Data Version 1.4
  58.  
  59.  
  60.  
  61.                               ARES/Data
  62.  
  63.            A Packet-Radio Database for Emergency Communications
  64.  
  65.  
  66.  
  67. I.  INTRODUCTION
  68.  
  69. ARES/Data is basically a multiple-connect, multiple-port specialized bulletin
  70. board system with a conference bridge that is tailored to store and retrieve
  71. basic information about people, places, or things in an emergency or disaster.
  72. The program is a generalized form of the FINDER program (Family Information
  73. Database for Emergency Responders, by WN6I and N6KL, 1987).  Although ARES/Data
  74. allows access to the database via packet radio, the program can also operate
  75. stand-alone without any packet radio access.  The actual operating mode is
  76. chosen by the system operator when the ARES/Data program is started.
  77.  
  78. ARES/Data is a system designed for management of information during a
  79. widespread emergency that overloads normal communications channels.  The
  80. program is conceived to be flexible, so that it can be used without
  81. change for both small and large disasters to organize information about
  82. victims, evacuees, or even ham radio operators.  Examples of situations
  83. in which ARES/Data could be used are (i) registration of individuals at
  84. Red Cross shelters, (ii) patient/victim tracking in a multiple casualty
  85. incident, (iii) maintaining staffing information about hams assigned to
  86. an emergency, (iv) listings of road closures or damage reports, and so
  87. forth.  With alternate power sources and their own frequencies, Amateur
  88. Radio Operators can provide the ARES/Data service without tying up
  89. critical communications channels or relying on commercial power.
  90.  
  91. References:
  92. FINDER: Proc. of the Sixth ARRL Computer Networking Conf., p.134 (1987).
  93. ARES/Data 0.1: Proc. of the Seventh ARRL Comp. Net. Conf., p.141 (1988).
  94. ARES/Data 1.0: Proc. of the Eighth ARRL Comp. Net. Conf., p. 134 (1989).
  95. Public Service Column in QST, December, 1990, p. 75.
  96.  
  97. II. ARES/Data SYSTEM OVERVIEW
  98.  
  99. A.  Three Major Elements
  100.  
  101. There are three major elements to the ARES/Data system:
  102.  
  103.   o ARES/Data software and database (at one centrally located computer)
  104.   o Remote packet stations connected to the central node
  105.   o Conference Bridge
  106.  
  107. The central element of the ARES/Data system is the ARES/Data database
  108. program running on an IBM PC or compatible.  The ARES/Data program
  109. collects and collates current information about people (or other items)
  110. according to the needs of the incident.  The sysop at this computer can
  111. execute all database functions if necessary; it is not required that a
  112. TNC be connected to the computer.
  113.  
  114. If remote access is desired to the information in the database, this
  115. computer may be connected to a packet radio channel through up to four
  116. ports, each of which can be either a TNC with WA8DED firmware or a DRSI
  117. PC*PA packet radio adapter.  In this manner, other remote packet
  118. stations can connect to the ARES/Data machine and thus gain access to
  119. the stored information.  This information can be updated or queried by
  120. the sysop or any of the remote packet stations that are all
  121. simultaneously connected to the main database station.  The data access
  122. occurs by exchanging updates or queries in a simple, precise, and
  123. well-defined format.  A remote packet operator can both enter data into
  124. the system and execute searches for specific pieces of information.
  125.  
  126. During all of this, all of the connected stations and the sysop can
  127. communicate with each other by using a simple "tell" command.  This
  128. "conference bridge" actually implements a star-shaped network in which
  129. the central database station relays all of the message traffic.
  130.  
  131. III.  ACKNOWLEDGEMENTS
  132.  
  133. Since the ARES/Data concept is a generalization of the FINDER system,
  134. the deliberations of the FINDER committee in the Santa Clara Valley
  135. Section of the ARRL have contributed to the present form of ARES/Data.
  136. In addition, our thanks also go to all the ham radio operators in the
  137. Santa Clara Valley Section that have participated in the various alpha
  138. and beta tests of the FINDER and ARES/Data systems.  We also greatly
  139. appreciate the comments and suggestions we have received from hams all
  140. over the world who are using ARES/Data.
  141.  
  142. IV. Version 1.1 Differences
  143.  
  144. Everything you may already know about ARES/Data Version 1.0 still
  145. holds true for Version 1.1.   Version 1.1 fixes some minor bugs, and
  146. provides three new features:
  147.  
  148. 1. STATUS command:  Provides a brief system status, i.e., the current
  149.   LABELS settings, current WIDTHS settings (see below), and the current
  150.   database size.
  151.  
  152. 2. Origin Indicator:
  153.   (Thanks to Pierre Cornelis, ON7PC for this very good idea):
  154.   At the beginning of the MESSAGE field, there will now always be an
  155.   indication of which station last updated each record.  The station
  156.   callsign (or the word "SYSOP") will appear here, so that in case of
  157.   data entry errors, or other questions, everyone can know who made
  158.   which entry.  An example record:
  159.  
  160.   Date/Time LName   FName Call  Phone     Message
  161.   27/1234:  PALMER, DAVE, N6KL, 555-1299, <W6XYZ> DAVE CAN LOAN A RADIO
  162.  
  163.   The origin indicator is fully automatic.
  164.  
  165. 3. WIDTHS command.
  166.  
  167.   The Widths command allows you to more neatly format output data
  168.   on the screen.  It doesn't change the data in any way, but provides
  169.   a way for the column output to "look right".  If the value for any
  170.   field is shorter than the defined WIDTH for that field, then when
  171.   that record is displayed, spaces will be used to try and keep the
  172.   fields aligned on the display.  If a given value is longer than the
  173.   specified WIDTH, then all of the value is displayed, and the
  174.   following fields will likely not be aligned neatly.   (But for most
  175.   records they would be).   Set the WIDTHS anytime you wish; typically
  176.   when you change the meanings of the data base fields when you use the
  177.   LABELS command.  The syntax for the WIDTHS command is very similar to
  178.   that for the LABELS command:
  179.  
  180.   Find out the current WIDTHS:
  181.       widths
  182.  
  183.   Set the widths, so that Field1 has 10 characters, Field2 has 6,
  184.   Field3 has 8, and Field4 has 10:
  185.       widths=10,6,8,10
  186.  
  187.   If you set the widths this way, then output might now look like this:
  188.  
  189. Recno  DT/Time   LName      FName  Call     Phone      Message
  190.    1   27/1234:  PALMER,    DAVE,  N6KL,    555-1299,  <W6XYZ> DAVE ENROUTE
  191.    2   27/0001:  MAXIM,     HIRAM, W1AW,    555-1551,  <SYSOP>
  192.    3   27/0002:  VANDERMEULEN-SMITH, PETE, K6ABC, 555-0911, <W0XXX>
  193.  
  194.   So the last name in record number 3, above, does not fit inside a width of
  195.   10 characters, so the whole value is displayed, and the rest of record 3
  196.   is not well aligned.   Still, records 1, and 2, and other records might
  197.   be displayed more neatly.
  198.  
  199.   This WIDTHS command does call for a little bit higher data traffic, so
  200.   if this is not desired, reset the WIDTHS command to behave as before by
  201.   specifying a width of "*":     Use the command: "WIDTHS=*,*,*,*".
  202.   You cannot set the widths to a value greater than 20.
  203.  
  204. V. Version 1.2 Differences
  205.  
  206. Everything you may already know about ARES/Data Version 1.0 and 1.1 still holds
  207. true for Version 1.2.  Version 1.2 fixes a database bug that occurs for
  208. databases over 1000 records, fixes several smaller bugs that could produce
  209. run-time errors, and adds a DIR command which allows a user to list the files
  210. available for download from the public directory.
  211.  
  212. Some users who have very large databases (namely the hams working with the Los
  213. Angeles Marathon) expressed an interest in increasing the speed of the IMPORT
  214. command.  Version 1.2 has significantly improved IMPORT speeds due in part to
  215. the fact that the IMPORT command no longer copies each imported record to the
  216. JOURNAL file (ARESDATA.JRN), but instead places a notation like this:
  217.  
  218. ;Imported file: UPDATE5.IMP at 1900 on 27
  219.  
  220. Another way to speed up IMPORT at the expense of indexing is to reduce the
  221. number of index files.  Versions of the program that index fields 1-3, 1-2, and
  222. only 1 are included on the distribution diskette.  Do not mix usage of these
  223. versions of the program with databases and indices created with ARESDA12.EXE.
  224.  
  225. Also, regular BACKUPS may be disabled by setting the backup interval to 0
  226. in the ARESDATA.CFG file.
  227.  
  228. VI. Version 1.3 Differences
  229.  
  230. Everything you may already know about ARES/Data Versions 1.0-1.2 still holds
  231. true for Version 1.3.  Version 1.3 fixes a nasty bug that caused the database
  232. to start sending the same packet out again and again in an indefinite loop.
  233. This bug only appeared quasi-randomly when long records and messages were
  234. in use.  Thanks to John Leakley, WB9SMM, for bringing this one to our
  235. attention.
  236.  
  237. One new command has been added to the configuraton file ARESDATA.CFG:  logall,
  238. which causes every packet received from the remote stations to be echoed to
  239. the sysop screen.  New sysop commands "logallon" and "logalloff" turn this
  240. feature on and off during program execution.  Another new sysop command is
  241. "rawimport filename", which allows importing of database data in the standard
  242. input format:  Field1, Field2, Field3, Field4, Msg.
  243.  
  244. Various small changes were made in the documentation to make things clearer,
  245. as a result of feedback from interested hams.  One important item:  be sure
  246. the remotely connected stations set PACLEN to a value larger than the maximum
  247. input line length you expect to use.  This is because ARES/Data processes each
  248. incoming packet as a COMPLETE transaction.  If PACLEN is set too small for a
  249. remote station, his/her TNC may send several packets for one input line, which
  250. results in gibberish to the program.
  251.  
  252. VII. Version 1.4 Differences
  253.  
  254. Several users pointed out that with GET of long files or "l all"
  255. situations, the resulting TNC BUSY error would cause part of the
  256. downloaded data to be lost.  To remedy this, the program detects TNC
  257. BUSY conditions and halts polling until the condition clears.  This
  258. means that no data will be lost and sending of the long file will
  259. continue.  To other users, the system will appear to be busy for awhile
  260. until this condition clears.  Read the comments in SYSOP.DOC.
  261.  
  262. We also fragmented the user manual into a set of .HLP files for download
  263. from the public subdirectory.  This effectively makes more of the
  264. ARES/Data documentation available online.  Other small bugs were fixed,
  265. for example, in the results of the "dir" command.
  266.  
  267.  
  268. We hope you find ARES/Data to be helpful!   And we welcome your
  269. comments.
  270.  
  271. 73, Dave Palmer / N6KL @ K3MC
  272.     Weo Moerner / WN6I @ K3MC
  273.  
  274. August 4, 1989    (Version 1.0)
  275. December 1, 1989  (Version 1.1)
  276. March 3, 1990     (Version 1.2)
  277. October 7, 1990   (Version 1.3)
  278. December 5, 1990  (Version 1.4)
  279.