home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128BBS / DTJ950307B.ARC / INFO.ARC / BASES.INFO < prev    next >
Encoding:
Text File  |  2019-04-13  |  6.2 KB  |  162 lines
  1. ╘HE ┬┴╙┼╙ ╞ILE IN ─ETAIL
  2. ------------------------
  3.  
  4.  
  5. ┴PPENDIX ┬ OF THE DOCUMENTATION DESCRIBES THE INFORMATION IN THE "BASES" FILE.
  6. ╘HIS TEXTFILE EXPLAINS HOW ALL THE INFORMATION IN THE "BASES" FILE IS USED.
  7.  
  8.  
  9. ╘HE "BASES" FILE, LOCATED ON THE "A" DRIVE, CONTAINS ESSENTIAL INFORMATION ABOUT
  10. ROOMS, MESSAGES, ╙╔╟S, AND EMAIL.  ╘HIS INFORMATION IS READ INTO MEMORY WHEN THE
  11. ┬┬╙ IS BOOTED, AND IS UPDATED WHENEVER A USER LOGS OFF.
  12.  
  13. ┴ DETAILED EXPLANATION OF EACH PART OF THE "BASES" FILE FOLLOWS:
  14.  
  15. ------------------------
  16.  
  17. 1.  ╘HE FIRST PART OF THE "BASES" FILE CONTAINS INFORMATION ABOUT THE CURRENT
  18.     ROOMS.  ┼ACH ROOM HAS A ROOM STATUS AND ROOM NAME ENTRY.  ╙INCE THE ─╘╩-┬┬╙
  19.     CAN SUPPORT 50 ROOMS, THIS INFORMATION IS REPEATED 50 TIMES, EVEN FOR
  20.     UNUSED ROOMS.
  21.  
  22.     ╘HE ROOM INFORMATION IS IN THIS FORMAT:
  23.  
  24.      <ROOM #1 STATUS>  <├╥>
  25.      "<ROOM #1 NAME>  <├╥>
  26.      <ROOM #2 STATUS>  <├╥>
  27.      "<ROOM #2 NAME>  <├╥>
  28.       ...ETC...
  29.  
  30.     ╘HE ROOM STATUS IS AN INTEGER THAT INDICATES WHICH ╙╔╟ THE ROOM BELONGS 
  31.     TO, THE ROOM'S WRITE STATUS, LOCKED STATUS, ANONYMOUS POST STATUS, AND 
  32.     LOGOFF MESSAGE ROOM STATUS:
  33.  
  34.     ┬ITS 0-3 OF THE ROOM STATUS INDICATE WHICH ╙╔╟ THE ROOM BELONGS TO.  ╔F 
  35.     NONE OF THESE BITS ARE SET, THE ROOM IS UNUSED.
  36.  
  37.     ┬IT 4 IS UNUSED.
  38.  
  39.     ┬IT 5 INDICATES IF THE ROOM IS A LOGOFF MESSAGE ROOM.  ╔F THIS BIT IS 
  40.     SET, THE ROOM IS A LOGOFF MESSAGE ROOM, AND BIT 7 IS ALSO SET.  ╧NLY ONE 
  41.     ROOM CAN HAVE THIS BIT SET.
  42.  
  43.     ┬IT 6 INDICATES THE WRITE STATUS OF THE ROOM.  ╙ETTING THE BIT MAKES THE 
  44.     ROOM READ-ONLY.
  45.  
  46.     ┬IT 7 INDICATES THE LOCK STATUS OF THE ROOM.  ╙ETTING THE BIT LOCKS THE 
  47.     ROOM.
  48.  
  49.     ┬IT 8 INDICATES THE ANONYMOUS USER STATUS OF THE ROOM.  ╙ETTING THE BIT 
  50.     MAKES THE ROOM ANONYMOUS.
  51.  
  52.     ╬OTE THAT EVEN THOUGH YOU CANNOT LOCK AN UNUSED ROOM ONLINE, IF YOU EDIT 
  53.     THE "BASES" FILE OFFLINE TO LOCK AN UNUSED ROOM, THAT ROOM WILL BE LOCKED 
  54.     INTO THE UNUSED STATUS AND WILL NOT BE AVAILABLE TO BE CREATED.
  55.  
  56.     ╘HE ROOM NAME FOLLOWS EACH ROOM STATUS AND CONSISTS OF A QUOTE MARK 
  57.     FOLLOWED BY THE ROOM NAME.  ╒NUSED ROOMS CONSIST OF A SINGLE QUOTE MARK.
  58.  
  59. 2.  ┴FTER ALL 50 ROOM STATUS AND ROOM NAME ENTRIES COMES THE NUMBER OF 
  60.     MESSAGES POSTED AND THE MESSAGE POINTERS.  ╘HESE ENTRIES ARE IN THE 
  61.     FOLLOWING FORMAT:
  62.  
  63.      <NUMBER OF POSTS>  <├╥>
  64.      <MESSAGE POINTERS>  <├╥>
  65.  
  66.     ╘HE NUMBER OF MESSAGES POSTED IS USED BY THE ─╘╩-┬┬╙ FIGURE OUT WHICH 
  67.     MESSAGE IS THE OLDEST AND WHICH IS THE NEWEST.  ╔F YOU CHANGE THIS NUMBER, 
  68.     THE MESSAGES WILL PROBABLY APPEAR OUT OF ORDER.
  69.  
  70.     ╘HE MESSAGE POINTERS CONSIST OF A STRING OF CHARACTERS.  ┼ACH CHARACTER 
  71.     POSITION REPRESENTS A MESSAGE.  ╘HERE IS ONE CHARACTER PER MESSAGE AND THE 
  72.     NUMBER OF CHARACTER POSITIONS DETERMINE THE NUMBER OF MESSAGES YOUR ┬┬╙ IS 
  73.     CONFIGURED TO HANDLE.
  74.  
  75.     ╘HE CHARACTER THAT IS PLACED IN EACH POSITION OF THE MESSAGE POINTER 
  76.     STRING REPRESENTS THE MESSAGE BASE THAT MESSAGE BELONGS TO.  ╘HE CHARACTER 
  77.     CODE USED IS THE ┴╙├╔╔ CODE OF THE ROOM NUMBER PLUS 64.  ╒NUSED POSITIONS 
  78.     (I.E. KILLED MESSAGES) CONTAIN A "@".
  79.  
  80.     ╞OR EXAMPLE, IF THE FIRST FEW CHARACTERS OF THE MESSAGE POINTER STRING 
  81.     ARE:
  82.  
  83.      DACB@BB....
  84.  
  85.     ╘HEN THE FIRST MESSAGE (D) BELONGS TO THE FOURTH ROOM, THE SECOND MESSAGE 
  86.     (A) BELONGS TO THE FIRST ROOM, ETC.  ╘HE FIFTH MESSAGE (@) WAS KILLED AND 
  87.     DOES NOT BELONG TO ANY ROOM.
  88.  
  89.     ╫HEN A MESSAGE IS SAVED, HOW DOES THE ┬┬╙ DETERMINE WHICH CHARACTER 
  90.     POSITION WILL BE USED?  ╘HIS IS WHERE THE NUMBER OF MESSAGES POSTED COMES 
  91.     IN.
  92.  
  93.     ╘HE ┬┬╙ DETERMINES THE POSITION BY TAKING THE REMAINDER OF THE NUMBER OF 
  94.     MESSAGES POSTED DIVIDED BY THE NUMBER OF MESSAGE POINTERS.  ╘HE VALUE 
  95.     COMPUTED IS THE POSITION OF THE OLDEST MESSAGE IN THE SYSTEM, WHICH WILL 
  96.     BE REPLACED BY THE NEW MESSAGE.
  97.  
  98.     ╘HE POSITION IN THE MESSAGE POINTER STRING IS THE INTERNAL MESSAGE NUMBER 
  99.     AND IS INCLUDED IN THE MESSAGE FILENAME AS THE 4-DIGIT NUMBER AFTER THE 
  100.     "M-".  ╘HIS NUMBER DOES NOT CORRESPOND TO THE MESSAGE NUMBERS AS SHOWN IN 
  101.     THE ON-LINE ┬┬╙.  ╘HE ┬┬╙ MUST CONVERT BETWEEN THE TWO NUMBERING SYSTEMS 
  102.     TO FIND EACH MESSAGE.  ╘HIS IS DONE BY COUNTING THE CHARACTERS THAT MATCH 
  103.     THE CURRENT ROOM NUMBER STARTING FROM THE POSITION OF THE OLDEST MESSAGE 
  104.     POINTER.  ═ACHINE LANGUAGE IS USED FOR SPEED.
  105.  
  106. 3.  ╘HE NEXT TWO ENTRIES ARE THE NUMBER OF CALLS AND THE NAME OF THE LAST 
  107.     CALLER IN THE FORMAT:
  108.  
  109.      <NUMBER OF CALLS>  <├╥>
  110.      <NAME OF LAST CALLER>  <├╥>
  111.  
  112. 4.  ┴FTER THE NAME OF THE LAST CALLER COMES THE ╙╔╟ INFORMATION.  ╘HIS 
  113.     CONSISTS OF A ╙╔╟ BULLETIN DATE AND ╙╔╟ NAME, REPEATED 15 TIMES:
  114.  
  115.      <╙╔╟ BULLETIN DATE>  <COMMA>
  116.      "<╙╔╟ NAME>  <├╥>
  117.       ...ETC...
  118.  
  119.     ╘HE ╙╔╟ BULLETIN DATE TELLS THE ┬┬╙ WHEN THE LAST [┼] [╙] X/1 COMMAND WAS 
  120.     ENTERED.
  121.  
  122.     ╔F THE ╙╔╟ BULLETIN DATE IS ALL ZEROS, THEN THERE IS NO ╙╔╟ BULLETIN FOR 
  123.     THE ╙╔╟.
  124.  
  125.     ╔F THE ╙╔╟ BULLETIN DATE IS ALL NINES, THEN THE ╙╔╟ BULLETIN WAS ACTIVATED 
  126.     WITH THE [┼] [╙] X/2 COMMAND.
  127.  
  128.     ╘HE ┬┬╙ COMPARES THE ╙╔╟ BULLETIN DATE WITH THE DATE A USER LAST LOGGED ON 
  129.     TO DETERMINE IF THE ╙╔╟ BULLETIN SHOULD BE DISPLAYED.
  130.  
  131.     ╘HE ╙╔╟ NAME CONSISTS OF A QUOTE MARK FOLLOWED BY THE NAME OF THE ╙╔╟.  
  132.     ╒NNAMED ╙╔╟S CONSIST OF A SINGLE QUOTE MARK.
  133.  
  134.     ╘HE LAST ╙╔╟ NAME IS FOLLOWED BY TWO CARRIAGE RETURNS.
  135.  
  136. 5.  ╘HE NUMBER OF EMAIL ENTRIES ARE NEXT.  ╘HIS CONSISTS OF AN INTEGER AND A 
  137.     CARRIAGE RETURN.
  138.  
  139. 6.  ╠ASTLY COMES THE EMAIL ENTRY INFORMATION:
  140.  
  141.      <EMAIL INDEX>  <COMMA>
  142.      <DATE SENT>  <├╥>
  143.       ...ETC...
  144.  
  145.     ╘HIS IS REPEATED AS MANY TIMES AS THERE ARE EMAIL FILES ALLOWED.
  146.  
  147.     ╘HE EMAIL INDEX IS THE ACCOUNT NUMBER OF THE USER TO RECIEVE THE EMAIL.  ┴
  148.     ZERO INDICATES AN UNUSED EMAIL ENTRY.
  149.  
  150.     ╔F THE EMAIL IS URGENT, 1024 IS ADDED TO THE EMAIL INDEX.
  151.  
  152.     ╔F THE EMAIL IS CERTIFIED, 3072 IS ADDED TO THE EMAIL INDEX.
  153.  
  154.     ╘HE DATE SENT IS USED BY THE ┬┬╙ TO DETERMINE WHICH PIECE OF EMAIL IS THE 
  155.     OLDEST, SO THAT EMAIL CAN BE DELETED IF NECESSARY WHEN SAVING A NEW PIECE. 
  156.     ╒NUSED ENTRIES HAVE A DATE OF ALL ZEROS.
  157.  
  158.     ┘OU CANNOT EDIT THE "BASES" FILE USING THE ┬┬╙ EDITOR BECAUSE THE ┬┬╙
  159.     KEEPS THE BASES FILE INFORMATION IN MEMORY AND WRITES THE MEMORY INFO
  160.     TO DISK WHEN YOU LOGOFF.  ╘HIS WILL OVERWRITE ANY CHANGES YOU MAY HAVE
  161.     MADE.
  162.