home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / SYSTEM / DABUTIL2.ZIP / DABUTIL2.DC1 < prev    next >
Encoding:
Text File  |  1991-01-15  |  52.3 KB  |  1,801 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                   DABUTIL Version 2.00
  23.  
  24.                                        User's Manual
  25.  
  26.                             Copyright 1988-1991 by Don Branson
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.      Nomenclature
  37.  
  38.  
  39.  
  40.        Any text surrounded by square brackets  []  is optional. If you
  41.        don't enter it, some default action will be taken by the program.
  42.        For example, if you run the LD (List Directory) program by typing:
  43.  
  44.           LD A:
  45.  
  46.        then the list directory program will list the directories on the
  47.        'A' drive, no matter what the current drive is. On the other hand,
  48.        if you run the LD program by typing:
  49.  
  50.           LD
  51.  
  52.        then the list directory program will list the directories on the
  53.        current drive. The default action in this case is to use the
  54.        current drive.
  55.  
  56.        The help option (/h) can be used with all programs in DABUTIL,
  57.        to get a short description of the program and all available options.
  58.        For example:
  59.  
  60.  
  61.           CATALOG /h
  62.           LD /h
  63.           FILEMAN /h
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.      Acknowledgements
  73.  
  74.      I would like to thank my wife, Dot, and my sons, Peter and Taylor for
  75.      the sacrificies they made while I was working on Dabutil.
  76.  
  77.  
  78.      Copyright Notice
  79.  
  80.        This User's Manual and all programs associated with DABUTIL are copyright
  81.        1991 by Don Branson and are protected by the copyright laws of the United
  82.        States of America, and by international treaty provisions. The software
  83.        is shareware and may therefore be copied for others to use, as long as
  84.        the software and associated documentation are not modified in any way.
  85.        If you make any of this package a part of your regular working environment,
  86.        you should print out the registration form found in the file DABUTIL2.REG
  87.        and fill it out. DABUTIL2.REG can be printed using either of these two
  88.        DOS commands:
  89.  
  90.            PRINT DABUTIL2.REG
  91.            or
  92.            TYPE DABUTIL2.REG >PRN
  93.  
  94.        If you don't have a printer, that's O.K., any reasonable facsimile will be fine.
  95.  
  96.  
  97.  
  98.      Disclaimer
  99.  
  100.        While every precaution has been taken in the preparation of this package, the
  101.        author assumes no responsibility for errors or omissions. No liability is
  102.        assumed for direct, indirect, or consequential damages resulting from the use
  103.        of this software. It is the sole responsibility of the user of this package to
  104.        determine compatibility with the user's system.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                                    Table of Contents
  114.  
  115.  
  116.  
  117.  
  118.        Installing Dabutil2..................1
  119.  
  120.        When something goes wrong............2
  121.  
  122.        CATALOG..............................3
  123.  
  124.        DI...................................5
  125.  
  126.        DIRM................................10
  127.  
  128.        DOSMENU.............................12
  129.  
  130.        DOW.................................16
  131.  
  132.        DTIME...............................17
  133.  
  134.        ENC.................................18
  135.  
  136.        EVENTMAN............................19
  137.  
  138.        FF..................................25
  139.  
  140.        FILEMAN.............................28
  141.  
  142.        LD..................................37
  143.  
  144.        PROCESS.............................40
  145.  
  146.        SBE.................................41
  147.  
  148.        SD..................................48
  149.  
  150.        SETPRT..............................53
  151.  
  152.        Appendix A, Entry Windows...........55
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.      Basic DABUTIL2 Installation
  162.  
  163.  
  164.        1) Insert the disk with DABUTIL on it into either drive A or B.
  165.  
  166.        2) "LOG IN" to that drive with either:
  167.                   A:    or
  168.                   B:
  169.            and press RETURN.
  170.  
  171.        3) Enter the command DABINST and press return.
  172.  
  173.        4) Follow the instructions given to install the DABUTIL package. DABINST
  174.           will install DABUTIL in a directory named DABUTIL, which it will
  175.           create if necessary. It will also add the new directory to your path
  176.           command.
  177.  
  178.        5) Re-boot your computer to activate the new PATH command in AUTOEXEC.BAT
  179.  
  180.        6) Enter the command DOSMENU to see demonstrations of each program.
  181.  
  182.  
  183.        CAUTION:
  184.           While you can change the directory given, it is recommended that you
  185.           use DABUTIL, since any existing directory may have files with the same
  186.           name as a DABUTIL file, and they might be lost when the install is
  187.           done. You have the option of keeping the old files or overwriting them.
  188.  
  189.  
  190.      See Appendix A, "Entry Windows" for information on entering the name
  191.        of the directory.
  192.  
  193.  
  194.      Installation Technical Information
  195.  
  196.  
  197.        The DABUTIL files are stored in a file named DABUTIL2.EXE.  This is a self-
  198.        extracting archive, which is used by DABINST.
  199.  
  200.        DABINST will attempt to install DABUTIL on the same drive as the first
  201.        directory in your PATH command. The default directory for installation
  202.        is DABUTIL, but you can select another directory. If the directory is NOT
  203.        already on your path, DABINST will look on the same drive to find
  204.        AUTOEXEC.BAT, and add the directory to any PATH command found there. If
  205.        the directory is already on the PATH command in AUTOEXEC.BAT, then it will
  206.        not be added.
  207.  
  208.  
  209.  
  210.  
  211.                        DABUTIL Version 2.0 Documentation
  212.                                    - Page 1 -
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.                            When something goes wrong
  222.  
  223.  
  224.  
  225.      When you are using the programs in DABUTIL, you may find that
  226.      something does not work correctly, or as you expected. This can
  227.      occur for a number of reasons:
  228.  
  229.           - The program has a bug
  230.  
  231.           - The program is not compatible with your software (it may be your
  232.             version of DOS or it may be some other software)
  233.  
  234.           - The program is not compatible with your hardware
  235.  
  236.  
  237.      First, check the User's Manual and the associated help screens, to
  238.      see if either one addresses the problem. If it is the case that there
  239.      is a discrepancy between the way the manual says the program should
  240.      work, and the way it actually works, then you should report the problem
  241.      to Simian Id Software. When you contact Simian Id Software, you should
  242.      report:
  243.  
  244.           - What kind of PC you are using. (IBM or brand of compatible)
  245.  
  246.           - What other hardware may be relevant. (Video type, disk type,
  247.             printer type)
  248.  
  249.           - What version of DOS you are running.
  250.  
  251.           - Your user registration number.
  252.  
  253.  
  254.      If it is the case that the software behaves in accordance with
  255.      the manual, but differently than you would want it to, then that
  256.      is an opportunity for you to influence the direction which DABUTIL
  257.      takes in future versions. If a program does not do something it
  258.      ought to do, contact Simian Id Software and let us know what should
  259.      be changed. Not everyone's changes can be added to a program,
  260.      but it is to the advantage of Simian Id Software to include new
  261.      ideas, thus improving the usefulness of the package for everyone.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.                        DABUTIL Version 2.0 Documentation
  273.                                    - Page 2 -
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. CATALOG (Disk Catalog)
  283.  
  284.  
  285.  Description
  286.  
  287.      CATALOG lists files on a diskette or fixed disk on the screen.
  288.      The list may be redirected to a printer, see examples. The disk
  289.      name, date and free space are printed at the top of every page.
  290.      Each directory found on the diskette is shown, and all of the
  291.      files in each directory are shown. When one or more of the archive
  292.      switches (-arc, -zip, etc.) are used, the contents of appropriate
  293.      archive files are listed.
  294.  
  295.  
  296.  Command Format
  297.  
  298.      catalog [d:] [-w] [archives]
  299.  
  300.  
  301.        For each file listed, the file name, extension, size, are shown. Also,
  302.        the date and time of the last change to the file are shown.
  303.  
  304.        The first option (d:) can be used to generate a catalog of a disk in a
  305.        drive other than the current drive.
  306.  
  307.        The archives that CATALOG recognizes are ARC, LBR, LZH, PAK, PKA,
  308.        ZIP, and ZOO. They can be specified individually (see the examples
  309.        section), or the option -ALL can be used to list the contents of
  310.        all archive types known to CATALOG.
  311.  
  312.        The CRC and compressed size of file are shown for files in an
  313.        archive. The second option (-w) specifies that a description of
  314.        compression technique should be printed for each file in the an
  315.        archive. If the wide option is selected, the print width is 132
  316.        characters, so set your 80-column printer to compressed mode
  317.        if it has that option. (Consult your printer manual.)
  318.  
  319.        If no archive options are specified, the contents of the archives
  320.        will not be listed. If one or more of the archive switches are
  321.        selected, the contents of the corresponding archive types will be
  322.        listed. To list the contents of all archive types known to CATALOG,
  323.        select the '-all' option.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                        DABUTIL Version 2.0 Documentation
  334.                                    - Page 3 -
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  Examples
  344.  
  345.      catalog
  346.        will list all the files in all directories of the current disk on
  347.        the screen. Files contained in archive files will not be listed.
  348.  
  349.      catalog >prn
  350.        will create the same list, but the output will be sent to the printer.
  351.  
  352.      catalog a:
  353.        will list the files in all directories of the disk in drive A on
  354.        the screen.
  355.  
  356.      catalog a: -arc
  357.        will list all files of the A disk. In addition, files in .ARC
  358.        files will be listed.
  359.  
  360.      catalog b: -zip
  361.        will list all files of the B disk. In addition, files in .ZIP
  362.        files will be listed.
  363.  
  364.      catalog -all
  365.        will list all files of the current disk. In addition, files in
  366.        all archive files known to CATALOG will be listed.
  367.  
  368.      catalog -w -arc
  369.        will list all files of the current disk. In addition, when files
  370.        in archive files are listed, a short description of the technique
  371.        used to compress the file will be displayed. When the '-w' option
  372.        is specified, the output is 132 characters wide, so probably, you
  373.        will want to set your printer to 132 columns. Next, run CATALOG,
  374.        redirecting the output to the printer, like this:
  375.  
  376.      catalog -w -arc >prn
  377.  
  378.        The following examples perform the same operation as the previous
  379.        example, but specify that a catalog should be printed for the disk
  380.        in the A drive:
  381.  
  382.      catalog a: -w -arc >prn
  383.      catalog -w -arc a: >prn
  384.  
  385.        These last two examples demonstrate that the order of the options is
  386.        not important.
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                        DABUTIL Version 2.0 Documentation
  395.                                    - Page 4 -
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404. DI (Disk Information)
  405.  
  406.  
  407.  Description
  408.  
  409.      DI shows information about a disk, and can also show information
  410.      about the location and readability of files. It shows sector size,
  411.      track size, cluster size, FAT (File Allocation Table) size, root
  412.      directory size, and a number of other important facts. (See the
  413.      following pages for a complete list.) DI attempts to read the boot
  414.      record, the FAT, and the root directory to determine if they are
  415.      readable. If a file, directory, or search pattern is specified, DI
  416.      will read each sector of each file or directory and display the
  417.      sector numbers. Also, DI attempts to read each sector and will
  418.      indicate the type of error found, if one occurs. A drive letter
  419.      may be specified with DI.
  420.  
  421.  
  422.  Command Format
  423.  
  424.      di [d:][filename]
  425.  
  426.        Where filename can be:
  427.                  di filename
  428.                  di \subdirectory
  429.                  di \subdirectory\filename
  430.                  di c:\subdirectory\filename
  431.  
  432.  
  433.            Wildcards (? or *) are allowed in the file name. When a file is
  434.            specified, the clusters that the file occupies are listed. When
  435.            a subdirectory is specified, the clusters which that subdirectory
  436.            occupies are listed.
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.                        DABUTIL Version 2.0 Documentation
  456.                                    - Page 5 -
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  Examples
  468.  
  469.      di readme.doc
  470.        will list the boot record information for the current disk and
  471.        the clusters and sectors for readme.doc. DI will search for
  472.        README.DOC in the current directory.
  473.  
  474.      di \readme.doc
  475.        will list the same disk information, except that the backslash will
  476.        indicate to DI to search in the root directory of the current disk
  477.        for README.DOC.
  478.  
  479.      di c:\readme.doc
  480.        will list information for the C drive, even if it is not the current
  481.        drive.
  482.  
  483.      di \word\readme.doc
  484.        will tell DI to look on the current disk, in the subdirectory
  485.        WORD, to find README.DOC.
  486.  
  487.      di c:\word\readme.doc
  488.        will tell DI to look on disk C: in subdirectory WORD for readme.doc.
  489.  
  490.  
  491.  
  492.    Instead of a single file such as readme.doc, search pattern can
  493.    be specified, for example:
  494.  
  495.      di c:\word\*.*
  496.  
  497.        will tell DI to go to disk C: in the subdirectory WORD, and display
  498.        the sectors for each file found there.
  499.  
  500.  
  501.  
  502.    Instead of a file, a subdirectory can be specified, for example:
  503.  
  504.      di c:\word
  505.  
  506.        If WORD is a subdirectory, DI will list the clusters and sectors
  507.        that WORD occupies.
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.                        DABUTIL Version 2.0 Documentation
  517.                                    - Page 6 -
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528. Output
  529.  
  530.  
  531.      DI first attempts to read the boot record, and shows if there
  532.      are any problems reading it. If read successfully, this is the
  533.      information it contains (all numbers are shown in decimal and
  534.      hexadecimal). This is a typical example of what information DI
  535.      shows:
  536.  
  537.  
  538.      DI  (Disk Info) Version 2.00 Copyright 1988, 1989, 1990 by Don Branson
  539.  
  540.      Boot record read successfully.
  541.      System id: DIGITAL
  542.      Disk format: Double-sided, 9 sectors, 80 tracks
  543.      Sector size (in bytes):        512  (0x0200)
  544.      Sectors per cluster:             1  (0x0001)
  545.      Total sectors on disk:        2880  (0x0b40)   16-bit sector numbers
  546.      Total clusters on disk:       2880  (0x0b40)
  547.      Sectors per track:              18  (0x0012)
  548.      Number of heads (sides):         2  (0x0002)
  549.      Total cylinders:                80  (0x0050)
  550.      Disk capacity:                1440K (0x05a0)
  551.      FAT size (in sectors):           9  (0x0009)   12-bit FAT entries
  552.      Copies of the FAT:               2  (0x0002)
  553.      First directory block:          19  (0x0013)
  554.      Number of directory entries:   224  (0x00e0)
  555.      Directory size (in sectors):    14  (0x000e)
  556.      Number of reserved sectors:      1  (0x0001)
  557.      Special reserved sectors:        0  (000000)
  558.  
  559.      FAT read successfully.
  560.      Directory read successfully.
  561.  
  562.  
  563.      The numbers are shown in both decimal and hexadecimal formats.
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.                        DABUTIL Version 2.0 Documentation
  578.                                    - Page 7 -
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.        / System id:
  588.          Indicates what operating system was used to format
  589.          the disk. For example: IBM    3.1 Sometimes, if the
  590.          disk was formatted using a different version of DOS
  591.          than the one you use, this can cause directories to
  592.          be corrupted. Consult your DOS Manual when
  593.          upgrading your system to a new version of DOS.
  594.  
  595.        / Sector size:
  596.          The size in bytes of a disk sector (usually 512).
  597.  
  598.        / Sectors per cluster:
  599.          Files are allocated one cluster at a time. A cluster
  600.          is a contiguous group of sectors.
  601.  
  602.        / Total sectors on disk:
  603.          Includes boot record, FAT, root directory, and data
  604.          area. DI also indicates if 16-bit or 32- bit sector
  605.          numbers are in use on this disk.
  606.  
  607.        / Total clusters on disk:
  608.          The total number of clusters on the disk. This is
  609.          derived using the formula:
  610.  
  611.          Total sectors / sectors-per-cluster.
  612.  
  613.        / Sectors per track:
  614.          Each track (concentric ring) on a disk surface is
  615.          divided into this number of sectors.
  616.  
  617.        / Number of heads (sides):
  618.          The number of recording surfaces (and therefore the
  619.          number of read/write heads). Diskettes have either
  620.          one or two sides. Hard drives usually have more.
  621.  
  622.        / Total cylinders:
  623.          The total number of cylinders on the disk. A cylinder
  624.          consists of a set of tracks which is equidistant from
  625.          the center of the disk. Each recording surface will
  626.          have one track in each cylinder.
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.                        DABUTIL Version 2.0 Documentation
  639.                                    - Page 8 -
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.        / Disk capacity:
  649.          Total storage in kilobytes. Includes the boot record,
  650.          the FAT, the root directory, and the data area.
  651.  
  652.        / FAT size (in sectors):
  653.          The FAT (File Allocation Table) is a table which
  654.          contains lists of the clusters allocated to each
  655.          file. The value shown is the size of a single copy
  656.          of the FAT. DOS usually keeps two copies of the
  657.          FAT on every disk, in case the first copy becomes
  658.          damaged. DI also indicates if the FAT contains
  659.          12-bit or 16-bit cluster numbers.
  660.  
  661.        / Copies of the FAT:
  662.          Typically, two copies are kept of the FAT. If
  663.          the first becomes unreadable, the second is used.
  664.  
  665.        / First directory block:
  666.          The first sector assigned to the root directory. The
  667.          root directory is assigned in a single contiguous
  668.          group of sectors.
  669.  
  670.        / Number of directory entries:
  671.          The root directory is fixed in size. This number is
  672.          the maximum number of entries that it may have.
  673.  
  674.        / Directory size (in sectors):
  675.          The total sectors required to hold the number of
  676.          entries given above.
  677.  
  678.        / Number of reserved sectors:
  679.          This is the number of sectors reserved which are
  680.          located before the FAT. Typically, one sector is
  681.          allocated, and used for the boot record.
  682.  
  683.        / Special reserved sectors:
  684.          Includes the number of sectors of previous partitions
  685.          for a hard disk, and other DOS allocations.
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.                        DABUTIL Version 2.0 Documentation
  700.                                    - Page 9 -
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709. DIRM (Directory Maintenance)
  710.  
  711.  
  712.  Description
  713.  
  714.      DIRM is a full-screen directory maintenance utility which allows
  715.      you to manage your subdirectories in ways beyond what DOS can do.
  716.      DIRM will:
  717.  
  718.          - Allow easy navigation from directory to directory.
  719.  
  720.          - Rename directories.
  721.  
  722.          - Hide/unhide directories.
  723.  
  724.          - Create/delete directories
  725.  
  726.      DIRM allows you to easily change the name of any subdirectory.
  727.  
  728.      DIRM also allows directories to be hidden. By doing this, the
  729.      directories will not show up when normal DOS commands are used,
  730.      such as the DIR command. If you want to unhide a directory,
  731.      DIRM will do that also.
  732.  
  733.      DIRM also allows directories to be easily created and deleted.
  734.      If the subdirectory to delete contains any subdirectories or
  735.      files, those must be deleted with FILEMAN or the DOS ERASE
  736.      command before you can delete the directory in which they
  737.      reside.
  738.  
  739.      The F1 key will display a help screen.
  740.  
  741.  
  742.  Command Format
  743.  
  744.      dirm
  745.  
  746.        All operations are performed within DIRM by using the arrow keys
  747.        and function keys. The function keys available are displayed
  748.        on the screen:
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.                        DABUTIL Version 2.0 Documentation
  761.                                   - Page 10 -
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.      ,-------------------------------------------------------------------------^
  771.      |                                                                         |
  772.      | DIRM - Directory maintenance, Copyright (c) 1989, 1990 by Don Branson   |
  773.      |                                                                         |
  774.      |                                                                         |
  775.      |    ,------------^                                                       |
  776.      |    |  DOS       |   Use arrow keys to select a subdirectory.            |
  777.      |    |  WP        |                                                       |
  778.      |    |  UTILITY   |   HOME - Top of list.                                 |
  779.      |    |            |   END  - End of list.                                 |
  780.      |    |            |                                                       |
  781.      |    |            |   F1 - Help!               F2 - Change current drive. |
  782.      |    |            |   F3 - Go to directory.    F4 - Rename directory.     |
  783.      |    |            |   F5 - Hide directory.     F6 - Unhide directory.     |
  784.      |    |            |   F7 - Delete directory.   F8 - Create new directory. |
  785.      |    |            |                                                       |
  786.      |    |            |   Use ESC to quit.                                    |
  787.      |    |            |                                                       |
  788.      |    |            |                                                       |
  789.      |    |            |                                                       |
  790.      |    |            |                                                       |
  791.      |    |            |                                                       |
  792.      |    +------------;                                                       |
  793.      |     Current directory:                                                  |
  794.      |     C:                                                                  |
  795.      |                                                                         |
  796.      +-------------------------------------------------------------------------;
  797.  
  798.  
  799.  
  800.      ESC - Return to DOS
  801.  
  802.      These functions are performed by the following function keys:
  803.      F1 - Help
  804.      F2 - Enter a new drive letter
  805.      F3 - Change the current directory to the one selected
  806.      F4 - Rename the selected directory, see Appendix A, "Entry Windows"
  807.      F5 - Mark the directory as a hidden directory
  808.      F6 - Remove the hidden flag from the directory
  809.      F7 - Delete the directory. All files and subdirectories
  810.           must be removed first.
  811.      F8 - Create a new directory. You will be asked to supply
  812.           a name.
  813.  
  814.      The current directory is shown at the bottom of the screen. The
  815.      subdirectories in the current directory are shown within the box.
  816.      Use the arrow, Home, End, PgUp, and PgDn keys to move the cursor.
  817.  
  818.  
  819.  
  820.  
  821.                        DABUTIL Version 2.0 Documentation
  822.                                   - Page 11 -
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831. DOSMENU (DOS Menu Utility)
  832.  
  833.  
  834.  Description
  835.  
  836.      DOSMENU is a program which displays a menu of options, and
  837.      allows one to be selected. The commands for that option are
  838.      executed, then the menu is re-displayed. This allows programs
  839.      to be used easily, without having to remember the particular
  840.      combination of DOS commands required to run them.
  841.  
  842.  
  843.  Command Format
  844.  
  845.      dosmenu [menufile]
  846.  
  847.      DOSMENU uses the file DOSMENU.TXT by default. DOSMENU.TXT contains
  848.      a description of the options displayed on the menu, and the commands
  849.      executed by each option. Any number of files can be set up for use
  850.      with DOSMENU. To use one of these alternate files, specify the name
  851.      of the file on the command line, and the alternate file will be used.
  852.  
  853.  
  854.  Setting up the menu description file
  855.  
  856.      For example, say that we want to be able to use the LD program
  857.      from the menu. Assume that LD is on your C drive, in the directory
  858.      DOS. To use a program from a menu, we first need to enter it into
  859.      the menu, in this manner:
  860.  
  861.      1) Edit the file DOSMENU.TXT.  SBE (included in DABUTIL) may be used
  862.         for this purpose by entering:
  863.  
  864.           sbe dosmenu.txt
  865.  
  866.      2) Add these lines to the file: If DOSMENU.TXT already has something
  867.         in it, then add these lines to the end. If the menu entry for
  868.         "A" has already been used, then use a different letter.
  869.  
  870.          A
  871.          List all the directories on this disk
  872.          C:\DOS\LD;
  873.          PAUSE
  874.  
  875.      The first character of the first line is the menu option letter.
  876.      You may any printable character here, such as A, M, 0, 1, @, #, &,
  877.      and so forth. A character may be use only once.
  878.  
  879.  
  880.  
  881.  
  882.                        DABUTIL Version 2.0 Documentation
  883.                                   - Page 12 -
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.      The second line is the description that will displayed when the
  893.      menu is on the screen.
  894.  
  895.      The third and following lines are DOS commands that are needed to
  896.      run the program. The final DOS command, "PAUSE", will leave the
  897.      display on the screen until you press a key, so that you can see
  898.      the display before returning to the menu. In this case, two
  899.      commands are required, so the first one ends with ';' to indicate that
  900.      more commands follow. Whenever more than one command is required, use
  901.      a semicolon (;) on all commands except for the last.
  902.  
  903.      This is the general format used in DOSMENU.TXT to set up a menu:
  904.  
  905.      A
  906.      Description
  907.      Command
  908.      B
  909.      Description
  910.      Command1;
  911.      Command2;
  912.      Command3
  913.      C
  914.      Description
  915.      #Command1;
  916.      Command2
  917.          .
  918.          .
  919.          .
  920.  
  921.      Each item to be displayed on your menu requires:
  922.          1 - A character to be entered by the user.
  923.          2 - A description to be shown to the user.
  924.          3 - The command or commands, as you would enter them at the
  925.              DOS prompt, including any arguments. If there are more
  926.              commands than one to execute for the option, follow each
  927.              with a semicolon (;) except for the last one.
  928.  
  929.      These three things must be entered for each option, on separate
  930.      lines, in the order given. The first option can be any printable
  931.      character: letter, number or any character that you can type at
  932.      the keyboard.
  933.  
  934.      If a pound sign precedes the first command in the sequence, DOSMENU
  935.      recognizes that it should release all the memory it uses before it
  936.      executes the commands. It is known as the "0K" option, since
  937.      DOSMENU uses 0K of RAM when executing programs in this way. The third
  938.      menu option specified above uses the "0K" option. It is useful for
  939.      large programs which would not execute unless they have all your
  940.      memory available.
  941.  
  942.  
  943.                        DABUTIL Version 2.0 Documentation
  944.                                   - Page 13 -
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  Displaying the Menu
  954.  
  955.      To display the menu that you have just set up, type DOSMENU and
  956.      press RETURN. The file DOSMENU.TXT needs to be in the current
  957.      directory, and the file DOSMENU.COM should be in the current
  958.      directory or in a directory specified by the PATH command. You can
  959.      have the menu displayed when your computer is first turned on by
  960.      putting the command DOSMENU into your AUTOEXEC.BAT file.
  961.  
  962.      To use DOSMENU with more than one menu, you may create menu files
  963.      with names other than DOSMENU.TXT, for example:
  964.  
  965.      Create a file called DOSMENU.TX2, in the same manner as described
  966.      above. Then, execute DOSMENU by typing this command:
  967.  
  968.              dosmenu dosmenu.tx2
  969.      This tells DOSMENU to use the alternate menu instead of DOSMENU.TXT.
  970.      You can create a number of menu files, and then specify which one
  971.      you want to use.
  972.  
  973.      For an example of how to use alternate menus, see the files
  974.      PRINTER.BAT and PRINTER.TXT included with DABUTIL.  PRINTER.BAT
  975.      is a batch file which executes DOSMENU using the menu option
  976.      file PRINTER.TXT.
  977.  
  978.  
  979.  DOSMENU troubleshooting hints
  980.  
  981.      - If nothing will execute, it may be that DOSMENU cannot find your
  982.        COMMAND.COM file. This will happen if COMMAND.COM is hidden, or
  983.        may happen if you used the SET command to change the COMSPEC
  984.        variable. If COMMAND.COM is hidden because you need to protect
  985.        it, try setting the Read-only attribute instead.
  986.  
  987.      - If a command in DOSMENU.TXT fails, DOSMENU will not attempt to
  988.        execute subsequent commands.
  989.  
  990.      - If you get the error message "Option too long" this can refer to
  991.        the letter, the description, or the commands. The letter must be
  992.        one character, the description can be up to 75 characters. A
  993.        command can be up to 180 characters long. If a command is
  994.        rejected as too long, and it is less than 180 characters, check
  995.        to make sure that the previous command ends with a semi-colon (;).
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.                        DABUTIL Version 2.0 Documentation
  1005.                                   - Page 14 -
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.      - If an option executes, but the display returns to the menu to
  1015.        quickly to read it, add the PAUSE command as the last command
  1016.        for that option.
  1017.  
  1018.      - If you have a large program which executes correctly from the
  1019.        DOS prompt, but will not work from DOSMENU, try this:
  1020.  
  1021.          DOS commands as entered a prompt:
  1022.  
  1023.              cd \word5
  1024.              word
  1025.  
  1026.          Use these commands in DOSMENU.TXT:
  1027.  
  1028.              #cd \word5;
  1029.              word
  1030.  
  1031.          The '#' used as the first character of the first command tells
  1032.          DOSMENU to write all the commands for this option to a batch
  1033.          file, then execute the batch file. This "0K" option frees the memory
  1034.          used by DOSMENU, so that your large application will have enough
  1035.          memory to execute. The semicolon on the end of the first command
  1036.          tells DOSMENU that the next line of the file is another command
  1037.          for the same option, as shown before.
  1038.  
  1039.          Note that DOSMENU will create a file named '$DOSM01$.BAT' whenever
  1040.          it is used, so the presence of this file on your disk is normal.
  1041.          This file is used to implement the "0K" option, but must always
  1042.          be present to satisfy DOS when it is used.
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.                        DABUTIL Version 2.0 Documentation
  1066.                                   - Page 15 -
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075. DOW (Day of Week)
  1076.  
  1077.  
  1078.  Description
  1079.  
  1080.      DOW returns the day of week in the DOS errorlevel, which can then
  1081.      be used in a batch file. The errorlevel is set to 0 for Sunday,
  1082.      1 for Monday, and so forth, so that Saturday is indicated by an
  1083.      errorlevel 6.
  1084.  
  1085.      DOW can be used in a batch file to determine the day of week and
  1086.      display it. See Z.BAT, included with DABUTIL, for an example of
  1087.      how this works.
  1088.  
  1089.      DOW is also useful in conjunction with EVENTMAN, for such cases
  1090.      as skipping a daily process on weekends, or similar instances.
  1091.      This listing of the file Z.BAT shows how DOW might be used in
  1092.      a batch file:
  1093.  
  1094.  
  1095.  
  1096.      echo off
  1097.      dow
  1098.      if errorlevel 6 goto weekend
  1099.      if errorlevel 5 goto Friday
  1100.      if errorlevel 4 goto Thursday
  1101.      if errorlevel 3 goto Wednesday
  1102.      if errorlevel 2 goto Tuesday
  1103.      if errorlevel 1 goto Monday
  1104.      if errorlevel 0 goto weekend
  1105.      exit 1
  1106.      :weekend
  1107.      echo Weekend, not executing daily process
  1108.      exit 0
  1109.      :monday
  1110.      echo Today is Monday
  1111.      exit 0
  1112.      :tuesday
  1113.      echo Today is Tuesday
  1114.      exit 0
  1115.      :wednesday
  1116.      echo Today is Wednesday
  1117.      exit 0
  1118.      :thursday
  1119.      echo Today is Thursday
  1120.      exit 0
  1121.      :friday
  1122.      echo Today is Friday
  1123.      exit 0
  1124.  
  1125.  
  1126.                        DABUTIL Version 2.0 Documentation
  1127.                                   - Page 16 -
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136. DTIME (Display Date and Time)
  1137.  
  1138.  
  1139.  Description
  1140.  
  1141.      DTIME is a command which displays the current date and time in
  1142.      a format which is easy to read. DTIME can be used at the command
  1143.      line, or in batch files. Including DTIME in your AUTOEXEC.BAT file
  1144.      would cause the current date and time to be displayed when you
  1145.      first start up your system. DTIME is also useful for use with
  1146.      EVENTMAN, for displaying the start and stop time of events and
  1147.      processes.
  1148.  
  1149.  
  1150.  Command Format
  1151.  
  1152.      dtime
  1153.  
  1154.  
  1155.  Example
  1156.  
  1157.      dtime
  1158.  
  1159.      The time is 9:04 P.M. on Wednesday, January 2, 1991
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                        DABUTIL Version 2.0 Documentation
  1188.                                   - Page 17 -
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197. ENC (Encrypt)
  1198.  
  1199.  
  1200.  Description
  1201.  
  1202.      ENC encrypts a file using the supplied password. This program
  1203.      performs a simple encryption, and is useful against casual prying,
  1204.      but does not necessarily comply with any standards for security.
  1205.  
  1206.  
  1207.  Command Format
  1208.  
  1209.      enc file1 file2 password
  1210.        Where file1 is the file to encrypt, file2 is the resultant
  1211.        encrypted file, and password is used to perform the encryption.
  1212.        To recover the contents of file1, type:
  1213.  
  1214.      enc file2 file3 password
  1215.        File3 will now contain what file1 contained. Password
  1216.        must be keyed exactly the same: case and length, etc.
  1217.  
  1218.        If the password contains spaces, it must be
  1219.        enclosed in double quotes:
  1220.  
  1221.      enc file1 file2 "pass word"
  1222.  
  1223.  
  1224.        You must know the password in order to restore the original
  1225.        contents of the file, since the password is not saved anywhere.
  1226.  
  1227.  
  1228.  Example
  1229.  
  1230.      enc z.bat z.enc "super secret"
  1231.  
  1232.        The file Z.ENC now contains the file Z.BAT in encrypted form.
  1233.  
  1234.      enc z.enc z.une "super secret"
  1235.  
  1236.        The file Z.UNE now contains an exact copy of the file Z.BAT
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.                        DABUTIL Version 2.0 Documentation
  1249.                                   - Page 18 -
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. EVENTMAN (Event Manager)
  1259.  
  1260.  
  1261.  Description
  1262.  
  1263.      EVENTMAN is a program which allows you to create events and
  1264.      processes. An event is a sequence of DOS commands which
  1265.      perform some task. A process is a list of events, which has a
  1266.      starting date and time, and a time interval for repetition.
  1267.      The processes created with EVENTMAN are run using the program
  1268.      PROCESS, which is part of DABUTIL.
  1269.  
  1270.      EVENTMAN is used for any application which requires that programs
  1271.      be executed on a regular basis, that is, daily, weekly, monthly,
  1272.      or some other interval. Also, EVENTMAN will handle an application
  1273.      that needs to be run once, but at some time when the system will
  1274.      be unattended. An example of how to use EVENTMAN to sign on to an
  1275.      electronic Bulletin Board System (BBS) follows. Also, EVENTMAN is
  1276.      useful for managers of systems which require regular backups. Any
  1277.      case where some process needs to be run unattended at a certain
  1278.      time or run repeatedly can be addressed by EVENTMAN. An example of
  1279.      how to use EVENTMAN follows, in order to demonstrate how it is
  1280.      used and clarify some details.
  1281.  
  1282.  
  1283.  Command Format
  1284.  
  1285.      eventman
  1286.  
  1287.      The files which EVENTMAN uses are always stored in the current
  1288.      directory.
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.                        DABUTIL Version 2.0 Documentation
  1310.                                   - Page 19 -
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  Example
  1320.  
  1321.      Automatic bulletin board signon
  1322.  
  1323.      The files necessary to try this example are provided with
  1324.      DABUTIL, with the exception of the file MSK232A.EXE. This
  1325.      file is the executable file for KERMIT version 2.32. In order
  1326.      to run this demonstration, you will need KERMIT, which is a
  1327.      terminal emulation program which is in the public domain, and
  1328.      commonly available. This demonstration uses the KERMIT script
  1329.      file capability, but any terminal emulation program which allows
  1330.      operation without manual intervention could be used.
  1331.  
  1332.      First, run EVENTMAN from the DOS prompt, and you will see a
  1333.      screen that looks like this:
  1334.  
  1335.  
  1336.      ,---------------------------------------------------------------------------^
  1337.      |  EVENTMAN - Event/Process Manager, Copyright (c) 1989, 1990 Don Branson   |
  1338.      |                                                                           |
  1339.      |    F1 - Help    F2 - Edit event    F3 - Add event    F4 - Delete event    |
  1340.      |    F5 - Define processes           ESC - Return to DOS                    |
  1341.      | ,-----------------------------------------------------------------------^ |
  1342.      | |001 DISPTIME Display current system time                               | |
  1343.      | |002 LINE     Display a line of text                                    | |
  1344.      | |003 KERMIT   Signon to a BBS, retrieve and print new messages          | |
  1345.      | |                                                                       | |
  1346.      | +-----------------------------------------------------------------------; |
  1347.      |                                                                           |
  1348.      |                                                                           |
  1349.      |                                                                           |
  1350.      |                                                                           |
  1351.      |                                                                           |
  1352.      |                                                                           |
  1353.      |                                                                           |
  1354.      |                                                                           |
  1355.      |                                                                           |
  1356.      |                                                                           |
  1357.      +---------------------------------------------------------------------------;
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.                        DABUTIL Version 2.0 Documentation
  1371.                                   - Page 20 -
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.      This example uses a number of events. The first is DISPTIME,
  1381.      which prints the current time on the standard printer. It is used
  1382.      to print the starting and ending time for the process. The second
  1383.      event used is LINE, which sends a row of dashes to the printer.
  1384.      It is used to print a line separating each execution of the process.
  1385.      The last event used is KERMIT, which executes the batch file
  1386.      KERMIT.BAT, and prints the session log. KERMIT.BAT is necessary
  1387.      because KERMIT does not return a meaningful error code, so the
  1388.      DOS EXIT command is used to clear the error flag.
  1389.  
  1390.      You may use the arrow, TAB, HOME, END, PgUp, and PgDn keys to select
  1391.      events. Use F2 to edit the event file currently selected. An event
  1392.      file contains commands executable at the DOS prompt (like a batch
  1393.      file.) Use F3 to create a new event, and F4 to delete an existing
  1394.      event. Pressing ESC returns you to the DOS prompt.
  1395.  
  1396.      One process, named MESSAGE, is used for this example. While viewing
  1397.      the previous screen, press F5 to define processes, and this screen
  1398.      will be displayed:
  1399.  
  1400.  
  1401.      ,---------------------------------------------------------------------------^
  1402.      |  EVENTMAN - Event/Process Manager, Copyright (c) 1989, 1990 Don Branson   |
  1403.      |                                                                           |
  1404.      |   F1 - Help    F2 - Edit process  F3 - Add process  F4 - Delete process   |
  1405.      |   ESC - Return to event list                                              |
  1406.      |                                                                           |
  1407.      | ,-----------------------------------------------------------------------^ |
  1408.      | |001 DISPTIME Display current system time                               | |
  1409.      | |002 LINE     Display a line of text                                    | |
  1410.      | |003 KERMIT   Use KERMIT to signon to a BBS and retrieve new messages   | |
  1411.      | |                                                                       | |
  1412.      | +-----------------------------------------------------------------------; |
  1413.      | ,--------------------------------------------------------^                |
  1414.      | |001 MESSAGE  D Wednesday, October 3, 1990       2:00 A.M.                |
  1415.                                                                 |
  1416.      | |                                                        |                |
  1417.      | |                                                        |                |
  1418.      | |                                                        |                |
  1419.      | +--------------------------------------------------------;                |
  1420.      |                                                                           |
  1421.      |                                                                           |
  1422.      |                                                                           |
  1423.      |                                                                           |
  1424.      |                                                                           |
  1425.      |                                                                           |
  1426.      +---------------------------------------------------------------------------;
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.                        DABUTIL Version 2.0 Documentation
  1433.                                   - Page 21 -
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.      From here, select the process MESSAGE, then press F2 to edit the
  1443.      process MESSAGE, and this screen will be displayed:
  1444.  
  1445.  
  1446.      ,---------------------------------------------------------------------------^
  1447.      |  EVENTMAN - Event/Process Manager, Copyright (c) 1989, 1990 Don Branson   |
  1448.      |                                                                           |
  1449.      |   F1 - Help    F2 - Edit process  F3 - Add process  F4 - Delete process   |
  1450.      |   ESC - Return to event list                                              |
  1451.      |                                                                           |
  1452.      | ,-----------------------------------------------------------------------^ |
  1453.      | |001 DISPTIME Display current system time                               | |
  1454.      | |002 LINE     Display a line of text                                    | |
  1455.      | |003 KERMIT   Use KERMIT to signon to a BBS and retrieve new messages   | |
  1456.      | |                                                                       | |
  1457.      | +-----------------------------------------------------------------------; |
  1458.      | ,--------------------------------------------------------^                |
  1459.      | |001 MESSAGE  D Wednesday, October 3, 1990       2:00 A.M.                |
  1460.                                                                 |
  1461.      | |                                                        |                |
  1462.      | |                                                        |                |
  1463.      | |                                                        |                |
  1464.      | +--------------------------------------------------------;                |
  1465.      | F1 - Help      ESC - Cancel entry of process                              |
  1466.      | Process name: MESSAGE                                                     |
  1467.      |         type: D           (Daily,Weekly,Monthly,Single,Other)             |
  1468.      |   Start date: 1990/10/3   (YYYY/MM/DD) Wednesday, October 3, 1990         |
  1469.      |   Start time: 02:00       (HH:MM)      2:00 A.M.                          |
  1470.      |                                                                           |
  1471.      |       Events: DISPTIME,KERMIT,DISPTIME,LINE                               |
  1472.      |                                                                           |
  1473.      |                                                                           |
  1474.      |                                                                           |
  1475.      +---------------------------------------------------------------------------;
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.                        DABUTIL Version 2.0 Documentation
  1495.                                   - Page 22 -
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.      MESSAGE is a type 'D' process, which means that it is run every
  1505.      day at the same time. Use 'W' to indicate weekly processes, and
  1506.      'M' for monthly processes. Use 'S' to indicate processes that
  1507.      will be run a single time. Use 'O' to indicate that you want to
  1508.      specify your own interval for repeating the process. When selecting
  1509.      'O', an additional option will appear where you should enter the
  1510.      repeat interval in minutes.
  1511.  
  1512.      Each process has a start date and time. The time shown is the
  1513.      first time it will be run. When processes are run (using PROCESS),
  1514.      this date and time will be reset based on the type of process.
  1515.      In other words, every time a daily process is run, the process
  1516.      date is set to the next day. For a weekly process, the date is
  1517.      set to the same day of the next week. Monthly processes are
  1518.      reset to the same day next month. Single process are run only
  1519.      once, so the date is not incremented. Type 'O' processes are
  1520.      reset by adding the number of minutes you specify to the process
  1521.      time, and adjusting the date accordingly.
  1522.  
  1523.      The process MESSAGE will execute the events specified in the
  1524.      order they are listed:
  1525.  
  1526.          DISPTIME
  1527.          KERMIT
  1528.          DISPTIME
  1529.          LINE
  1530.  
  1531.      MESSAGE first displays the time with the event DISPTIME.
  1532.      Then MESSAGE executes the KERMIT event, which runs KERMIT.BAT,
  1533.      then prints out the session log from KERMIT. MESSAGE then runs
  1534.      the event DISPTIME again to display the time. Finally, MESSAGE
  1535.      runs the event LINE, which prints a separator line.
  1536.      The program PROCESS is used to run processes. To use it, enter
  1537.      the command PROCESS at the DOS prompt. A screen like this one
  1538.      will be displayed:
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.                        DABUTIL Version 2.0 Documentation
  1556.                                   - Page 23 -
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.      ,---------------------------------------------------------------------------^
  1566.      |   PROCESS - Real-time process execution, Copyright (c) 1990 Don Branson   |
  1567.      |                                                                           |
  1568.      |   F1 - Help    ESC - Cancel processing                                    |
  1569.      |                                                                           |
  1570.      | The time is 7:11:17 A.M. on Tuesday, October 2, 1990                      |
  1571.      |                                                                           |
  1572.      | MESSAGE  D Wednesday, October 3, 1990       2:00 A.M.                     |
  1573.      |                                                                           |
  1574.      |                                                                           |
  1575.      |                                                                           |
  1576.      |                                                                           |
  1577.      |                                                                           |
  1578.      |                                                                           |
  1579.      +---------------------------------------------------------------------------;
  1580.  
  1581.  
  1582.      Any processes with a date and time that is already past will be
  1583.      updated until their date and time are in the future. This is
  1584.      done only when process begins execution.
  1585.  
  1586.      The option "-t" can be specified with PROCESS to speed up the
  1587.      system clock for testing purposes. Many weeks of processes can
  1588.      be tested in a few minutes.
  1589.  
  1590.      The "-t" option is used in this way:
  1591.  
  1592.        process -t30
  1593.  
  1594.      In this case, the system clock will be advanced 30 minutes
  1595.      every five seconds. Other time intervals can also be
  1596.      specified, for example:
  1597.  
  1598.        process -t60
  1599.  
  1600.      would advance the system clock 60 minutes every 5 seconds.
  1601.  
  1602.      NOTE: In test mode, the system clock is advanced at a much
  1603.      higher rate than normal. PROCESS restores the date and time
  1604.      when it exits. However, if your system crashes, or if for
  1605.      some other reason PROCESS does not exit normally, you will
  1606.      have to set the clock back manually.
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.                        DABUTIL Version 2.0 Documentation
  1617.                                   - Page 24 -
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626. FF (Find Files)
  1627.  
  1628.  
  1629.  Description
  1630.  
  1631.      FF lists all occurrences of a file, the directories they are found in,
  1632.      and some information about each occurrence.
  1633.  
  1634.  Command Format
  1635.  
  1636.      ff [d:]filename [-g] [-a]
  1637.        The filename is required. The filename may contain the
  1638.        wildcard characters '?' and '*'. Using '-g' tells FF to do
  1639.        a global search, which means that all drives on your system
  1640.        will be searched for files matching the pattern. Using '-a'
  1641.        tells FF to search any archive found for files matching the
  1642.        pattern. Archive types searched are ARC, ZIP, PKA, PAK, ZOO,
  1643.        and LBR. If the Read-only or Hidden attribute flag is set,
  1644.        the flag is displayed after the file.
  1645.  
  1646.  Examples
  1647.  
  1648.      ff *.c
  1649.  
  1650.        will display all the directories where any file having the extension .C
  1651.        is found, and each occurrence of file with that extension. A drive
  1652.        specifier may be specified to search a drive other than the current
  1653.        drive. Hidden files will be displayed, subdirectories will not.
  1654.  
  1655.      ff command.com -g
  1656.  
  1657.        will display each occurrence of COMMAND.COM on all disks on the
  1658.        system.
  1659.  
  1660.      ff command.com -g -a
  1661.  
  1662.        will display each occurrence of COMMAND.COM on all disks on the
  1663.        system, and will also display any COMMAND.COM files in any archives
  1664.        found.
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.                        DABUTIL Version 2.0 Documentation
  1678.                                   - Page 25 -
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687. These are examples of what the output from FF looks like:
  1688.  
  1689.  
  1690. B>ff *.com
  1691.  
  1692. FF (Find Files) Version 2.00 (C) Copyright 1988,1990 by Don Branson
  1693.  
  1694. B:\
  1695.   FCB.COM          7119 bytes  Nov  8, 1989  22:02:54
  1696.   MKSCRN.COM       7889 bytes  Jan 22, 1990  21:35:28
  1697.  
  1698. B:\DABUTIL2
  1699.   FF.COM          14755 bytes  Oct  2, 1990  07:31:16
  1700.   FILEMAN.COM     43208 bytes  Sep 17, 1990  07:12:30
  1701.  
  1702. B:\UTIL
  1703.   MKSCRN.COM       7925 bytes  Jan 27, 1990  00:00:20
  1704.   FCB.COM          7119 bytes  Nov  8, 1989  22:02:54
  1705.  
  1706.  6 files found.
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.                        DABUTIL Version 2.0 Documentation
  1739.                                   - Page 26 -
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748. C>ff a:*.* -a
  1749.  
  1750. FF (Find Files) Version 2.00 (C) Copyright 1988, 1990 by Don Branson
  1751.  
  1752. Archives will be searched.
  1753.  
  1754.  
  1755. A:\
  1756.   FIDO12R.LZH     66164 bytes  Jun 13, 1990  18:52:28
  1757.   PCUTIL.LBR       5888 bytes  Jun 13, 1990  18:48:36
  1758.   RANDOM.ARC       4480 bytes  May  9, 1989  20:58:34
  1759.   TEST.PAK         1597 bytes  Jun 13, 1990  19:55:10
  1760.   TOZIP51.ZIP     18922 bytes  Jun 13, 1990  18:49:22
  1761.   UGUIDE.ZOO     167155 bytes  Jun 13, 1990  19:14:18
  1762.   WHEREIS.LBR      8192 bytes  Jun 13, 1990  18:48:44
  1763. RANDOM.ARC
  1764.   -RANDOM.DOC      2440 bytes  Mar 12, 1989  17:05:38
  1765.   -RANDOM.FOR      5226 bytes  Mar 12, 1989  17:05:52
  1766. TEST.PAK
  1767.   -MAKEFILE.MF       38 bytes  Oct  3, 1989  13:48:30
  1768. PCUTIL.LBR
  1769.   -PCUTIL.COM      0, 1980  0:00:00
  1770.   -PCUTIL.DOC      0, 1980  0:00:00
  1771. WHEREIS.LBR
  1772.   -WHEREIS.COM     0, 1980  0:00:00
  1773.   -WHEREIS.AQM     0, 1980  0:00:00
  1774. FIDO12R.LZH
  1775.   -12R.EXE        13632 bytes  Nov  2, 1989  13:52:58
  1776.   -EDIT.HLP        2707 bytes  Nov  7, 1989  14:46:26
  1777.   -ERRATA.PRN     56877 bytes  Nov  7, 1989  16:39:20
  1778.   -FILEREQ.INI     1534 bytes  Apr 20, 1989   0:58:40
  1779.   -MAIN.HLP        4795 bytes  Nov 16, 1988  13:42:16
  1780.   -MAKELIST.EXE   24512 bytes  Nov  3, 1989  21:49:56
  1781.   -MESSAGE.HLP     6187 bytes  Nov  2, 1989  14:50:28
  1782.   -MSGFILE.HLP      733 bytes  Nov  7, 1989  14:47:02
  1783.   -POLICY.PRN      3229 bytes  Aug 11, 1989   1:31:24
  1784.   -SET-FIDO.EXE   33008 bytes  Nov 16, 1989  14:11:42
  1785. UGUIDE.ZOO
  1786.   -uguide.n       51469 bytes  Jun  8, 1989  13:40:20
  1787.   -uguide.ps     280988 bytes  Jun  8, 1989  14:31:40
  1788.   -uguide.prn     63951 bytes  Jun  9, 1989  10:01:28
  1789. TOZIP51.ZIP
  1790.   -WHATSNEW.TXT     677 bytes  Sep 16, 1989  23:40:28
  1791.   -TOZIP.EXE      29152 bytes  Sep 16, 1989  23:15:12
  1792.   -TOZIP51.DOC     3101 bytes  Sep 16, 1989  23:59:32
  1793.  
  1794.  30 files found.
  1795.  
  1796.  
  1797.  
  1798.  
  1799.                        DABUTIL Version 2.0 Documentation
  1800.                                   - Page 27 -
  1801.