home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / A / DBASE2.ARC / DOZ.DOC < prev    next >
Text File  |  1992-12-05  |  10KB  |  213 lines
  1. .pn
  2.                            DOCUMENTATION FOR DOP.PRG
  3.                             DBASE II  &  DBASE III
  4.  
  5.      BY: Gary C. Arey
  6.          1030 Holland Dr.
  7.          Garland, Texas  75040
  8.  
  9.           DOP.PRG is a front end program written to make DBASE II and
  10.      DBASE III easy to use and effective for simple file management.  All
  11.      options are effected from the main menu of DOP and upon completion of
  12.      each option the user is taken back to the main menu.  Exit options are
  13.      provided for exiting to the DBASE dot prompt or to DOS.
  14.  
  15.           The program is written in two slightly different versions one for
  16.      DBASE II and the other for DBASE III.  The DBASE III version supports
  17.      additional features in DBASE III such as sorting without leaving DBASE,
  18.      obtaining a DIR of files on the default drive and some differences in
  19.      the way the Report Forms are handled.
  20.  
  21. Section 1:  THE MAIN MENU
  22.  
  23.           The DOP.PRG menu for DBASE II is shown below:
  24.  
  25.                           DBASE II OPERATIONS MENU
  26.  
  27.               The Current .DBF File Now in Use is :  ________
  28.  
  29.          1> List
  30.          2> Browse                           <S> Save Current Data File
  31.          3> Edit Record                      <I> Initialize Data File
  32.          4> Search Character Field           <E> Erase Data File
  33.          5> Search Numeric Field             <C> Create .DBF
  34.          6> Append (Add Records)             <N> Change Database
  35.          7> Mark to Delete                   <D> Delete (Pack)
  36.          8> Report to Screen                 <P> Report Print
  37.          9> View Structure                   <F> View Files
  38.          X> Exit to DBASE . Prompt           <Q> Quit to DOS
  39.  
  40.  
  41.           The DOP.PRG menu for DBASE III is as follows:
  42.  
  43.                          DBASE III OPERATIONS MENU
  44.  
  45.               The Current .DBF File Now in Use is :  ________
  46.  
  47.          1> List                             <C> Create .DBF
  48.          2> Browse                           <S> Sort File
  49.          3> Edit Record                      <E> Erase File
  50.          4> Search Character Field           <L> DIR Files on Drive
  51.          5> Search Numeric Field             <R> Create/Modify Report
  52.          6> Append (Add Records)             <N> Change Database
  53.          7> Mark to Delete                   <D> Delete (Pack)
  54.          8> Report to Screen                 <P> Report Print
  55.          9> View Structure                   <F> View Files
  56.          X> Exit to DBASE . Prompt           <Q> Quit to DOSè     To select your option from the main menu simply enter the letter or
  57.      number of your choice, do not enter a return, you will be taken to
  58.      your selection by pressing the letter or number key on the main menu.
  59.  
  60.           DOP is started from inside DBASE, at the dot prompt type: DO DOP
  61.      and you will be presented with a list of the database files on the
  62.      default drive and asked to select one for current use.  After you make
  63.      your selection, the main menu will appear.  When the DOP files are
  64.      extracted from the DOP Library, they are named as follows:
  65.  
  66.               DOP.DOC - Documentation for DOP
  67.  
  68.               DOP2.PRG - The DOP Program for DBASE II
  69.  
  70.               DOP3.PRG - The DOP Program for DBASE III
  71.  
  72.           You may rename either DOP2 or DOP3 to DOP.PRG for use with the
  73.      version of DBASE that you have.  Once that is done the program will
  74.      start with the command:  DO DOP
  75.  
  76. Section 2:  DOP COMMAND FUNCTIONS
  77.  
  78.           LIST:  This option is the DBASE List option; select the beginning
  79.      record number at the prompt and your records will list in order on the
  80.      screen until the last record in the file is listed.
  81.  
  82.           BROWSE:  Allows you to Browse the records from the beginning record
  83.      number which you select.  You may modify and edit the records as allowed
  84.      in DBASE and all the same DBASE commands for the BROWSE function apply.
  85.  
  86.           EDIT:  Places you in Edit mode at the beginning record number you
  87.      select and all DBASE Edit commands apply.
  88.  
  89.           APPEND:  Allows records to be added to the database in use.
  90.  
  91.           MARK TO DELETE:  Marks the selected record number for deletion.
  92.  
  93.           DELETE:  Deletes marked records from the database.
  94.  
  95.           VIEW STRUCTURE:  Places the field information and record information
  96.      for the current database in use on the screen.
  97.  
  98.           VIEW FILES:  Allows the names of all files of a particular type to
  99.      be viewed on the screen.  Just select the file type such as .PRG  .DBF
  100.      .FRM  or any other listed file type and DOP will display all files of
  101.      the selected type that are on the default drive to the screen.
  102.  
  103.           CREATE .DBF:  Places DBASE in the Create mode to allow a new
  104.      database to be created and then used.
  105.  
  106.           CHANGE DATABASE:  With this function you may change from the current
  107.      database to use another .DBF file and again all .DBF files on the default
  108.      drive are listed so the choice may be made.
  109.  
  110.           ERASE FILE:  Allows files to be erased from the default drive.è          EXIT TO DBASE . PROMPT:  Takes you out of DOP, closes all files
  111.      in use and clears all memory variables and presents you with the DBASE
  112.      dot prompt.
  113.  
  114.           QUIT TO DOS:  Takes you out of DOP, closes all files in use and
  115.      clears all memory variables and ends the DBASE run by quitting DBASE.
  116.  
  117.  
  118. SECTION 3:  SEARCHES
  119.  
  120.           Options 4 and 5 are the Search Options in DOP.  Option 4 conducts
  121.      a search of a CHARACTER field.  The search is a Character String Search
  122.      and will find any stated character string.  For example, suppose your
  123.      database used the field heading NAME and one of the records contained
  124.      the name  GARY AREY.  You would select option 4 and DOP would ask for
  125.      the field name you wished to search on after it showed you the field
  126.      names in the database.  You would enter NAME for the field name and
  127.      DOP would ask for the search characters.  You could enter  GARY,
  128.      GARY AREY, AREY, or even ARE and DOP would find the record or records
  129.      that match the search string.  As you can see, this search method is
  130.      very flexible.
  131.  
  132.           DOP also searches on more than one field at a time and will print
  133.      the results of a search if you answer the appropriate questions to
  134.      cause that to occur.
  135.  
  136.  
  137. SECTION 4:  REPORT FUNCTIONS
  138.  
  139.           These functions vary slightly in the DBASE II and DBASE III versions
  140.      of DOP.
  141.  
  142.           DBASE II:  Option 8  Report to Screen executes the standard Report
  143.      function of DBASE II and allows for the creation of reports if none exist.
  144.      Option P  Report Print will print the selected number of Report Form
  145.      reports that have already been created by Option 8.
  146.  
  147.           DBASE III:  Option R allows the Creation or Modifying of DBASE
  148.      Report Forms, Option 8 allows the Reports to be displayed on the screen
  149.      and Option P provides for the printing of Reports that have been created.
  150.  
  151.  
  152. Section 5:  DBASE II OPTIONS
  153.  
  154.           Option S  Save Current Data File - saves the database in use to a
  155.      name that you choose to give it thus allowing copies of the database
  156.      to be made with different names.
  157.  
  158.           Option I  Initialize Data File - executes the DBASE Modify Structure
  159.      command so that a file may be Initialized or emptied of all records.
  160.      WARNING!!  THIS COMMAND ERASES ALL RECORDS IN A FILE; the user is warned
  161.      of this and given an opportunity to abort the command and return to the
  162.      main menu.  Of course the structure of a file may be modified with this
  163.      command also but the file is nevertheless purged of all records.
  164. è          The above two options may be used in conjunction with each other to
  165.      save a file of records to another name and then initialize the original
  166.      file purging it of all records to allow for the entry of a different group
  167.      of records into the same file.  This would provide a method of keeping
  168.      data for different clients separate where the structure of the client
  169.      files is the same.
  170.  
  171.  
  172. Section 6:  DBASE III OPTIONS
  173.  
  174.           Option L  DIR Files on DRIVE - this option executes the DBASE III
  175.      DIR Command to list files on a drive as specified.
  176.  
  177.           Option S  SORT File - executes the DBASE III SORT option and sorts
  178.      the current database in use to a temporary, copies the temporary back
  179.      onto the original file, and erases the temporary leaving only the original
  180.      database but in the new sorted order.  The SORT option for DBASE II was
  181.      not placed in DOP2 since the DBASE II program DSORT under DBASE VER. 2.41
  182.      will not execute while DBASE is running.
  183.  
  184.  
  185. SECTION 7:  MODIFICATIONS OF DOP
  186.  
  187.           I believe that DOP provides some good and useful examples of DBASE
  188.      PROGRAM FILES and it is possible to modify DOP and add new features to
  189.      either version.  DOP can also be used on CPM machines running DBASE II.
  190.  
  191.           I do request that anyone modifying DOP rename it with a name that
  192.      shows it has been modified such as  DOPM____.PRG so that later versions
  193.      may be distinguished from my originals, and further that my name and
  194.      the heading not be removed from DOP under any circumstance.
  195.  
  196.  
  197. Section 8:  RIGHT TO USE OF DOP - PUBLIC DOMAIN
  198.  
  199.          I have written DOP to aid users of DBASE II and III by providing
  200.                       a useful example of DBASE programming.
  201.          I HEREBY PLACE DOP2.PRG AND DOP3.PRG IN THE PUBLIC DOMAIN AS TEXT
  202.             FILES WHICH MAY BE USED AND PASSED ON TO OTHERS AS NECESSARY.
  203.  
  204.         If you find DOP useful or helpful, any contributions you deem it
  205.            proper to make will be accepted for expenses incurred in
  206.                     production and distribution of DOP.
  207.  
  208.                            Gary C. Arey
  209.                            1030 Holland Dr.
  210.                            Garland, Tx.  75040
  211.  
  212.           September 2, 1984
  213.