home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / clipper / 6utils.zip / 6UTILS.DOC next >
Text File  |  1993-06-18  |  9KB  |  265 lines
  1. This 6UTILS.ZIP file contains all of the utility programs that are included
  2. with the SuccessWare Index Driver (SIx Driver) RDD.  These programs are:
  3.  
  4.      CDXINFO.EXE
  5.      DBCRE8.EXE
  6.      DBFSTRU.EXE
  7.      SEEK.EXE
  8.  
  9. These programs can be freely copied and used by individuals royalty-free, with
  10. one exception.  They cannot be packaged and distributed, individually or as a
  11. group, as part of another software product without prior written consent from
  12. SuccessWare.
  13.  
  14. Questions and/or comments regarding these utilities should be directed to:
  15.  
  16.             SuccessWare 90, Inc.
  17.             27349 Jefferson Ave., Suite 101
  18.             Temecula, CA 92590
  19.  
  20.             Voice: (909) 699-9657  (8am-5pm PST)
  21.                    (800) 683-1657  (8am-5pm PST)
  22.             FAX  : (909) 695-5679  (24 Hours)
  23.             BBS  : (909) 694-6891  (24 Hours, N-8-1, 14.4 kbps)
  24.             CIS  : Loren Scott [70274,2677]
  25.  
  26. ------------------------------------------------------------------------------
  27.  
  28.   CDXINFO.EXE:
  29.  
  30.  
  31.   The CDXINFO utility will display the following information about a .CDX or
  32.   .IDX index file:
  33.  
  34.     ■  File Name
  35.     ■  File Type
  36.     ■  Tag Count
  37.  
  38.  
  39.   CDXINFO will also display the following information about each tag in a
  40.   .CDX index file, or for a single .IDX index file:
  41.  
  42.     ■  Tag Name
  43.     ■  Expression
  44.     ■  Conditional
  45.     ■  Unique Status
  46.     ■  RYO Status
  47.  
  48.  
  49.   The command-line syntax for using CDXINFO.EXE is as follows:
  50.  
  51.     CDXINFO <FileName>[.CDX]
  52.  
  53.     Where:  FileName = Name of the CDX/IDX file for which info is desired.
  54.  
  55.  
  56.   Example:
  57.  
  58.     To Display information about tags in TEST.CDX:
  59.  
  60.     C:\> CDXINFO test
  61.  
  62. ------------------------------------------------------------------------------
  63.  
  64.   DBCRE8.EXE:
  65.  
  66.  
  67.   Many of the sample programs included with the SIx Driver will require that
  68.   you have created a TEST.DBF file for the example to use.
  69.  
  70.   We have provided you with a small utility called DBCRE8.EXE which you can
  71.   use to quickly create a TEST.DBF file full of psuedo-random data.  You can
  72.   also optionally create an associated memo file in either the CA-Clipper
  73.   (.DBT) or FoxPro (.FPT) formats.
  74.  
  75.   The structure of the database files created by the DBCRE8 utility is as
  76.   follows:
  77.  
  78.           NAME        TYPE LEN DEC
  79.           ----------- ---- --- ---
  80.           FIRST       C     20
  81.           LAST        C     20
  82.           STREET      C     30
  83.           CITY        C     30
  84.           STATE       C      2
  85.           ZIP         C     10
  86.           HIREDATE    D      8
  87.           MARRIED     L      1
  88.           AGE         N      2   0
  89.         * SALARY      N      6   0
  90.        ** NOTES       C     70
  91.  
  92.  
  93.    (*) The SALARY field's DEC value becomes 2 if the /d switch is used.
  94.  
  95.   (**) If the /mD or /mF switch is used, this field will become a memo field
  96.        (Type "M") with a length of 10.
  97.  
  98.   The command-line syntax for using DBCRE8.EXE is as follows:
  99.  
  100.       DBCRE8 <nRecs> [options]
  101.  
  102.       Where:  <nRecs> = Number of records to add to the DBF file.
  103.  
  104.     Options:  /d  = Make SALARY field use <n> decimal places.  ( Ex: /d3 ).
  105.                     The specified value can be from 1-4.  The default is 2.
  106.  
  107.               /f  = Optional DBF file name to create.  Ex: /fBOGUS.  The
  108.                     default data file name is TEST.
  109.  
  110.               /mD = Include MEMO field using DBT format.
  111.  
  112.               /mF = Include MEMO field using FPT format.  An optional memo
  113.                     block size can also be set by immediately following the
  114.                     "F" with a colon followed by the desired block size.
  115.                     Ex: /mF:512 or /mF:16.  This value must be a multiple of
  116.                     16, between 16 and 1024.  The default value is 64.
  117.  
  118.        NOTE:  By default, no memo field is used.
  119.  
  120.  
  121.   Examples:
  122.  
  123.     Create TEST.DBF with 1000 records ...........:  DBCRE8 1000
  124.  
  125.     Create BOGUS.DBF with 500 records ...........:  DBCRE8 500 /fBOGUS
  126.  
  127.     Create TEST.DBF and TEST.DBT with 100 records:  DBCRE8 100 /mD
  128.  
  129.     Create FOO.DBF and FOO.FPT with 250 records .:  DBCRE8 250 /mF /fFOO
  130.  
  131.     Create FOO.DBF and FOO.FPT w/ 32-byte blocks :  DBCRE8 250 /mF:32 /fFOO
  132.  
  133.     Create TEST.DBF w/ 2 decimal places in SALARY:  DBCRE8 1000 /d
  134.  
  135.     Create DEMO.DBF w/ 3 decimal places in SALARY:  DBCRE8 1000 /d3
  136.  
  137. ------------------------------------------------------------------------------
  138.  
  139.   DBFSTRU.EXE:
  140.  
  141.  
  142.   The DBFSTRU utility will display the following information about a
  143.   database file:
  144.  
  145.     ■  Last Update
  146.     ■  Data Offset
  147.     ■  Record Size
  148.     ■  Num Records
  149.   * ■  Memo Type   (None, DBT, FPT, or Unknown)
  150.     ■  Structure
  151.  
  152.   (*) - If an FPT memo file is being used, the memo-block size in use
  153.         will also be displayed.
  154.  
  155.   DBFSTRU will also optionally create a CA-Clipper .PRG file which contains
  156.   the source code for creating the specified database file, including any
  157.   associated memo file of the proper type and memo-block size.
  158.  
  159.   The command-line syntax for using DBFSTRU.EXE is as follows:
  160.  
  161.     DBFSTRU <DBFname>[.DBF] [/p[<PrgName>]]
  162.  
  163.     Where:  /p = Create a .PRG file with Clipper source code to create
  164.                  the specified .DBF file.  ( Ex: /pTEST ).  If no name
  165.                  is specified, STRU.PRG will be created.
  166.  
  167.  
  168.   Examples:
  169.  
  170.     Display structure of TEST.DBF ...................:  DBFSTRU test
  171.  
  172.     Display structure of TEST.DBF and create STRU.PRG:  DBFSTRU test /p
  173.  
  174.     Display structure of TEST.DBF and create FOO.PRG :  DBFSTRU test /pFOO
  175.  
  176.  
  177. ------------------------------------------------------------------------------
  178.  
  179.   SEEK.EXE:
  180.  
  181.  
  182.   The SEEK utility is very handy in making sure that the file you think your
  183.   compiler and/or linker are using is the correct one.  SEEK will look for
  184.   the specified file in the specified (or assumed) DOS environment path.
  185.  
  186.   For example, if you think that your linker may be picking up an old version
  187.   of your BOGUS.LIB file somewhere in your LIB path, SEEK will tell you.  It
  188.   will search your LIB path for the first BOGUS.LIB file that your linker
  189.   would be using.
  190.  
  191.   If you're not sure which FOOBAR.CH file, CA-Clipper's preprocessor will be
  192.   using, SEEK can tell you that as well.
  193.  
  194.   For obvious file extensions, there is no need to specify the environment
  195.   path to search in, unless you want to force SEEK to look in a different
  196.   environment path instead.  For example, if the file extension is .h, .ch,
  197.   or .inc, SEEK will assume it's a header file and scan the INCLUDE path.
  198.  
  199.   SEEK will also optionally:
  200.  
  201.     ■  List ALL of the specified files that were found in the selected DOS
  202.        environment path.
  203.  
  204.     ■  Change to the drive and directory of the found file.  Actually, for
  205.        people who happen to nest their development files many levels deep,
  206.        even when you know for sure which file is being used, this option can
  207.        be used as a quick way to get to that directory.
  208.  
  209.     ■  Copy the found file into the current directory.
  210.  
  211.     ■  Display with a terse (single line, no title screen) output.  This is
  212.        mainly useful when using SEEK in a batch file to display large groups
  213.        of file paths.
  214.  
  215.   The command-line syntax for using SEEK.EXE is as follows:
  216.  
  217.     SEEK <cFileName> [<cEnvPath>] [options]
  218.  
  219.     Where:  <cFileName> = The file to search for.
  220.              <cEnvPath> = Optional environment path to search for the
  221.                           file in.  If no path is specified, obvious
  222.                           defaults are assumed.
  223.  
  224.     Options:         /a = Find all occurrences of specified file in path.
  225.                      /c = Copy the found file into the current directory.
  226.                           (Not available if /a switch is used.)
  227.                      /d = Change to the directory of the found file.
  228.                           (Not available if /a switch is used.)
  229.                      /t = Terse display (only show the SEEK result line)
  230.  
  231.    Examples:
  232.  
  233.     SEEK BOGUS.LIB LIB       // Searches LIB
  234.  
  235.     SEEK STDIO.H INCLUDE     // Searches INCLUDE
  236.  
  237.     SEEK TEST.EXE PATH       // Searches PATH
  238.  
  239.     SEEK BOGUS.LIB           // Assumes LIB
  240.  
  241.     SEEK BOGUS.LNK           // Assumes LIB
  242.  
  243.     SEEK STDIO.H             // Assumes INCLUDE
  244.  
  245.     SEEK STD.CH              // Assumes INCLUDE
  246.  
  247.     SEEK DOIT.BAT            // Assumes PATH
  248.  
  249.  
  250.     // Search for TEST.EXE, but in the PRG environment path instead
  251.     SEEK TEST.EXE PRG
  252.  
  253.     // Search for all MYUDC.CH files in INCLUDE path
  254.     SEEK MYUDC.CH /a
  255.  
  256.     // Search for TEST.OBJ and copy it to the current directory
  257.     SEEK TEST.OBJ /c
  258.  
  259.     // Search for DEMO.LIB, and change to the directory it's found in
  260.     SEEK DEMO.LIB /d
  261.  
  262.  
  263. ------------------------------------------------------------------------------
  264.  
  265.