home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / pdbas412.zip / PDBASE.DOC < prev    next >
Text File  |  1990-09-30  |  18KB  |  470 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                         Product Database Door v4.12
  28.  
  29.                     (C) Copyright 1989, 1990  Ron Pierce
  30.  
  31.  
  32.  
  33.  
  34.  
  35.    A. Introduction
  36.  
  37.         PDBase uses indexed random access files for quick searching
  38.  
  39.         thru the two definable indexed fields.
  40.  
  41.         It is recommended to keep the 1st field you choose to be indexed
  42.  
  43.         quite small (20 or fewer characters) to ensure very fast cross-indexed
  44.  
  45.         searches are performed. Registered copies of PDBase now allow
  46.  
  47.         up to 10 databases to be defined. The fields are defined by the sysop.
  48.  
  49.         Each field may have unique field sizes and headings. The sysop may
  50.  
  51.         choose any two fields to be indexed. The 1st field selected is the
  52.  
  53.         MASTER field (i.e. manufacturer) and the second field may be used for
  54.  
  55.         Item names, descriptions, or whatever.
  56.  
  57.  
  58.                                    Note
  59.                                    ----
  60.  
  61.  The following information is provided as a convenience to those sysops
  62.  currently running a Pre v3.0 PDBase door. Beginning with version 3.0, PDBase
  63.  comes with a configuration program which automatically makes all indexed
  64.  files when the configuration definitions are completed and the Config file
  65.  (you specify the name) is written to disk. Before running "pdbcon.exe", the
  66.  configuration program, ensure the following steps are taken.
  67.  
  68.                               *** IMPORTANT ***
  69.  
  70.       The input data files (Text) MUST be edited with an editor which
  71.       add a CR/LF at the end of each line. Ensure you save these files
  72.       in as ASCII (NON-Document). Otherwise results will be not-too-smokey!
  73.  
  74.  
  75.                                 PDBase v4.1 Data Format
  76.                                 -----------------------
  77.  
  78.         There has been a modification to the index files for version 4.1.
  79.         You MUST re-index all existing files utilizing "PDBSM.EXE". Simply
  80.         run pdbsm as detailed below and select the option to "re-index"
  81.         a database. That will do it!
  82.  
  83.  
  84.                                 NEW Feature v4.1
  85. --------------------------------------------------------------------------
  86.    PDBase now supports multiple line descriptions in you data files. Just
  87.    ensure each additional line describing an item begins with at least one
  88.    space as the below samples include.
  89. --------------------------------------------------------------------------
  90. Example:
  91.  
  92. BOGAS PRODUCTIONS       Country Disks for Studio Session   MAC           $15.96
  93. BOGAS PRODUCTIONS       Heavy Metal Disks for Studio       MAC           $15.96 
  94.                         Session
  95.                         This is a test of the new multi-line stuff
  96.                         How does it work???
  97.  
  98. BOGAS PRODUCTIONS       Sound Effects Disks for Studio     MAC           $15.96  
  99.                         Session
  100. BOGAS PRODUCTIONS       String Quartet Disks for Studio    MAC           $15.96 
  101.                         Session
  102. BOGAS PRODUCTIONS       Studio Session                     MAC           $71.96 
  103. BOGAS PRODUCTIONS       Super Studio Session               MAC          $103.96
  104.  
  105.                                 Initial Setup
  106.                                 -------------
  107.  
  108. (1) Copy all your data input (text) files into the directory PDBCON.EXE is in.
  109.  
  110. (2) Ensure each data input file has a ".TXT" file name extension i.e. prod.txt
  111.  
  112. (3) Sort each data input file in ascending order, keying on the 1st, or
  113.     primary data field (normally the manufacturer field)
  114.  
  115. (4) Make a layout on paper exactly as you wish the field structure to be.
  116.     Each character of the input data file must be accounted for. Spaces
  117.     between fields MUST belong to one of the fields.
  118.  
  119. If you make a mistake while running PDBCON.EXE, you may press F1 and run
  120. "pdbcon.exe" again. Once more, write your field layout onto paper before
  121. running the pdbase configuration program. Take your time during data input to
  122. the program. It works very well, but is quite unforgiving!
  123.  
  124.  
  125.  
  126.                                  PDBSM.EXE
  127.                      (PDBase Sysop Maintenance Utility)
  128.  
  129.                                    WARNING
  130.                                    =======
  131.  
  132. Introduction
  133. ------------
  134.  
  135.         PDBSM is a utility designed to assist the sysop using a registered
  136.         copy of PDBase. It will perform re-indexing of existing databases;
  137.         allows you to shell to dos, edit and sort (using YOUR favourite text
  138.         editor and sorting utility) a database and have it indexed when you
  139.         return to pdbsm with the "EXIT" command; Allows you to add a databases;
  140.         Allows you to delete databases.
  141.  
  142.         ( I was working on an internal editor and sort utility, but have but )
  143.         ( that on the back burner since I cannot presently allow editing     )
  144.         ( files more than approximately 40k.                                 )
  145.  
  146. After you have created your initial database with "pdbcon.exe", use "pdbsm.exe"
  147. for all future database maintenance.
  148.  
  149.                                 Running PDBSM
  150.                                 -------------
  151.  
  152.                 PDBSM command line:  pdbsm [path/name]
  153.  
  154.                 Where [path/name] is complete path/name of
  155.                 PDBase.cfg file.
  156.  
  157.  
  158. 1. Backup your ".TXT" files before using "pdbsm.exe".
  159.    This is a powerful utility having the potential to destroy data. Use
  160.    it as directed below to MINIMIZE problems.
  161.  
  162. 2. Ensure you are logged into the directory where the ".txt" files reside
  163.  
  164. 3. When you run PDBSM.EXE include the path/name of the pdbase.cfg file
  165.    { if in the directory where the "pdbase.cfg" file is located, you }
  166.    { should only NEED the name of the "pdbase.cfg" file              }
  167.  
  168. 4. If at any time when in the main pdbsm.exe program (not the editor) you
  169.    feel a need to terminate the program "right now" just press the F1 key
  170.  
  171. 5. Note that the ".txt" file MUST reside in the same directory as the
  172.    indexed database files.
  173.  
  174. 6. Again - log onto the drive/directory the ".txt" files are located before
  175.    executing "pdbsm.exe".
  176.  
  177.  
  178.  
  179.                                 Setting Up Your Batch File
  180.                                 --------------------------
  181.  
  182.  
  183.         The batch file you use to run "PDBASE" should be similar to the
  184.  
  185.         following one. You may use a seperate directory for pdbase if you
  186.  
  187.         desire. Ensure you place a batch file in the bbs home directory
  188.  
  189.         for each node. The name can be the same for any node using seperate
  190.  
  191.         directories in a multitasking situation. It is not necessary to place
  192.  
  193.         an extension on the filename of your pdbase batch file. PCBoard copies
  194.  
  195.         the batch file to "door.bat".
  196.  
  197.          c:         ' These first two lines simply locate the pd.exe file
  198.          cd\qb
  199.          pd.exe pdbase.cfg      ; Command line to start pdbase (online)
  200.          Board       ' Returns control to the PCBoard
  201.  
  202.  
  203.  
  204.  
  205.  
  206.                             Configuring PDBASE.CFG
  207.                             ----------------------
  208.                                (The config file)
  209.  
  210.  
  211. Note: With version 3.1 of PDBase, the configuration file is made with the
  212.       PDBase configuration program  "PDBCON.EXE". For use on multiple node
  213.       BBS' use an ascii text editor or word processor and edit the path/name
  214.       to the .SYS file.
  215.  
  216.         The config file is made as follows for a TWO-FILE PDBase setup.
  217.  
  218. The Programmer's Inn    ;BBS name
  219. Rooster Pierce          ;Sysop's name
  220.  2                      ;Number of Databases to use
  221. prod                    ;Name of first .DAT file. No extension ALLOWED
  222.  2                      ;Number of The first field to index in 1st data file
  223. manufacturer            ;Title of First field to index in 1st data file
  224.  3                      ;Number of 2nd field to index in 1st data file
  225. Description             ;Title of 2nd field to index in 1st data file
  226. product                 ;Name of 2nd .DAT file to use. No extension ALLOWED
  227.  1                      ;Number of 1st field to index in 2nd data file
  228. manufacturer            ;Title of 1st field to index in 2nd data file
  229.  2                      ;Number of 2nd field to index in 2nd data file
  230. Description             ;Title of 2nd field to index in 2nd data file
  231.  4                      ;Number of fields in 1st data file
  232.  10 , 20 , 40 , 9       ;Number of characters in each field in 1st data file
  233.  5                      ;Number of fields in 2nd data file
  234.  14 , 32 , 7 , 7 , 19   ;Number of characters in each field in 2nd data file
  235. Proinf                  ;Name of your information file.
  236. c:\qb3\pcboard.sys      ;Path to pcboard.sys. MUST include "pcboard.sys"
  237. East Coast MIDI Software        ;Description of 1st data file.
  238. Products available in Florida   ;Description of 2nd data file.
  239. Item #      Manufacturer         Description                             Price
  240. Manufacturer      Description                  Theirs  Ours      More Info
  241. y
  242. c:\test
  243. 0000
  244. Y
  245. c:\test\cctrash
  246. c:\test\ccphone
  247. VMDA
  248. ----------------------------------------------
  249.  
  250.  
  251. The last NINE (9) lines in the sample .cfg file are:
  252.  
  253. (1) Heading displayed when items are searched in the 1st database
  254. (2) Heading displayed when items are searched in the 2nd database
  255. (3) "Y" if ordering script desired or "N"
  256. (4) Your pdbase registration #. Enter 4 zeroes if you have not registered
  257.     the door. Note that registration activates the script ordering function.
  258. (5) Path to pdbase data files, info files, menu (No filename on end)
  259. (6) A "Y" if you wish to have the names of the database files listed below
  260.     the (S) option at the menu. "N" if not.
  261. (7) The path/name for the Credit card number trash file. This may be shared
  262.     with CCDoor.
  263. (8)  The path/name for the Phone number trash file. This may be shared
  264.     with CCDoor.
  265. (9) First letter (caps) of the credit cards you will support.
  266.  
  267.  
  268.      NOTE: Remove the remarks from your actual PDBASE.CFG file!!
  269.  
  270.  
  271.                                Local Mode Operation
  272.                                --------------------
  273.  
  274.         To operate PDBASE in local mode, chdir to the directory you have the
  275.         PDBASE files located and enter "pd.exe pdbase.cfg    /L". That will do it.
  276.         You may also enter the door from PCBoard in local mode.
  277.  
  278.  
  279.  
  280.  
  281.                               Script Questionaire Instructions
  282.                               --------------------------------
  283.  
  284.       You MUST register PDBase in order for the script questionaire function
  285.       to be enabled.
  286.  
  287. The script file name MUST be "script.txt".
  288. Answers will be placed in "orders.txt".
  289. Both of these files will be in the directory you run pdbase from.
  290.  
  291. The script format is quite simple to use. The questionaire is built to
  292. suit your need within the following guidelines.
  293.  
  294.     a. Begin each question with a number reprsenting the number of lines in
  295.        the question.
  296.  
  297.     b. To insert a blank line in the question just place a ";" semicolon as
  298.        the leftmost (only) character.
  299.  
  300.     c. Begin a line with "*" if it is the question asking a credit card
  301.        number.
  302.  
  303.     d. Begin a line with "#" if it is the question asking a telephone
  304.        number.
  305.  
  306.     e. Begin a line with "@" if it is the question asking a Credit Card
  307.        expiration date.
  308.  
  309.     f. Begin a line with "&" if it is the question asking a Credit Card type
  310.  
  311. Note: The actual question (last line in each question) will be printed to the
  312.       script answer file. The answer to each question follows the question.
  313.  
  314.       The credit card and phone trash files may be any name/path you desire.
  315.       The format for each is as follows.
  316.  
  317.         a. Sample Phone trash file
  318.         111-111-1111
  319.         222-222-2222
  320.         800-555-1212
  321.  
  322.       Yep, just list the numbers in any desired format. Note that the
  323.       following number sequences are checked by the code automatically:
  324.       800, 900, -976-, -555-, 1-800, 1-900, 1212, 1111, 0000
  325.                       These are not allowed as valid Voice numbers.
  326.  
  327.         b. Sample Credit Card Trash File
  328.           555-555-555-555
  329.           444-444-444-444
  330.           666-666-666-666
  331.           333-333-333-333
  332.           4123-456-789-012
  333.  
  334.         Again, the numbers may be added in any format you wish. A perfect match
  335.         is required to invalidate a card number entry.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.                                         Registration
  343.                                         ------------
  344.  
  345. Note:   There are NO approved BETA test sites for any FeatherNet Door or any
  346.         program written by Ron Pierce. If you are presently using PDBase,
  347.         CCDoor, Fersale door, or Feathernet BBS, all written by me, you should
  348.         register the program after the 15 day trial period.  Failure to
  349.         register one of these programs means you will not have the most power
  350.         of the program available to you. I feel it is only fair to reward a
  351.         programmer for his hard work, time and dedication. PDBase will allow
  352.         only one file to be utilized until registered. It will only support
  353.         100 items of that file until registered. The ordering script will not
  354.         function until registered.
  355.  
  356.                                         Ron Pierce
  357.  
  358.         Upon receipt of your Registration, you will be mailed your registration
  359.         NUMBER, or you can obtain it from my bbs in a private letter.
  360.         This registration is valid ONLY on your bbs. You must use the same bbs
  361.         name as you indicate in your registration as PDBase keys on the name
  362.         when it determines if registration is valid. The registration DOES NOT
  363.         expire. Once registered, you will always be registered. When you get
  364.         the registration #, use a text editor of your choice and replace the
  365.         line near the bottom of your config file which reads "0000" (no quotes)
  366.         with your bbs registration number.
  367.  
  368.         Registration Enables the "O"rdering script questionaire function and
  369.         removes the "UNREGISTERED SHAREWARE!" notice when the door is entered.
  370.  
  371.         You should register this product if used for more than a 15 day "trial"
  372.         period. Registration will get you free upgrades and make available to
  373.         you any future door product or bbs ware from FeatherWare and Ron
  374.         Pierce.
  375.  
  376.         Registration fee:  $35.00 for a single bulletin board system.
  377.  
  378.     Clubs and user groups may charge a nominal fee not to exceed ($1) for
  379.     expenses and handling while distributing PDBASE.              --
  380.  
  381.         Your acceptance and use of this program implies that you accept FULL
  382.         responsibility for any damage or loss to yourself, your property, and
  383.         your dog - if you have one.
  384.         Every effort has been made to ensure no dangerous bugs are in the
  385.         program.
  386.  
  387.       I, Ron Pierce,  hereby disclaim all warranties relating to this software,
  388.       whether express or implied, including without limitation any implied
  389.       warranties of merchantability or fitness for a particular purpose. I
  390.       will not be liable for any special, incidental, consequential, indirect
  391.       or similar damages due to loss of data or any other reason, even if I
  392.       have been advised of the possibility of such damages.  In no event
  393.       shall MY liability for any damages ever exceed the price paid for the
  394.       license to use this software, regardless of the form of the claim.
  395.  
  396.       The person using the software bears ALL RISK as to the quality and
  397.       performance of the software.
  398.  
  399.                               Ron Pierce
  400.  
  401.  
  402.                       Product Database v4.1 Licensing Agreement
  403.  
  404.                          
  405.                                                         Date:________________
  406.  
  407.  
  408.      From: _________________________________
  409.      
  410.      To:   Ron Pierce, FeatherNet SoftWare
  411.  
  412.      Subj: Product Database Door Software License Application
  413.  
  414.  
  415.      I, _________________________________, 
  416.      
  417.      hereby apply for a license to operate the Product Database Door.
  418.  
  419.      I understand the registration fee allows me to free upgrades for
  420.  
  421.      one year (Except for any Shipping/Download Costs).
  422.  
  423.           Further, I will have continuous use of the FeatherNet SUPPORT BBS
  424.  
  425.      for problems, questions, and for just staying in touch.
  426.  
  427.     Enclosed is my Registration fee.
  428.  
  429.                               
  430.  
  431.  
  432.                            Signed: ___________________________________
  433.  
  434.  
  435. Enter your bbs name EXACTLY as you will place it in the configuration file.
  436.  
  437. _________________________________________________
  438.  
  439.  
  440.                Check appropriate Block
  441.  
  442.            [ ] $35.00  Initial Registration Fee and free BBS Support
  443.  
  444.  
  445.  
  446.         Mail registration & check or money order payable ONLY in US funds to:
  447.  
  448.                        Ronnie L. Pierce
  449.                        810-F Vernon Circle
  450.                        Mountain View, Ca. 94043
  451.  
  452.           Support BBS: 415-967-3484 (1200/2400)
  453.                        415-967-3508 (USR 14.4k)
  454.  
  455.  
  456.  
  457.     5: Support
  458.        -------
  459.         Upgrades and FREE support are available on The Programmer's Inn BBS,
  460.         @ 415-967-3484 / 3508. PCPursuitable thru CApal or CAsan
  461.  
  462. Mail Registration to:
  463.  
  464.         Ron Pierce
  465.         810-F Vernon Circle
  466.         Mountain View, Ca. 94043
  467.  
  468.         Support BBS: 415-967-3484 or  415-967-3508 (USR DS/HST 14.4k)
  469.  
  470.