home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / ares / aresda01.tec < prev    next >
Text File  |  1988-02-03  |  7KB  |  169 lines
  1. ARESDA01.TEC  ARES/Data System Operation Details Version 0.1
  2.  
  3. A.  OVERVIEW
  4.  
  5. The ARES/Data software was written in Turbo Pascal on an IBM PC by WN6I,
  6. W. E. Moerner, and N6KL, Dave Palmer.  It may be run in either of two modes:
  7. stand-alone with no TNC support and no remote access, or by changing the
  8. configuration file, the program will control a TNC that allows multiple
  9. remote connections.  If TNC support is chosen, the program requires a
  10. TNC with WA8DED firmware, because host mode is used for communication
  11. between the computer and the TNC.  No requirement is placed on the other
  12. TNC's connected to the ARES/Data database machine, except that they use
  13. AX.25 link-layer protocol.  The ARES/Data program utilizes the Turbo
  14. Database Toolbox for management and indexing of its B-plus structured
  15. tree.  Briefly, ARES/Data may be regarded as a specialized multiple
  16. connect BBS with a specific command set tailored to the handling of
  17. STATUS INPUT information and SEARCH REQUESTS.
  18.  
  19.  
  20. B.  GENERAL RULES FOR CURRENT INFORMATION INPUT / SEARCH REQUESTS
  21.  
  22. Enter the four fields and any message, in order, with separators between
  23. the fields.  The only valid separator is the comma.  Within a field,
  24. leading and trailing blanks are ignored, but imbedded blanks ARE
  25. significant.  If no value is desired for a particular field, just skip
  26. the field by adding an extra comma.  The database will fill that field
  27. with ten blank characters.
  28.  
  29. C.  SYNTAX FOR CURRENT INFORMATION INPUT:
  30.  
  31.                   field1,field2,field3,field4,message<cr>
  32.  
  33. (<cr> means carriage return)
  34.  
  35.  
  36.   1.  FIELD1 - FIELD4
  37.  
  38.       The four fields are very general.  Each can have up to 20
  39.       characters, with imbedded blanks.  The meaning of each field is
  40.       defined in real-time by the ARES officials, depending upon the
  41.       nature of the event.  The sysop can issue a "labels" command that
  42.       will give specific names to each of the four fields to help the
  43.       operators remember what they mean.
  44.  
  45.   2.  MESSAGE
  46.  
  47.       MESSAGE is a long, free-form field that can be up to 80 characters
  48.       long.  It could contain a message, a phone number, an address, or
  49.       other information deemed useful for the incident.
  50.  
  51.   3.  EXAMPLES OF DATA INPUT
  52.  
  53.             85553195,joe,12,sj34<cr>
  54.             Johnson,mary,93445,sj13, home 2333 Alsace Ln SJ 617-555-1212<cr>
  55.  
  56.       All of the input information is stored in the database
  57.       as a record of the status and location of a particular person at a
  58.       particular time and date.  The time and date are added
  59.       automatically by the ARES/Data program.  Further STATUS INPUT
  60.       packets for the same person will also be saved in the database.
  61.       The time and date will identify the most recent information.
  62.  
  63. D.  SYNTAX FOR SEARCH REQUESTS
  64.  
  65.             /1,value<cr>                      for field 1
  66.             /2,value<cr>                      for field 2
  67.             /3,value<cr>                      for field 3
  68.             /4,value<cr>                      for field 4
  69.  
  70.                     or
  71.  
  72.             ?1,value<cr>                      for field 1
  73.             ?2,value<cr>                      for field 2
  74.             ?3,value<cr>                      for field 3
  75.             ?4,value<cr>                      for field 4
  76.  
  77.       This type of packet instructs the database machine to look in the
  78.       database for ALL entries with the same value for field 1,2,3, or
  79.       4.  The initial character can be "/" or "?" - use whichever is
  80.       most convenient.  The two formats are handled identically.  A
  81.       status report listing all information for each match person is
  82.       sent back to the requesting packet station.  The first line gives
  83.       the search value and the field number.  At the end of the report,
  84.       the line
  85.  
  86.             "ARES/Data Search done at 1534, nn hits."
  87.  
  88.       is sent, which signifies no more information coming, and
  89.       that "nn" matches (or hits) were found in the database.
  90.  
  91.   1.  VALUE
  92.  
  93.       VALUE must exactly match what what originally typed in for the
  94.       selected field, with leading and trailing blanks removed, and
  95.       without regard for case.
  96.  
  97.   2.  EXAMPLES OF SEARCH REQUESTS
  98.  
  99.               /1,8555-3195<cr>
  100.               /2,w1aw<cr>
  101.               /3,mercyhosp<cr>
  102.               /4,85563<cr>
  103.  
  104.  
  105. E.  SYNTAX FOR SUMMARY REQUESTS
  106.  
  107.       $1<cr>                      produces a  list of all distinct
  108.                                   values for field1, with the number
  109.                                   of entries in the database for each
  110.  
  111.       $2<cr>                      similar, except summarize on field 2
  112.       $3<cr>                      similar, except summarize on field 3
  113.       $4<cr>                      similar, except summarize on field 4
  114.  
  115. F.  LISTING SPECIFIC ENTRIES (RECORDS) IN THE DATABASE
  116.  
  117.       l nnnnn<cr>                 lists record nnnnn
  118.  
  119. G.  DELETING SPECIFIC ENTRIES (RECORDS) FROM THE DATABASE
  120.  
  121.       d nnnnn<cr>                 deletes record nnnnn
  122.  
  123. This function is always enabled at the sysop keyboard.  Its use by remotely
  124. connected packet stations is controlled initially by the configuration file
  125. during program startup.  Thereafter, the sysop can disable or enable this
  126. function as necessary.   Be extremely careful in using this command!  Always
  127. list the record first before deleting to be sure you have the right one.
  128.  
  129. H.  CONFERENCE BRIDGE (roundtable - "users" and "tell" commands)
  130.  
  131. This feature allows any connected station to send messages to other
  132. connected stations or to the sysop.
  133.  
  134.   1.  Users command:
  135.  
  136.       The users command in the form "users<cr>" or "u<cr>" returns a list of
  137.       the callsigns of currently logged-on packet stations.  The response
  138.       is of the form:
  139.  
  140.       At WN6I-1:  N6KL  W6BB-3  AJ6T  WB6MRQ-7
  141.  
  142.   2.  Tell command:
  143.  
  144.       The Tell command allows connected packet stations to use ARES/Data as a
  145.       conference bridge, or roundtable.  The general format is:
  146.  
  147.       tell callsign message<cr>      or:
  148.       t callsign message<cr>
  149.  
  150.       For example:
  151.  
  152.       tell w6bb-3 We have lots of people here at SJ12<cr>
  153.  
  154.       The message "We have lots of people here at SJ12" is sent to the
  155.       connected station W6BB-3 prefaced by a time stamp and the call of the
  156.       station originating the tell command.  In this case, if the tell
  157.       command was sent by AJ6T, W6BB-3 sees:
  158.  
  159.       1230 AJ6T> We have lots of people here at SJ12
  160.  
  161.       It is not necessary to enter the entire callsign - just the suffix or
  162.       some other substring will do.  If several connected callsigns contain the
  163.       substring, each station will get the message.  The special callsign
  164.       "*" or "all" is used to send a message to all connected stations.  The
  165.       special callsign "sysop" sends the message to the sysop at the ARES/Data
  166.       database station.
  167.  
  168. END: ARESDA01.TEC
  169.