home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR13 / 4DDBU500.ZIP / 4DDBU.DOC next >
Text File  |  1991-08-01  |  13KB  |  313 lines
  1.  
  2.  
  3.  
  4.        4DOS/DOS BATCH UTILITIES v5.00                         Page  -1-
  5.  
  6.  
  7.                                                         1st August 1991
  8.  
  9.  
  10.  
  11.                                    CONTENTS
  12.                                    --------
  13.  
  14.  
  15.        Limit of liability.............................................2
  16.        License information............................................2
  17.        Files included in the 4DOS/DOS Batch Utilities.................3
  18.        Use of each program............................................3
  19.           COMPACT.....................................................3
  20.           SQZ.BTM.....................................................4
  21.           GETCH.......................................................4
  22.           TIMEBOOT....................................................5
  23.           TIMEDASK....................................................5
  24.        History........................................................6
  25.        About 4DDBU....................................................6
  26.        Acknowledgments................................................7
  27.  
  28.  
  29.  
  30.  
  31.        4DOS/DOS BATCH UTILITIES v5.00 User Manual              Page  -2-
  32.  
  33.  
  34.                               LIMIT OF LIABILITY
  35.  
  36.        These utilities  are distributed as-is.  The author disclaims all
  37.        warranties,  expressed  or  implied.  The  author  will assume no
  38.        liability for damages either from  the direct use of this product
  39.        or  as a  consequence of  the use  of this product.  Further, the
  40.        author reserves the right to  revise this publication and to make
  41.        changes  from  time  to  time   in  the  content  hereof  without
  42.        obligation of the author to  notify any person or organisation of
  43.        such revision or changes.
  44.  
  45.        These utilities were originally distributed with the REBOOT suite
  46.        of programs.  As they don't depend  on the REBOOT program  in any
  47.        way, they have now been released separately.
  48.  
  49.  
  50.                               LICENSE INFORMATION
  51.  
  52.        These utilities are the copyrighted  property of Peter Ogden. You
  53.        are granted a limited license  to use, copy, and distribute these
  54.        programs provided the following conditions are met:
  55.  
  56.           A. Copying  and  distribution  fees   may  not  exceed  $15.00
  57.              Australian.
  58.  
  59.           B. The  utilities may  only be  distributed in  there original
  60.              unmodified state.
  61.  
  62.        This software  is distributed under  the user supported  software
  63.        concept.  Though  copyrighted,  you  are  encouraged  to copy and
  64.        distribute this program  to others.  If you like this product and
  65.        find it useful, a registration fee of $20.00 Australian (includes
  66.        free  registration of  REBOOT) is required for  continued use.  A
  67.        twelve  month  instant  update  plan  is  available (new versions
  68.        mailed to  you as soon  as they are  complete) for an  additional
  69.        $25.00  AUS.  Site  licenses  are  available  at  a  reduced rate
  70.        (contact the author).
  71.  
  72.        The user  supported software concept (also  known as 'shareware')
  73.        is an attempt  to provide quality software at  low cost. Both the
  74.        user and author benefit from this  plan. The user will benefit by
  75.        being able to "test  drive" software thoroughly before purchasing
  76.        it.  The author  benefits by  being able  to enter the commercial
  77.        software  market  while  avoiding  the  high  cost  of commercial
  78.        distribution.
  79.  
  80.        This concept  helps many independent authors  and small companies
  81.        that would otherwise be discouraged from developing and promoting
  82.        their ideas. It can only work  with your support. If you obtain a
  83.  
  84.  
  85.  
  86.  
  87.        4DOS/DOS BATCH UTILITIES v5.00 User Manual              Page  -3-
  88.  
  89.  
  90.        user supported program  from a friend and you  are still using it
  91.        after a few  weeks, then it is obviously  worth something to you,
  92.        and a contribution should be sent.
  93.  
  94.        For   further   information   and   registration,   please   send
  95.        correspondence to:
  96.  
  97.                Peter Ogden
  98.                ESB Consultancy
  99.                P.O. Box 2259
  100.                Boulder,  W.A.
  101.                Australia.      6432
  102.  
  103.                Fax: +61 90 21 8364
  104.  
  105.        or,   for   information,   bug   reports,   or  suggestions  (not
  106.        registration) Netmail at 3:690/643.5 (FidoNet).
  107.  
  108.  
  109.                 FILES INCLUDED IN THE 4DOS/DOS BATCH UTILITIES
  110.  
  111.        4DDBU.DOC         This document.
  112.        COMPACT.EXE       Program  that  removes  duplicates  from a 4DOS
  113.                          history file.
  114.        GETCH.EXE         Program for  displaying a supplied  question on
  115.                          screen  requiring  a  single  character  reply.
  116.                          Returns  a  DOS  errorlevel  dependent  on  the
  117.                          answer.
  118.        REGISTER.FRM      Registration form.
  119.        SQZ.BTM           4DOS Batch To Memory (BTM) program that removes
  120.                          the duplicate  entries from the  in memory copy
  121.                          of the command history.
  122.        TIMEBOOT.EXE      Program (for AT compatibles only) to reboot the
  123.                          computer automatically at a given time.
  124.        TIMEDASK.EXE      Program for displaying a user supplied question
  125.                          on   screen  (requiring   a  single   character
  126.                          answer), returning a  DOS error level depending
  127.                          on the  answer (for use with  batch files). The
  128.                          question remains on screen  for a maximum of 15
  129.                          seconds.
  130.  
  131.  
  132.                               USE OF EACH PROGRAM
  133.  
  134.        COMPACT:
  135.  
  136.        This program is only of use to  users of 4DOS v3.0 or greater (if
  137.        you have not heard of 4DOS, see the note below).
  138.  
  139.  
  140.  
  141.  
  142.        4DOS/DOS BATCH UTILITIES v5.00 User Manual              Page  -4-
  143.  
  144.  
  145.        COMPACT removes duplicates from a 4DOS command history file. This
  146.        type  of file  is created  by typing  the following  on the  4DOS
  147.        command line:
  148.  
  149.                     HISTORY > FILENAME.EXT
  150.  
  151.        This creates  a file named  FILENAME.EXT containing the  complete
  152.        list  of commands  entered since  the  start  of 4DOS  up to  the
  153.        maximum memory size  allocated to the 4DOS History.  As this is a
  154.        complete  list there  are bound  to be  a few duplicated commands
  155.        where you  have entered the  command again rather  than scrolling
  156.        back through the previous commands in the history.
  157.  
  158.        COMPACT will remove these duplicates  so that you may reload your
  159.        compacted history  file from disk  (with the HISTORY  /R option -
  160.        see the  4DOS documentation).  This compacted history results  in
  161.        faster searches through the history for the desired commands.
  162.  
  163.        COMPACT can handle a history file up to 8K in size, with lines of
  164.        up to 255 characters, and a maximum of 4096 lines.
  165.  
  166.        Type "COMPACT /?" (without the quotes) to get a short explanation
  167.        of how to use COMPACT.
  168.  
  169.  
  170.        SQZ.BTM:
  171.  
  172.        SQZ.BTM  is a  batch to  memory file  that will remove duplicates
  173.        from  the "in  memory" history.  This 4DOS  Batch To Memory (BTM)
  174.        program is an example of how COMPACT might be used. Note: SQZ.BTM
  175.        creates  a temporary  file (__HIST.TMP)  during the  process, and
  176.        deletes it after completion.
  177.  
  178.        Another  use for  a compacted   history file  is to  pre-load the
  179.        history during the AUTOEXEC.BAT  to have frequently used commands
  180.        available via command history.
  181.  
  182.        NOTE: 4DOS is a shareware  replacement (by J.P. Software) for the
  183.              MS/PC-DOS COMMAND.COM.  It enhances the  existing commands,
  184.              adds several new commands,  scrollable command history, and
  185.              heaps more.  If you work  with DOS at  the command line  or
  186.              write complex batch files, you  should be using it! 4DOS is
  187.              available on good BBS's all over the world.
  188.  
  189.  
  190.        GETCH:
  191.  
  192.        This program will optionally display a line of text that requires
  193.        a single character answer.  This allows batch  files to have user
  194.  
  195.  
  196.  
  197.  
  198.        4DOS/DOS BATCH UTILITIES v5.00 User Manual              Page  -5-
  199.  
  200.  
  201.        interaction while running.  The program returns a DOS error level
  202.        which is the  same as the ascii code  of the uppercase equivalent
  203.        of the key pressed.  This error level can then be used in a batch
  204.        "if errorlevel" statement to control flow while running.
  205.  
  206.        e.g. GETCH Do you wish to run SCAN on C:? (Y/N)
  207.  
  208.        GETCH waits for  a key to be pressed,  the errorlevel returned is
  209.        the ascii value of the uppercase  equivalent of the key (i.e. y =
  210.        Y = 89, n = N = 78).
  211.  
  212.        GETCH  has two  options: /F  -  Flush  keyboard, and  /W -  Sound
  213.        Warning. The flush keyboard option removes any keystrokes entered
  214.        prior to the execution of GETCH to prevent accidental activation.
  215.        The warning option sounds a beep  when the text is written to the
  216.        screen to draw the users attention.
  217.  
  218.  
  219.        TIMEBOOT:
  220.  
  221.        This program will set the computer to automatically reboot itself
  222.        at  a given  time.  This is a  very simple  program that sets the
  223.        alarm function  of the AT  Real Time Clock  to activate the  BIOS
  224.        boot sequence.
  225.  
  226.        This  program  is  not  a  TSR,  no  memory  is  reserved, and no
  227.        processing time is taken from the cpu.
  228.  
  229.        To disable a previously set timed boot, type:
  230.  
  231.                TIMEBOOT OFF
  232.  
  233.        Type  "TIMEBOOT   /?"  (without  the  quotes)   to  get  a  short
  234.        explanation of how to use TIMEBOOT.
  235.  
  236.        NOTE: This  version of  TIMEBOOT is  for AT  compatible computers
  237.              only (it  uses the alarm  function of the  built in clock).
  238.  
  239.  
  240.        TIMEDASK:
  241.  
  242.        This program allows the user  to display a question that requires
  243.        a single  character  answer  (for  use  in  batch  programs). The
  244.        program returns an DOS error level which is the same as the ascii
  245.        code of  the uppercase equivalent of  the key pressed, or  if the
  246.        user  does not  answer within  15 seconds,  the program will time
  247.        out, returning a  default error level of 0.  The question entered
  248.        will flash after 10 seconds, and time out after 15 seconds.
  249.  
  250.  
  251.  
  252.  
  253.        4DOS/DOS BATCH UTILITIES v5.00 User Manual              Page  -6-
  254.  
  255.  
  256.        See GETCH for an example. Type "TIMEDASK" (without the quotes) to
  257.        get a short explanation of how to use TIMEDASK.
  258.  
  259.        TIMEDASK  has three  options: /B  - Beep  count down,  /F - Flush
  260.        keyboard,  and  /W  -  Sound   Warning.  The  beep  option  beeps
  261.        approximately once  per second for  the last five  seconds of the
  262.        timed ask, to draw the users attention. The flush keyboard option
  263.        removes any keystrokes entered prior to the execution of TIMEDASK
  264.        to  prevent accidental  activation. The  warning option  sounds a
  265.        beep when  the text is  written to the  screen to draw  the users
  266.        attention.
  267.  
  268.  
  269.                                     HISTORY
  270.  
  271.        v4.01 : (and  earlier)  These  utilities  (with  the exception of
  272.                GETCH)  were previously  a part  of a  suite of  4DOS/DOS
  273.                utilities by the name of REBOOT. As these utilities stand
  274.                alone from  REBOOT and the  size of the  compressed files
  275.                was  becoming large,  it has  been decided  to distribute
  276.                these separately.
  277.  
  278.        v4.02 : New  program   added:  GETCH.  Similar   in  function  to
  279.                TIMEDASK, except GETCH will wait indefinitely for a users
  280.                reply.  Minor optimisation performed on all utilities.
  281.  
  282.        v5.00 : GETCH now  has two new  options: /F and  /W. TIMEDASK now
  283.                has three new  options: /B, /F, and /W.  All programs are
  284.                now  Desqview compatible.  Further optimisation performed
  285.                on all utilities.
  286.  
  287.  
  288.                                  ABOUT 4DDBU
  289.  
  290.        For those that are interested,  the 4DDBU suite was written using
  291.        Turbo Pascal 6.0  and Turbo Assembler 2.0 with  the assistance of
  292.        Turbo  Debugger  and  Turbo  Profiler.  The  unit  libraries were
  293.        written by Glenn Crouch and Peter Ogden. The author would like to
  294.        thank Glenn  Crouch and Jason Cowie  (beta tester extraordinaire)
  295.        for their patience and thoroughness in beta testing the 4DDBU and
  296.        REBOOT programs.
  297.  
  298.  
  299.  
  300.  
  301.        4DOS/DOS BATCH UTILITIES v5.00 User Manual              Page  -7-
  302.  
  303.  
  304.                                 ACKNOWLEDGMENTS
  305.  
  306.        4DOS is copyright Rex Conn & J.P. Software.
  307.        MS-DOS is copyright Microsoft.
  308.        Turbo Pascal and Turbo Assembler are copyright Borland.
  309.        Desqview is copyright Quarterdeck Office Systems.
  310.  
  311.  
  312.                                    ---***---
  313.