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