home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C64-128BBS / DTJ940521.ARC / INFO.ARC / DATABASE.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  9.0 KB  |  243 lines
  1.     ─╘╩ ─ATABASE ═ODULE ├REATOR ╓1.0
  2.  
  3.        ─ ╧ ├ ╒ ═ ┼ ╬ ╘ ┴ ╘ ╔ ╧ ╬
  4.             (╨RELIMINARY)
  5.  
  6. ╘HIS PROGRAM WILL LET YOU DESIGN A DATABASE MODULE FOR USE WITH REVISIONS
  7. 910220 AND HIGHER OF THE ─╘╩-┬┬╙.
  8.  
  9. ╘HE PROGRAM ASKS YOU QUESTIONS ABOUT THE DATABASE YOU WANT TO CREATE, THEN IT
  10. WRITES THE DATABASE MODULE TO THE DISK.
  11.  
  12. ╘HESE DATABASE MODULES ARE EXECUTED WITH THE ┼[╪]EC COMMAND OF THE ┬┬╙.
  13.  
  14. ╘HE DATABASE MODULE STORES THE DATA THAT USERS ENTER INTO A RELATIVE FILE.
  15. ╘HIS FILE IS CREATED WHEN THE FIRST USER ENTERS INFORMATION INTO THE DATABASE.
  16.  
  17. ╘HE DATABASE MODULE DEFINES WHAT KIND OF DATA USERS CAN ENTER INTO THE DATABASE
  18. AND WHAT SORT OF OPERATIONS THE USER CAN PERFORM ON THE DATABASE (ADD, CHANGE,
  19. LIST, ETC).
  20.  
  21. ├URRENTLY, THERE IS NO WAY TO EDIT AN EXISTING DATABASE DESIGN.  ╔F YOU WANT TO
  22. CHANGE THE DATABASE FORMAT, YOU WILL NEED TO START OVER.
  23.  
  24. ╘O CREATE A DATABASE, LOAD AND RUN THE PROGRAM "DATABASE":
  25.  
  26.     ╠╧┴─ "─┴╘┴┬┴╙┼",8   [RETURN]
  27.  
  28.     ╥╒╬   [RETURN]
  29.  
  30. ╘HE PROGRAM WILL ASK YOU A SERIES OF QUESTIONS ABOUT THE DATABASE YOU WANT TO
  31. CREATE.  ┼ACH QUESTION IS DESCRIBED BELOW.
  32.  
  33. ╔NSTRUCTIONS ARE DISPLAYED IN WHITE.  ┼ACH ENTRY YOU MAKE IS IN BLUE.  ═OST
  34. ENTRIES REQUIRE THAT YOU PRESS ╥┼╘╒╥╬ TO ENTER THEM.
  35.  
  36. ╙OME ENTRIES ALLOW YOU TO INSERT ╥┼╘╒╥╬ CODES WITHIN WHAT YOU TYPE.  ╘O DO
  37. THIS, PRESS ╙╚╔╞╘-╥┼╘╒╥╬.
  38.  
  39. ┼ACH SCREEN IS GIVEN A PAGE NUMBER.  ╘O GO BACK TO A PREVIOUS PAGE, PRESS
  40. ╥╒╬/╙╘╧╨.
  41.  
  42.  
  43. ╨AGE 1 - ─ATABASE ╞ILENAME
  44.  
  45.    ┼NTER THE FILENAME OF THE RELATIVE FILE THAT IS TO CONTAIN THE DATA THAT THE
  46. USERS TYPE IN.  ╘HIS IS NOT THE NAME OF THE DATABASE MODULE; THE MODULE
  47. FILENAME WILL BE REQUESTED JUST BEFORE THE MODULE IS CREATED.
  48.  
  49.  
  50. ╨AGE 2 - ─ATABASE ─RIVE ╠ETTER
  51.  
  52.    ┼NTER THE DRIVE LETTER (A-Z) OF THE DRIVE THAT THE DATABASE DATA FILE WILL
  53. BE WRITTEN TO.
  54.  
  55.  
  56. ╨AGE 3 - ╘ITLE AND ═ENU ╔NSTRUCTIONS
  57.  
  58.    ┼NTER THE TEXT THAT YOU WANT DISPLAYED AT THE DATABASE'S MAIN MENU.  ╘HIS
  59. SHOULD INCLUDE THE NAME OF THE DATABASE AND THE MENU OPTIONS AVAILABLE TO THE
  60. USER.
  61.  
  62.    ╞OR EXAMPLE, SUPPOSE YOU ARE WRITTING A ┬┬╙ LIST DATABASE.  ╔F YOU WANT THE
  63. TITLE AND MENU TO LOOK LIKE THIS:
  64.  
  65.       ┬┬╙ ─ATABASE
  66.  
  67.       ┼NTER YOUR SELECTION:
  68.  
  69.       [╒]PDATE / [╠]IST / [┼]XIT
  70.       :
  71.  
  72.    ╘HEN ENTER THE FOLLOWING DATA:
  73.  
  74.       ┬┬╙ ─ATABASE<├╥><├╥>┼NTER YOUR SELECTION:<├╥><├╥>[╒]PDATE / [╠]IST / [┼]
  75.       XIT<├╥>:
  76.  
  77.    WHERE "<├╥>" MEANS ╙╚╔╞╘-╥┼╘╒╥╬.
  78.  
  79.    ┘OU MAY TYPE IN UP TO 255 CHARACTERS.
  80.  
  81.    ╘HE MENU OPTIONS YOU MAY INCLUDE IN YOUR MENU ARE:
  82.  
  83.    [╒]PDATE    - ┴DDS & ├HANGES RECORDS
  84.    [─]ELETE    - ─ELETES RECORDS
  85.    [╠]IST      - ┴ NON-STOP LISTING OF RECORDS
  86.    [╙]EARCH    - ┴ LISTING OF RECORDS
  87.    [┼]XIT      - ┼XIT THE DATABASE MODULE
  88.  
  89.  
  90. ╨AGE 4 - ╧PTIONS ┴VAILABLE
  91.  
  92.    ╘HE MENU YOU JUST TYPED IN WAS WHAT IS DISPLAYED TO THE USER.  ╘HE DATABASE
  93. CAN'T USE IT TO DETERMINE WHICH OPTIONS THE USER CAN SELECT FROM.  ╔T IS ON
  94. THIS NEXT PAGE THAT YOU TELL THE PROGRAM WHICH MENU OPTIONS THE USER CAN
  95. ACTUALLY SELECT.
  96.  
  97.    ┘OU CAN ENABLE OR DISABLE THE [╒]PDATE, [─]ELETE, [╠]IST, OR [╙]EARCH
  98. COMMANDS.  (╘HE [┼]XIT COMMAND IS ALWAYS ACTIVE.)
  99.  
  100.    ╨RESS ┘ FOR EACH COMMAND YOU WANT AVAILABLE, OR ╬ IF YOU DON'T WANT THAT
  101. COMMAND AVAILABLE.
  102.  
  103.    ┴FTER YOU'VE MADE YOUR CHOICE, THE PROGRAM WILL ASK YOU IF YOU WANT USERS TO
  104. BE ABLE TO MODIFY OR DELETE ANY RECORD THEY CHOOSE.  ╔F YOU ANSWER ╬, THEN ONLY
  105. THE SYSOP OR THE ORIGINAL CREATOR OF A RECORD CAN MODIFY OR DELETE A RECORD.
  106. (╔F YOU ANSWERED ╬ TO THE [╒]PDATE AND/OR [─]ELETE OPTION BEFORE, THEN THIS
  107. WON'T APPLY.)
  108.  
  109.  
  110. ╨AGE 5 - ╒PDATE ╔NSTRUCTIONS
  111.  
  112.    ╘HIS IS THE TEXT THAT WILL BE DISPLAYED WHEN THE USER SELECTS THE [╒]PDATE
  113. COMMAND.  ╨RESS ╥┼╘╒╥╬ TO USE THE DEFAULT TEXT OR ENTER YOUR OWN.
  114.  
  115.  
  116. ╨AGE 6 - ─ELETE ╔NSTRUCTIONS
  117.  
  118.    ╘HIS IS THE TEXT THAT WILL BE DISPLAYED WHEN THE USER SELECTS THE [─]ELETE
  119. COMMAND.  ╨RESS ╥┼╘╒╥╬ TO USE THE DEFAULT TEXT OR ENTER YOUR OWN.
  120.  
  121.    ╫HEN THE USER SELECTS THIS COMMAND, THE DATABASE MODULE IS WAITING FOR THE
  122. USER TO TYPE IN A SEARCH STRING.  ╘HE ┬┬╙ WILL THEN DISPLAY ALL RECORDS THAT
  123. THE USER IS ALLOWED TO DELETE AND THAT CONTAIN THE SEARCH STRING.
  124.  
  125.    ╘HE USER WILL THEN BE ABLE TO CHOOSE IF HE WANTS TO DELETE EACH RECORD AS IT
  126. IS DISPLAYED.
  127.  
  128.  
  129. ╨AGE 7 - ╠IST ╔NSTRUCTIONS
  130.  
  131.    ╘HIS IS THE TEXT THAT WILL BE DISPLAYED WHEN THE USER SELECTS THE [╠]IST
  132. COMMAND.  ╨RESS ╥┼╘╒╥╬ TO USE THE DEFAULT TEXT OR ENTER YOUR OWN.
  133.  
  134.    ╫HEN THE USER SELECTS THIS COMMAND, THE DATABASE MODULE IS WAITING FOR THE
  135. USER TO TYPE IN A SEARCH STRING.  ╘HE ┬┬╙ WILL THEN DISPLAY ALL RECORDS THAT
  136. CONTAIN THAT SEARCH STRING IN ONE NON-STOP LIST.  (╘HE USER MAY [┴]BORT OR
  137. [╨]AUSE THE LIST.)
  138.  
  139.  
  140. ╨AGE 8 - ╙EARCH ╔NSTRUCTIONS
  141.  
  142.    ╘HIS IS THE TEXT THAT WILL BE DISPLAYED WHEN THE USER SELECTS THE [╙]EARCH
  143. COMMAND.  ╨RESS ╥┼╘╒╥╬ TO USE THE DEFAULT TEXT OR ENTER YOUR OWN.
  144.  
  145.    ╫HEN THE USER SELECTS THIS COMMAND, THE DATABASE MODULE IS WAITING FOR THE
  146. USER TO TYPE IN A SEARCH STRING.  ╘HE ┬┬╙ WILL THEN DISPLAY ALL RECORDS THAT
  147. CONTAIN THAT SEARCH STRING ONE AT A TIME.  (╘HE USER MAY SELECT THE [╬]EXT
  148. RECORD OR [┴]BORT THE SEARCH AFTER EACH RECORD IS DISPLAYED.)
  149.  
  150.  
  151. ╬EXT, THE PROGRAM WILL ASK YOU FOR INFORMATION ABOUT THE DATABASE ITSELF.  ╘HIS
  152. IS WHERE YOU TELL THE PROGRAM WHAT KIND OF INFORMATION GOES INTO EACH RECORD OF
  153. THE DATABASE.
  154.  
  155. ╧N EACH SCREEN, THE PROGRAM WILL ASK FOR INFORMATION ABOUT ONE FIELD OF A
  156. RECORD.  (┴ FIELD IS ONE ENTRY THAT THE USER CAN TYPE IN.  ┼ACH RECORD CAN HAVE
  157. ONE OR MORE FIELDS.)
  158.  
  159. ╘HE FIRST FIELD IS CALLED THE "KEY" FIELD.  ┼ACH RECORD IN THE DATABASE HAS A
  160. UNIQUE KEY FIELD.  ╬O TWO RECORDS IN THE DATABASE CAN HAVE THE SAME INFORMATION
  161. IN THE KEY FIELD.
  162.  
  163. ╞OR EXAMPLE, IN A ┬┬╙ DATABASE MODULE, THE KEY FIELD WOULD BE THE PHONE NUMBER
  164. BECAUSE EACH PHONE NUMBER IS UNIQUE TO EACH ┬┬╙.  (╧THER FIELDS MAY HAVE THE
  165. SAME DATA IN MORE THAN ONE RECORD.  ╞OR EXAMPLE, MORE THAN ONE ┬┬╙ CAN HAVE THE
  166. SAME BAUDRATE.)
  167.  
  168. ╘HE FIRST QUESTION FOR EACH FIELD IS THE FIELD ╨╥╧═╨╘.  ╘HIS IS WHAT IS
  169. DISPLAYED JUST BEFORE THE USER TYPES IN THE DATA FOR THE FIELD.  ╔F YOU WANT
  170. THE USER TO TYPE IN THE PHONE NUMBER OF A ┬┬╙, YOU MIGHT USE:
  171.  
  172.      ┼NTER ╨HONE ╬UMBER
  173.  
  174. ─O NOT TYPE A PLUS OR ASTRISK SIGN IN THE PROMPT.  ╘HEY ARE RESERVED AND HAVE SPECIAL MEANING TO THE DATABASE MODULE.
  175.  
  176. ╬EXT, YOU MUST TELL THE PROGRAM WHAT KIND OF DATA THE USER CAN TYPE IN.  ╘HIS
  177. IS IN THE FORM OF A "FORMAT STRING".  ╫HAT YOU TYPE HERE ARE SPECIAL CHARACTERS
  178. THAT WILL TELL THE MODULE WHAT SORT OF THINGS THE USER CAN TYPE.  ╘HESE SPECIAL
  179. CHARACTERS ARE:
  180.  
  181.    $   - ┴NY CHARACTER
  182.    N   - ┴NY CHARACTER EXCEPT A SPACE
  183.    A   - ┴NY LETTER CHARACTER
  184.    0-9 - ┴NY NUMBER CHARACTER NOT EXCEEDING THIS DIGIT
  185.    ?   - ┴ "┘" OR "╬" ONLY.
  186.  
  187. ┼ACH OF THESE CHARACTERS YOU TYPE IN REPRESENTS THE TYPE OF CHARACTER THE USER
  188. CAN TYPE IN AT THAT POSITION.  ┴NY OTHER FORMAT CHARACTER OTHER THAN THESE WILL
  189. BE ENTERED AUTOMATICALLY JUST AS IF THE USER TYPED THEM IN.
  190.  
  191. ╞OR EXAMPLE, IF YOU WANT THE USER TO TYPE IN THE PHONE NUMBER OF A ┬┬╙, YOU CAN
  192. USE:
  193.  
  194.      (999) 999-9999
  195.  
  196. ╔N THIS CASE, THE PARENTHESIS, SPACE, AND DASH WILL BE DISPLAYED AUTOMATICALLY
  197. BECAUSE THEY ARE NOT A SPECIAL FORMATTING CHARACTER.  ╘HE USER CAN ONLY TYPE
  198. DIGITS WHERE THE 9'S ARE.  ╘HE USER CAN TYPE IN ANY DIGIT FROM 0 TO 9 BECAUSE
  199. ALL DIGITS ARE LESS THAN OR EQUAL TO THE 9'S IN THE FORMAT STRING.
  200.  
  201. ╘HE NUMBER OF CHARACTERS YOU ENTER IN THE FORMAT STRING WILL BE THE MAXIMUM
  202. NUMBER OF CHARACTERS THE USER CAN TYPE IN.
  203.  
  204. ╔F YOU WANT THE USER TO BE ABLE TO ENTER ANY DATA, BUT YOU DON'T WANT THE FIRST
  205. CHARACTER TO BE A SPACE, THEN TYPE:
  206.  
  207.      N$$$$$$$$$$$$
  208.  
  209. ╬EXT, TELL THE PROGRAM IF YOU WANT THE FIELD TO BE A MANDATORY ENTRY FIELD.  ╔F
  210. YOU ANSWER ┘, THEN USERS MUST ENTER SOMETHING IN THIS FIELD WHEN THEY COME TO
  211. IT.  ╘HE FIRST FIELD IS AUTOMATICALLY MANDATORY.
  212.  
  213. ╬EXT, TELL THE PROGRAM IF YOU WANT THIS FIELD TO BE A PRIVATE SYSOP-EYES-ONLY
  214. FIELD.  ╔F YOU ANSWER ┘, THEN THE DATA FOR THIS FIELD WILL ONLY BE DISPLAYED
  215. WHEN A SYSOP LISTS THE RECORD.
  216.  
  217. ╬EXT, GIVE THE FIELD A SHORT NAME.  ╫HAT YOU ENTER HERE WILL BE DISPLAYED AT
  218. THE TOP OF LISTINGS.  ╙INCE THE FIELD NAME MUST FIT OVER THE DATA, YOU ARE
  219. LIMITTED TO A FIELD NAME NO LONGER THAN THE FIELD FORMAT STRING.
  220.  
  221. ┴FTER YOU ENTER THIS FIELD NAME, THE PROGRAM WILL GO TO ANOTHER PAGE SO YOU CAN
  222. ENTER INFORMATION FOR ANOTHER FIELD.  ╔F YOU'VE ENTERED ALL THE INFORMATION YOU
  223. WANT, JUST PRESS ╥┼╘╒╥╬ BY ITSELF AT THE FIELD PROMPT ENTRY.
  224.  
  225. ┴FTER ALL FIELDS HAVE BEEN DEFINED, YOU WILL BE ASKED FOR THE NAME OF THE
  226. DATABASE MODULE FILE.  ╘HIS SHOULD CONSISTS OF A LOWERCASE ╙╔╟ LETTER, A
  227. PERCENT SIGN, AND THE NAME OF THE MODULE IN UPPERCASE.  (┴T THIS POINT, YOU
  228. CANNOT USE ╥╒╬/╙╘╧╨ TO GO BACK TO A PREVIOUS PAGE!)  ╘HE ┬┬╙ DATABASE EXAMPLE
  229. COULD BE CALLED:
  230.  
  231.    A%┬┬╙
  232.  
  233. ╬EXT, TYPE IN THE DRIVE NUMBER (8-31) THAT THE MODULE FILE IS TO BE LOCATED ON.
  234. ╘HIS SHOULD BE THE DRIVE THAT CONTAINS THE ╙╔╟FILES.
  235.  
  236. ╞INALLY, IF THE ╙╔╟FILES ARE LOCATED IN A PARTITION ON THAT DRIVE, ENTER THE
  237. COMMAND USED TO CHANGE TO THAT PARTITION SO THAT THE PROGRAM CAN CREATE THE
  238. DATABASE MODULE IN THE CORRECT PARTITION.  ╧THERWISE PRESS ╥┼╘╒╥╬ BY ITSELF.
  239.  
  240. ╧NCE THE DATABASE DATA FILE HAS BEEN CREATED, IF YOU WANT TO CHANGE THE LENGTH
  241. OF ANY FIELD OR ADD FIELDS TO THE DATABASE, YOU MUST ERASE THE DATABASE DATA
  242. FILE AND START OVER.  ╙O, PLAN YOUR DATABASE FIRST BEFORE YOU START!
  243.