home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1027 / turbobat.man < prev    next >
Encoding:
Text File  |  1993-10-20  |  36.9 KB  |  1,137 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. ExtraDOS Toolbox (tm)
  10. _______________________________________
  11.  
  12. TurboBAT Users Manual
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33. Copyright (c) 1985-93 Foley Hi-Tech Systems (ASP)  All Rights Reserved
  34.  
  35.  
  36. Introduction
  37. _____________________________________________________________________
  38.  
  39.  
  40. ExtraDOS Toolbox is a compilation of tools useful to Microsoft DOS
  41. users.  I originally wrote the first version of ExtraDOS under MS-DOS
  42. because I found a need for them and there were no commercially
  43. available products that provided these functions.  Some ExtraDOS tools
  44. were designed to enhance programs already found in MS-DOS.  Other
  45. tools were familiar to the Unix world, but were not available in
  46. MS-DOS.  Over the years this collection has grown into large group of
  47. very useful tools.  Some of these utilities are duplicates of those
  48. found elsewhere, but often provide much better features or reduced
  49. memory overhead than similar utilities found elsewhere.  In addition,
  50. ExtraDOS complements PC-Tools and Norton Utilities with added tools
  51. these programs do not provide.
  52.  
  53. Over thirty of the ExtraDOS Toolbox utilities have been selected by
  54. Paul Somerson, former Executive Editor of PC Magazine, for Bantam
  55. Books', DOS Power Tools, 2nd Edition, Revised and Expanded for DOS
  56. 5.0.  Many of the ExtraDOS Toolbox utilities are now appearing in many
  57. popular DOS books that feature shareware enhancements for DOS.
  58.  
  59. I hope you find these tools useful and convienent.  Any suggestions
  60. for enhancements, improvements or additions are welcome.  Please
  61. contact use with your comments.
  62.  
  63.  
  64. David R. Foley
  65.  
  66.  
  67. License Agreement
  68. _____________________________________________________________________
  69.  
  70.  
  71.   This software is protected by both United States' copyright law and
  72.   international treaty provisions. Therefore, you must treat this
  73.   software "just like a book," with the following single exception.
  74.   Foley Hi-Tech Systems authorizes you to make archival copies of the
  75.   software for the sole purpose of backing up our software and
  76.   protecting your investment from loss. By saying, "just like a book,"
  77.   Foley Hi-Tech Systems means that this software may be used by any
  78.   number of people and may be freely moved from one computer location
  79.   to another, provided there is absolutely no possibility of it being
  80.   used at one location while it is being used at another. Just as a
  81.   book cannot be read by two different people in two different places
  82.   simultaneously, the software may not be used by two different people
  83.   in two different places simultaneously.
  84.  
  85.   You may not make copies of the software documentation or disk,
  86.   except as described above. You may not distribute, rent, sublicense,
  87.   or lease the software or the documentation. You may not alter,
  88.   modify, or adapt the software or documentation, including but not
  89.   limited to translating, decompiling, reverse assembling, or creating
  90.   derivative works. You may not use the software in a network,
  91.   timeshareing, multiple CPU, or multi- user environment unless each
  92.   user is licensed by Foley Hi-Tech Systems.
  93.  
  94.  
  95. EXTRADOS TOOLBOX
  96. _____________________________________________________________________
  97.  
  98.  
  99. LIMITED WARRANTY
  100.  
  101.   Upon notification of defects in material or workmanship,
  102.   within the warranty period of 45 days from the date of purchase,
  103.   Foley Hi-Tech Systems will, at its option, replace the defective
  104.   diskette or refund the license fee. If you need to return a product,
  105.   call the Foley Hi-Tech Systems Technical Support Service Department
  106.   to obtain a return authorization number. The remedy for breach of
  107.   this warranty shall be limited to replacement or refund and shall
  108.   not encompass any other damages, including but not limited to loss
  109.   of profit, and special, incidental, consequential, or other similar
  110.   claims.
  111.  
  112.   Foley Hi-Tech Systems specifically disclaims all other warranties,
  113.   expressed or implied, including but not limited to implied
  114.   warranties of merchantability and fitness for a particular purpose
  115.   with respect to defects in the diskette and documentation, and the
  116.   program license granted herein in particular, and without limiting
  117.   operation of the program license with respect to any particular
  118.   application, use, or purpose. In no event shall Foley Hi-Tech
  119.   Systems be liable for any loss of profit or any other commercial
  120.   damage, including but not limited to special, incidental,
  121.   consequential, or other damages. This statement shall be construed,
  122.   interpreted, and governed by the laws of the State of California.
  123.  
  124.  
  125. TRADEMARK INFORMATION
  126.  
  127.   ExtraDOS Toolbox, TurboBAT, SpeedRAM, Screen Manager, Profiler,
  128.   WizLabel, CDBS, Press Gate Manager, ExtraWindows Toolbox and Safety
  129.   Disk are trademarks of Foley Hi-Tech Systems.
  130.  
  131.   MS-DOS and Windows are trademarks of Microsoft Corporation.
  132.  
  133.   Norton Utilities are a trademark of Symantec.
  134.  
  135.   PC-Tools is a trademark of Central Point Software.
  136.  
  137. TURBOBAT - Turbo Batch File Compiler
  138. _____________________________________________________________________
  139.  
  140.  
  141. DESCRIPTION
  142.  
  143.   TurboBAT allows you to compile standard DOS batch files into .COM
  144.   binary programs.  This will greatly enhance the speed of large batch
  145.   files by allowing them to run in native code rather than interpreted
  146.   DOS commands. The resulting .COM files may call nested batch files
  147.   without loosing the parent since the parent calling program is now
  148.   no longer a batch file.
  149.  
  150.  
  151. COMMAND FORMAT
  152.  
  153.  
  154.   TURBOBAT [/1][/4][/A][/Dname][/I][/L][/T][/X] file[.ext]
  155.  
  156.   /1      Insert single stepping code.  The creates a version of the
  157.           output that is useful when debugging a batch file.  When the
  158.           output .COM program is run, it will single step through each
  159.           line of the original program.
  160.  
  161.   /4      Supress 4DOS warning messages.  Don't report any warning
  162.           messages generated by the use of 4DOS specific commands.
  163.  
  164.   /A      Supress all warning messges (same as /4/I/L/X).  Don't
  165.           display any warning messages, only error messages.
  166.  
  167.   /Dname  Include full symbolic tracing information.  If NAME is
  168.           specified the information will be sent to the named file,
  169.           otherwise is is displayed via the standard error device.
  170.           There must not be any spaces between /D and NAME.
  171.  
  172.   /I      Ignore nonstandard labels.  DOS supports labels up to 8
  173.           characters long for use with the goto statement.  Many
  174.           people use the label as a comment field rather than a label
  175.           and this can cause problems when a label that is used in a
  176.           non standard fashion shows up during the compile stage of
  177.           the batch file. DOS will noramally just ignore this error.
  178.  
  179.   /L      Relaxed label length checking.  The normal label size
  180.           recognized by DOS is 8 characters.  In many cases people use
  181.           the : as a place holder for the program without ever
  182.           referencing the label. The problem is that if you have more
  183.           than one long label name where the first 8 digits match
  184.           another label, the file won't compile because it will look
  185.           as though you have duplicate labels.  This switch relaxes
  186.           that limit.
  187.  
  188.   /T      Compile with line number TRACE information.  The line number
  189.           information is displayed via the standard error device.
  190.           When running the output program compiled with this option on
  191.           you will get a display of each line number as the program is
  192.           running. This is useful when trying to determine where a
  193.           program is failing.
  194.  
  195.  
  196. TURBOBAT - Turbo Batch File Compiler
  197. _____________________________________________________________________
  198.  
  199.   /X      Supress extension warning messages.  Normally during
  200.           compilation, TurboBAT will warn you about any lines that
  201.           make use of commands that are supported by the compiler but
  202.           are not supported by DOS. Using the /X will tell TurobBAT
  203.           not to warn you about any BATCH files that will not function
  204.           under normal DOS conditions.
  205.  
  206.   /B-     Use ANSI escape sequences instead of the BIOS.  The default
  207.           screen I/O is now handled by making calls to the video BIOS.
  208.           This insures that the compiled batch file will work on any
  209.           machine with or without ANSI.SYS installed.  The drawback
  210.           to this is that BIOS calls are much slower than ANSI calls.
  211.           If you know that the machine that will be running the
  212.           compiled program then using the /B- command will speed up
  213.           the video calls.
  214.  
  215.  
  216. NOTES
  217.  
  218.   TurboBAT is a multipass batch file compiler.  It takes interpreted
  219.   DOS batch files and turns them into binary programs that can execute
  220.   up to as much as 4 times faster than normal batch files.  While
  221.   supporting most of the normal DOS functions that can be called from
  222.   within a batch file, TurboBAT also provides many additional features
  223.   including support for many 4DOS/NDOS commands.
  224.  
  225. WARNING !!!!
  226.  
  227.   From a compiled batch file, do not execute any programs that will
  228.   remain resident in memory when it terminates.  Doing so can result
  229.   in an unstable system, requiring you to reboot your computer.
  230.  
  231. EXTENDED BATCH COMMANDS
  232.  
  233.   TurboBAT support many commands beyond those supported in normal
  234.   batch files. Some of these commands are in support of J.P. Softwares
  235.   4DOS Batch Enhancements and others are to replace small external DOS
  236.   utilities.
  237.  
  238.  
  239.  
  240. TURBOBAT - Turbo Batch File Compiler
  241. _____________________________________________________________________
  242.  
  243.  
  244. INTERNALLY SUPPORTED COMMANDS
  245.  
  246.  
  247.   DOS Commands and batch file commands that are directly supported by
  248.   TurboBAT and require no external programs are:
  249.  
  250.  
  251.   %?     "Internal" evironment variable.  Expands to the error level
  252.          of the last executed program as a string.
  253.  
  254.          Example:  SET LASTERROR=%?
  255.  
  256.  
  257.   BEEP   BEEP [frequency duration ...]
  258.  
  259.          Sounds a tone of the specified frequency for the duration in
  260.          clock ticks.  The defaults are 440Hz (A below middle C) for 2
  261.          clock ticks (about 1/4 second).
  262.  
  263.          The list of tones and durations can be repeated on a single
  264.          line. This table is identical to the 4DOS tone table:
  265.  
  266.           ╔════════╦═══════╤═══════╤═══════╤════════╤═══════╗
  267.           ║ C      ║  131  │  262  │  523  │  1040  │  2093 ║
  268.           ║ C#/Db  ║  139  │  277  │  554  │  1103  │  2217 ║
  269.           ║ D      ║  147  │  294  │  587  │  1176  │  2349 ║
  270.           ║ D#/Eb  ║  156  │  311  │  622  │  1241  │  2489 ║
  271.           ║ E      ║  165  │  330  │  659  │  1311  │  2637 ║
  272.           ║ F      ║  175  │  349  │  698  │  1391  │  2794 ║
  273.           ║ F#/Gb  ║  185  │  370  │  740  │  1488  │  2960 ║
  274.           ║ G      ║  196  │  392  │  784  │  1568  │  3136 ║
  275.           ║ G#/Ab  ║  208  │  415  │  831  │  1662  │  3322 ║
  276.           ║ A      ║  220  │  440  │  880  │  1760  │  3520 ║
  277.           ║ A#/Bb  ║  233  │  466  │  932  │  1866  │  3729 ║
  278.           ║ B      ║  248  │  494  │  988  │  1973  │  3951 ║
  279.           ╚════════╩═══════╧═══════╧═══════╧════════╧═══════╝
  280.  
  281.  
  282.   BOOT   BOOT [WARM | COLD]
  283.  
  284.          Boots the computer.  If no options are specified or if WARM
  285.          is specified a WARM boot will occur.  If COLD is specified
  286.          the computer will go through the entire cold boot process.
  287.          Under Desqview, a warm boot will only close the window.
  288.  
  289.   CDD    CDD drive:path
  290.  
  291.          Changes subdirectories and drives.  This command will change
  292.          the current directory and drive to the one specified in
  293.          [drive:path] and make the current DOS drive equal to the
  294.          value in [drive]. Normally within dos the CD command will
  295.          change directories on any drive that you specify but will
  296.          keep the current drive the same. CDD allows you to switch to
  297.          that drive rather than stay on the current drive.
  298.  
  299. TURBOBAT - Turbo Batch File Compiler
  300. _____________________________________________________________________
  301.  
  302.  
  303.   CHDIR/CD  CD path
  304.             CD drive:path
  305.  
  306.             Change the current directory as specified in path.  If a
  307.             drive is specified than change the current directory of
  308.             that drive to the directory specified in path.
  309.  
  310.   CLS       CLS [[bright] [blink] fg on bg]
  311.  
  312.             Clears the screen and optionally sets the screen color.
  313.             When setting the colors the syntax is identical to the
  314.             COLOR command.
  315.  
  316.   COLOR     COLOR [bright] [blink] fg ON bg
  317.  
  318.             Uses ANSI escape squences to set the screen color. Only
  319.             the first three letters of each command word are actually
  320.             significant.  The following colors are allowed:
  321.  
  322.               BLAck     BLUe      GREen     RED
  323.               MAGenta   CYAn      YELlow    WHIte
  324.  
  325.             Example:  COLOR BRIGHT WHITE ON BLUE
  326.  
  327.  
  328.   DELAY     DELAY [seconds]
  329.  
  330.             Pauses for the specified interval in seconds.  If no
  331.             duration is given it will pause for 1 second.
  332.  
  333.  
  334.  
  335.   ECHO      ECHO [message]
  336.  
  337.             If the /D switch was used at compile time you can enable
  338.             or disable command echoing with ECHO OFF and ECHO ON.
  339.             ECHO without any text will indicate if the /D switch was
  340.             used when the file was compiled, not the current status of
  341.             command echoing. To display a blank line use "ECHO:" or
  342.             "ECHO.".
  343.  
  344.  
  345. TURBOBAT - Turbo Batch File Compiler
  346. _____________________________________________________________________
  347.  
  348.   ECHOS     ECHOS [message]
  349.  
  350.             Displays the message without appending a cr/lf to the end
  351.             of the message like ECHO does.  (used to be ECHONLN but was
  352.             updated to match the 4DOS command.
  353.  
  354.  
  355.   ELSE      If the IFF condition was false the lines from ELSE to
  356.             ENDIFF will be executed.
  357.  
  358.             See Also IFF.
  359.  
  360.  
  361.   ELSEIFF   ELSEIFF condition [THEN]
  362.  
  363.             Similar structure to the IFF command. If the previous IFF
  364.             was false and the current condition is true the code
  365.             following will be executed to the next ELSE, ELSEIFF, or
  366.             ENDIFF statement.  Each use of ELSEIFF counts as a nesting
  367.             level.  The compiler actually converts this command into
  368.             logical ELSE^IFF^ENDIFF statements.
  369.  
  370.             See Also IFF.
  371.  
  372.   ENDIFF    Terminates an IFF statement.
  373.  
  374.             See Also IFF.
  375.  
  376.  
  377.   EXIT      EXIT is used when at the DOS level if you are running
  378.             within a shelled version of the command interpretor and
  379.             you wish to exit the shelled session.  The EXIT command is
  380.             ignored by TurboBAT. See also QUIT.
  381.  
  382.  
  383.   FOR       FOR %%var IN (file list) [DO] command
  384.  
  385.             Allows more than a single letter as the loop variable. Can
  386.             be nested.  The loop variable can be tested from other
  387.             lines by treating it as a normal environment variable.
  388.             The word "DO" is required by DOS but is optional under
  389.             4DOS and Turbobat.
  390.  
  391.  
  392. TURBOBAT - Turbo Batch File Compiler
  393. _____________________________________________________________________
  394.  
  395.   GOTO   GOTO label
  396.  
  397.          Will jump control to the label.  Labels are marked as a line
  398.          begining with a :.
  399.  
  400.  
  401.   GOSUB  GOSUB label
  402.  
  403.          Calls a label in the current batch file as a subroutine. Must
  404.          have a matching RETURN statement. The end of the batch file
  405.          does NOT act as a RETURN.
  406.  
  407.  
  408.   IF     IF [NOT] first (== | EQ | NE | LT | LE | GT | GE) second command
  409.          IF [NOT] ERRORLEVEL [== | EQ | NE | LT |LE | GT | GE] value command
  410.          IF [NOT] ENVFREE [== | EQ | NE | LT |LE | GT | GE] value command
  411.          IF [NOT] EXIST filename command.
  412.          IF [NOT] ISDIR path command
  413.  
  414.          EQ (equal), also '==' and '='
  415.          NE (not equal),
  416.          LT (less than),
  417.          LE (less or equal),
  418.          GT (greater than),
  419.          GE (greater or equal).
  420.  
  421.          If no compare command is used for ERRORLEVEL or ENVFREE the
  422.          default of GE will be used.
  423.  
  424.          EXIST tests for the existence of a file.
  425.  
  426.             IF EXIST my.cfg GOTO continue
  427.             ECHO Configuration file is missing
  428.             QUIT 99
  429.             :continue
  430.  
  431.          ISDIR tests if the given path specification is an existing
  432.          subdirectory.
  433.  
  434.             IF NOT ISDIR \work MD \work
  435.  
  436.          ENVFREE tests the available environment space.
  437.  
  438.             IF ENVFREE LT 123 ECHO Insufficient environment space
  439.  
  440.  
  441.  
  442. TURBOBAT - Turbo Batch File Compiler
  443. ___________________________________________________________
  444.  
  445.  
  446.   IFF    IFF condition [THEN]
  447.  
  448.          If the condition is true the lines up to ELSE, ELSEIFF or
  449.          ENDIFF (whichever appears first) will be executed. IFF
  450.          statements may be nested up to 15 levels deep.  See also IF.
  451.  
  452.                 IFF %? EQ 0 THEN
  453.                   GOTO CONTINE
  454.                 ELSEIFF %? EQ 99
  455.                   THEN GOTO CRITICAL
  456.                 ELSE
  457.                   GOTO ERROR
  458.                 ENDIFF
  459.  
  460.  
  461.   INKEY  INKEY [/Wn] [message] %%var
  462.  
  463.          Gets a single keystroke and places it in the environment.
  464.          %%var is the environment variable that will be assigned the
  465.          keystroke. If /W is specified the command will wait up to
  466.          that many seconds, e.g. /W10. It will also optionally display
  467.          a message.  If a wait of zero is used (/W0) the command will
  468.          return immediately if no keystrokes are pending.  The wait
  469.          period can be specified in the environment, but the /W but be
  470.          present on the line at compile time, e.g.:
  471.  
  472.              inkey /w%delay Press any key: %%key
  473.  
  474.          Displayable keystrokes (characters above the space) are
  475.          stored as their corresponding character.  Keystrokes that do
  476.          not have a corresponding character are displayed as a number,
  477.          e,g. the carriage return as "13".  Extended keystrokes such
  478.          as F1 are stored with a preceding '@', (@59 for F1).
  479.  
  480.  
  481.   INPUT  INPUT [/Wn] [message] %%var
  482.  
  483.          Gets a string and places it in the environment.  %%var is the
  484.          environment variable that will be assigned the string.  The
  485.          string is terminated by a carriage return or end of file mark
  486.          (^Z).  Extended keystrokes are ignored.  /Wn is the optional
  487.          maximum time in seconds to wait for the first keystroke.
  488.          Once a keystroke is entered this command will not time out.
  489.  
  490.   MKDIR  MKDIR [pathname]
  491.   MD     MD [pathname]
  492.  
  493.          Will create a new directory of PATHNAME.
  494.  
  495.  
  496.   PATH   Displays or Sets the Path.
  497.  
  498.  
  499. TURBOBAT - Turbo Batch File Compiler
  500. ___________________________________________________________
  501.  
  502.  
  503.  
  504.   PAUSE   PAUSE [message]
  505.  
  506.           Displays an optional message.  If no message is specified the
  507.           default of "Press a key when ready..." is used.  In addition,
  508.           a CR/LF is not output until after the key is pressed.
  509.  
  510.  
  511.   PROMPT  Displays or Sets the DOS Prompt
  512.  
  513.  
  514.   QUIT    QUIT [exitcode]
  515.  
  516.           Unconditionally halts the compiled batch file.  If no
  517.           exitcode is specified, zero will be used.  The exit code can
  518.           refer to an environment variable.  If the variable is not a
  519.           number or does not exist zero will be used.  Examples:
  520.  
  521.                 SET var=1
  522.                 QUIT %var
  523.  
  524.           Exits with 1.
  525.  
  526.                 SET var=test
  527.                 QUIT %var
  528.  
  529.           Exits with 0 because %var is not a number.
  530.  
  531.  
  532.   REM     REM is the standard DOS Remark field.  REM lines are ignored
  533.           by the TurboBAT Compiler.
  534.  
  535.  
  536.   REPEAT/
  537.   UNTIL   Similar to the Pascal structure.  May be nested up to 15
  538.           deep. Redirection is not allowed on a line containing REPEAT
  539.           or UNTIL.
  540.  
  541.                 REPEAT
  542.                   ECHO %1
  543.                   SHIFT
  544.                 UNTIL "%1" EQ ""
  545.  
  546.  
  547.   RETURN  Return from a subroutine call.  If no subroutines are
  548.           pending it will terminate the batch file with an exit code of 255.
  549.  
  550.   RD
  551.   RMDIR   Remove Directory.  This will remove the directory specified
  552.           as long as there are no files in it.
  553.  
  554.  
  555.  
  556.  
  557. TURBOBAT - Turbo Batch File Compiler
  558. _____________________________________________________________________
  559.  
  560.  
  561.   SCREEN  SCREEN row column [message]
  562.  
  563.           Positions the cursor using ANSI sequences and displays an
  564.           (optional) message.  The cursor coordinates are 0 based, the
  565.           normal range being 0-24 rows and 0-79 columns.
  566.  
  567.  
  568.   SCRPUT  SCRPUT row col [bright][blink] fg ON bg message
  569.  
  570.           Writes the message at the specified screen coordinates using
  571.           the specified colors.  The cursor position is restored to
  572.           the position before the command.  ANSI escape sequences are
  573.           used throughout.
  574.  
  575.   SET     Alone, Set will display the current environment variables,
  576.           or followed by an environment variable, set will set the
  577.           environment variable to the given value.
  578.  
  579.  
  580.   SHIFT   Same as standard DOS.  I will be expanding this command for
  581.           4DOS compatibility to accept a shift factor, with support
  582.           for a negative number which will get back previously shifted
  583.           parameters.
  584.  
  585.   SINGLESTEP    SINGLESTEP ON | OFF
  586.  
  587.           Enables or disables single stepping.  The /1 compiler switch
  588.           must be used for this command to have any effect.  The
  589.           options are resolved at compile time so you can not use an
  590.           environment variable or command line parameter to set the
  591.           status.
  592.  
  593.  
  594.  
  595.   TEXT/
  596.   ENDTEXT The text that follows, up to ENDIFF will be displayed as if
  597.           each line was preceded by an ECHO. Output redirection is
  598.           more efficient using this command instead of individually
  599.           redirected ECHO commands since the file will only be opened
  600.           and closed once, while the file will be opened and closed
  601.           for each ECHO command.
  602.  
  603.                 TEXT
  604.                 This could be a menu
  605.                 or it could be help information
  606.                 ENDTEXT
  607.  
  608.                 TEXT >dummy
  609.                 This text will be sent to the redirection file.
  610.                 Up to, but not including the ENDTEXT command.
  611.                 ENDTEXT
  612.  
  613.  
  614.  
  615. TURBOBAT - Turbo Batch File Compiler
  616. _____________________________________________________________________
  617.  
  618.  
  619.   UNSET   Deletes the environment variable from the master environment.
  620.  
  621.                 UNSET RESULT
  622.  
  623.  
  624.   WHILE/
  625.   WEND    Similar to the Pascal structure. May be nested up to 15
  626.           deep. Redirection is not allowed on a line containing WHILE
  627.           or WEND.
  628.  
  629.                 WHILE "%1" NE ""
  630.                   ECHO %1
  631.                   SHIFT
  632.                 WEND
  633.  
  634.  
  635.  
  636.  
  637.  
  638. COMMANDS HANDLED BY CALLING THE COMSPEC
  639.  
  640.  
  641.   These commands are supported by calling COMMAND.COM:
  642.  
  643.   CALL, DIR, DEL, REN, VER, VOL, CTTY, CHCP, TYPE, COPY, DATE, TIME,
  644.   ERASE, BREAK, RENAME, DELETE, VERIFY, COMMAND
  645.  
  646.  
  647.   These commands will only work if 4DOS is the active COMSPEC:
  648.  
  649.   FREE, DRAWBOX, DRAWHLINE, DRAWVLINE, MEMORY
  650.  
  651.  
  652.  
  653. TURBOBAT - Turbo Batch File Compiler
  654. _____________________________________________________________________
  655.  
  656. COMPILER ERROR MESSAGES
  657.  
  658.   TurboBat contains a library of internal error messages and will
  659.   display the error number and message when an error or warning is
  660.   found.  Files with just warnings will compile, files with errors
  661.   will not compile.
  662.  
  663.   Warning Messages / Error Messages
  664.  
  665.    1  Duplicate label
  666.  
  667.       Each label must be unique for a file to compile correctly.  Use
  668.       the /I to relax label checking when using the : for marking
  669.       comments.
  670.  
  671.  
  672.    2  Duplicate label (check size)
  673.  
  674.       Sometimes labels are used as comments in batch files.  If a
  675.       label is unique, but after the 8th character the compiler won't
  676.       pick it up as unique since DOS only supports the first 8
  677.       characters of a label.  You can use the /L option to relax label
  678.       length checking.
  679.  
  680.  
  681.    3  Redirection not allowed here
  682.  
  683.       TurboBAT does not support the redirection of output or input at
  684.       the location specified.
  685.  
  686.  
  687.    4  Invalid IF statement
  688.  
  689.       The IF statement is using invalid syntax, check the manual for
  690.       usage of IF and IFF commands.
  691.  
  692.  
  693.    6  Invalid FOR statement
  694.  
  695.       The FOR statement is using invalid syntax, check the manual for
  696.       the usage of the FOR command.
  697.  
  698.  
  699.    7  EXIT can not be used in a compiled batch file
  700.  
  701.       EXIT is normally used to abort a batch file at any location.
  702.       You can not do this with a compiled batch file.  Replace usage
  703.       of EXIT with a GOTO command that jumps to a label at the end of
  704.       the batch file.
  705.  
  706.    8  Label not Found.
  707.  
  708.       A reference was made to a label that does not exist.
  709.  
  710.  
  711. TURBOBAT - Turbo Batch File Compiler
  712. _____________________________________________________________________
  713.    9  Program is too large
  714.  
  715.       The output of the compiled batch file is exceeding 64k bytes.
  716.       TurboBAT currently only supports the .COM format of programs
  717.       under 64k bytes large.  Reduce the commands in your batch file
  718.       if possible.
  719.  
  720.  
  721.   10  REPEAT nested too deeply
  722.  
  723.       You have too many levels of nesting with a REPEAT Loop.  Try
  724.       breaking the repeat loop out of a nested piece of code.
  725.  
  726.  
  727.   11  Unmatched UNTIL
  728.  
  729.       The UNTIL statement found has no opening REPEAT command.
  730.  
  731.  
  732.   12  WHILE nested too deeply
  733.  
  734.       You have too many levels of nesting with a WHILE Loop.  Try
  735.       breaking the while loop out of a nested piece of code.
  736.  
  737.  
  738.   13  Unmatched WEND
  739.  
  740.       The WEND statement found has no opening WHILE command.
  741.  
  742.  
  743.   14  Label longer than nn characters, truncated
  744.  
  745.       Labels that are longer than supported by TurboBAT will be
  746.       truncated to the maximum characters allowed.
  747.  
  748.  
  749.   15  IFF nested too deeply
  750.  
  751.       You have too many levels of nesting with an IFF Loop.  Try
  752.       breaking the iff loop out of a nested piece of code.
  753.  
  754.  
  755.   16  Unmatched ELSE statement
  756.  
  757.       The ELSE statement found has no opening IF or IFF command.
  758.  
  759.  
  760.   17  Unmatched ENDIFF statement
  761.  
  762.       The ENDIFF statement found has no opening IFF command.
  763.  
  764.   18  Unexpected end of file, no matching ENDTEXT
  765.  
  766.       A TEXT command was used without an ENDTEXT command and TurboBAT
  767.       read to the end of the input file before finding an ENDTEXT and
  768.       could not finish the compile.
  769.  
  770. TURBOBAT - Turbo Batch File Compiler
  771. _____________________________________________________________________
  772.  
  773.  
  774.   19  Unmatched ENDTEXT
  775.  
  776.       The ENDTEXT statement found has no opening TEXT command.
  777.  
  778.  
  779.   20  Syntax error
  780.  
  781.       Invalid command syntax was used.  Consult the TurboBAT manual
  782.       for command usage.
  783.  
  784.  
  785.   21  4DOS Specific command used
  786.  
  787.       A command was used that is normally only supported by the use of
  788.       4DOS.  Make sure that the target system has 4DOS installed or
  789.       the resulting .COM file may not work properly.
  790.  
  791.  
  792.   22  TurboBAT extension used
  793.  
  794.       This is notifying you that a non standard command was used
  795.       inside the batch file.  There is no problem with this usage,
  796.       except that the .BAT file might not work unless compiled with
  797.       TurboBAT.
  798.  
  799.  
  800.   23  Open REPEAT statement
  801.  
  802.       A REPEAT command was used with no UNTIL command to close it.
  803.  
  804.  
  805.   24  Open WHILE statement
  806.  
  807.       A WHILE command was used with no WEND command to close it.
  808.  
  809.  
  810.   25  Open IFF/ELSEIFF statement
  811.  
  812.       An IFF or ELSEIFF statement was used with no ENDIFF to close it.
  813.  
  814.  
  815.   26  Command not supported in this version of Turbobat
  816.  
  817.       A command was used that is not supported by TurboBAT.  Contact
  818.       Foley Hi-Tech Systems for details on solving this problem.
  819.  
  820.  
  821.   99  Internal error - please contact Foley Hi-Tech Systems
  822.  
  823.       An internal processing error has occured with TurboBAT.  Contact
  824.       Foley Hi-Tech Systems technical support.
  825.  
  826.  
  827.  
  828. TECHNICAL SUPPORT
  829. _____________________________________________________________________
  830.  
  831.  
  832.   Often we get calls from people asking questions that can be
  833.   solved easily by checking through the manual before calling tech
  834.   support. We ask that you browse the manual and look for information
  835.   pertaining to your particular problem before calling. This can often
  836.   save you time, as we take a collection of our most common questions
  837.   and try to address them in this manual.
  838.  
  839.   We offer alternative methods besides the conventional phone
  840.   support, such as a multi-line 24-hour BBS system. We also monitor
  841.   most technical conferences in the BBS Interlink and RelayNet
  842.   networks as well as many conferences on the CompuServe
  843.   Information System. You may send messages and questions via any of
  844.   these services.
  845.  
  846.   Currently our Tech Support office is staffed Monday through Friday
  847.   from 9:00 a.m. to 5:00 p.m. Pacific Time. There is a chance,
  848.   however, that someone is in the office outside this time frame.
  849.   If so, we will gladly answer your questions outside the normal
  850.   business hours.  Registered users are given unlimited technical
  851.   support.
  852.  
  853.   Foley Hi-Tech Systems
  854.   Technical Support Department
  855.   185 Berry Street
  856.   San Francisco, CA  94107
  857.   (415) 882-1730
  858.   (415) 882-1733 FAX
  859.   (415) 882-1735 BBS
  860.   PCVENB CONF. 13 CompuServe
  861.  
  862.  
  863.  
  864. CREDITS
  865. _____________________________________________________________________
  866.  
  867.  
  868.   This collection of utilities started out as a small set of home
  869.   grown tools that I just could not stand to live without.  Many times
  870.   someone would see me using them and ask for a copy.  This was a big
  871.   mistake.  All of the sudden I had to debug my code.  Someone would
  872.   call me up and remind me of some problem with a utility that I had
  873.   written or asked me to just add this one little feature.  Six years
  874.   later the package has evolved to its current state.  Along the way I
  875.   have had the help of many people in testing and ideas for products.
  876.   I would like to thank all of those people who have of course
  877.   registered these utilities as this is now a new incentive for
  878.   continuing to expand them.  More specifically I'd like to thank the
  879.   following:
  880.  
  881.   Kathy Smith
  882.   Jay Wessel
  883.   Roger Cross
  884.   Brian & Tess for Channel 1
  885.   Paul Somerson & Bantam Books
  886.   PC Tech Journal (A Great Loss)
  887.   PC Magazine
  888.   Byte Magazine
  889.   Jerry Pournelle
  890.   Association of Shareware Professionals
  891.  
  892.  
  893.  
  894.  
  895. PROGRAMMING
  896.  
  897.   The ExtraDOS Toolbox utilties use a wide variety of programming
  898.   tools including:
  899.  
  900.   Borland Turbo Pascal 7.0
  901.   Borland Turbo Assembler 3.0
  902.   Borland Turbo C++ 1.0
  903.   Borland Turbo Debugger 2.0
  904.   Turbo Power Software Object Professional 1.0
  905.   Phil Katz' PKLite Professional 1.13
  906.   Unity Programmers Editor 3.33
  907.   Ralph Browns' Interrupt List
  908.  
  909.  
  910.   Programming by:
  911.  
  912.   Mike Blaszczak
  913.   David Foley
  914.   Joe Halpin
  915.   Bill McKee
  916.   Mike Molloy
  917.   Mike Viens
  918.   Ross Wentworth
  919.   Randall Woodman
  920.  
  921.  
  922. CREDITS
  923. _____________________________________________________________________
  924.  
  925.  
  926.  
  927. ART
  928.  
  929.   Artwork for the ExtraDOS Toolbox was created using:
  930.  
  931.   Ian Davis' TheDraw 4.01
  932.   Aldus Freehand 2.0
  933.   Electronic Arts Studio/8 2.0
  934.  
  935.  
  936.   Art by:
  937.  
  938.   David Foley
  939.   Noel Gamboa
  940.   Moses Gates
  941.   Shahasp Herardian
  942.   Pat McSween
  943.   Ross Wentworth
  944.  
  945.  
  946. DOCUMENTATION
  947.  
  948.   Documentation for the ExtraDOS Toolbox was written using:
  949.  
  950.   FHTS SuperEdit 3.04
  951.   Word Perfect 5.1
  952.   MS Word for Windows 2.0
  953.   Grammatik for Windows 1.0
  954.   Aldus Pagemaker 4.0
  955.   Unity Programmers Editor 3.33
  956.  
  957.  
  958.   Documentation by:
  959.  
  960.   Mike Blaszczak
  961.   David Foley
  962.   Mike Viens
  963.   Ross Wentworth
  964.  
  965.  
  966.   Printed Manuals by:
  967.  
  968.   BindCo, Brisbane, CA.
  969.  
  970.  
  971. LICENSE INFORMATION
  972.  
  973.   CHIMES, EVAL and RAMDRIVE are derivatives of the Nifty James
  974.   utilties by Mike Blaszczak.
  975.  
  976.   FILEATTR, NAMEDIR and SWAPFILE are derivatives of the Fantastic
  977.   Utilities by Mike Viens.
  978.  
  979.  
  980.  
  981. FHTS Products
  982. _____________________________________________________________________
  983.  
  984.  
  985. Safety Disk (tm)
  986.  
  987.   Safety Disk saves all of your systems vital information and will
  988.   solve most problems due to:  Loss of battery power, Loss of CMOS
  989.   information, accidental deletion of boot files, virus damage to boot
  990.   disk.
  991.  
  992.  
  993.   "Use Safety Disk and your PC is Safe.", Computer Shopper, March 1992
  994.  
  995.   "Used in Conjuntion with a conventional backup utility, Safety Disk,
  996.    for $59.95 will provide as bulletproof a backup as you're likely to
  997.    find in the PC marketplace.", InfoWorld, February 10, 1992
  998.  
  999.   "Safety Disk is so deceptively easy to use that it makes hard-drive
  1000.    and computer maintenance seem impossibly easy.", PCM Magazine, May
  1001.    1992
  1002.  
  1003.   "I have discovered the most unique and useful system maintenance
  1004.    utility since Spinrite came along.", MBUG PC Newsletter, December,
  1005.    1991
  1006.  
  1007.  
  1008. ExtraDOS Toolbox (tm)
  1009.  
  1010.   A large collection of over 50 utilities that DOS forgot. Includes
  1011.   many helpful utilities that enhance MS-DOS machines. Featured in the
  1012.   DOS Power Tools, 2nd Edition, Revised for DOS 5.0 book by Bantam
  1013.   Books.
  1014.  
  1015.  
  1016. WizLabel (tm)
  1017.  
  1018.   Print Sharp Wizard phone listings directly to your SLP Printer
  1019.   without having to convert your data.
  1020.  
  1021.  
  1022. Coach Database System■.
  1023.  
  1024.   CDBS provides a method for tracking and evaluating NBA teams, NBA
  1025.   players, and college players. It supplies a comprehensive report
  1026.   generator for building decision support reports on scouted players.
  1027.  
  1028.  
  1029. FHTS Products
  1030. _____________________________________________________________________
  1031.  
  1032.  
  1033.  
  1034. Press Gate Manager■.
  1035.  
  1036.   Software for event organizers. Creates and maintains a database of
  1037.   events and guests with the ability to track seating by type,
  1038.   location, and person. Produces seating charts and labels for press
  1039.   passes.
  1040.  
  1041.  
  1042. FINDB■.
  1043.  
  1044.   Financial Database System for tracking shareholders in a company.
  1045.   Allows the instant retrieval of information based on any part of a
  1046.   persons account id, ss#, zip code etc.  Has support for completely
  1047.   customized HP Laserjet tax forms.  Ideal for generating K1 tax
  1048.   reports for limited partnerships.
  1049.  
  1050.  
  1051.  
  1052. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  1053. _____________________________________________________________________
  1054.  
  1055.  
  1056. We are constantly adding new utilities to the ExtraDOS Toolbox
  1057. collection.  Some are developments of ideas from our customers.  If
  1058. you know of a utility that you would find handy or updates to
  1059. existing utilities please let us know about them.
  1060.  
  1061.  
  1062. BATPLUS     Collection of enhancements for DOS Batch files.  BATPLUS
  1063.             enhancements will also be supported by TurboBAT.
  1064.  
  1065. BOOTMGR     Boot Manager will allow you to choose from many different
  1066.             boot up configurations by displaying a menu of choices
  1067.             at boot time.  Each configuration can have a seperate
  1068.             AUTOEXEC.BAT and CONFIG.SYS associated with it.
  1069.  
  1070. DIALIT      Small TSR that allows you to pop up over any text screen
  1071.             and capture a phone number and then dialing with your
  1072.             modem.
  1073.  
  1074. DIFF        Full screen file comparison utility.  Will display the
  1075.             differences between two different files.
  1076.  
  1077. DIRSORT     Sort directories by Name, Extension, Date, Time or Size.
  1078.  
  1079. DISKTEST    Command line utility to perform testing functions on disk
  1080.             drives looking for bad sectors or clusters.
  1081.  
  1082. EMSX86      EMS 4.0 Memory Manager that converts Extended Memory into
  1083.             LIM EMS 4.0 Expanded memory.
  1084.  
  1085. FKEYSET     Allows you to assign customized values for all the function
  1086.             keys.
  1087.  
  1088. LQPRINT     Allows 9 pin dot matrix printers to print near letter
  1089.             quality output by converting text into high resolution
  1090.             graphics.
  1091.  
  1092. NBSTIME     Will set your PC clock to National Atomic Clock time by
  1093.             calling NBS with your modem.
  1094.  
  1095. PRMPTMGR    Prompt Manager gives you access to a library of DOS prompts
  1096.             and allows you to create your own DOS prompts.
  1097.  
  1098. PRINTCTL    Print Controller is a multiple printer spool and configuration
  1099.             utility.  Supports EMS or DISK spooling and up to three
  1100.             printer ports.
  1101.  
  1102.  
  1103. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  1104. _____________________________________________________________________
  1105.  
  1106.  
  1107. SORT        Advanced SORT utilty for DOS.  Features many enhancements o
  1108.             over the DOS version.
  1109.  
  1110. SPEEDFL     Increase access to some floppy disk drives.
  1111.  
  1112. SPLITFL     Split files into multiples for modem or diskette transfers.
  1113.  
  1114. STOPWTCH    Stop Watch allows you to time programs at the DOS prompt.
  1115.  
  1116. SWAPFILE    Swap to file names with the associated files.
  1117.  
  1118. XCD         Smart CHDIR command.  Will accept partial names.
  1119.  
  1120. XDEL        Advanced delete command.  Allows many options and exclusions.
  1121.  
  1122. XDIR        Updated DIR command with sort options.
  1123.  
  1124. ZIPCODE     TSR to allow the searching of US Postal Zip Code Database.
  1125.  
  1126.  
  1127.  
  1128.  
  1129.   The latest versions of the ExtraDOS Toolbox utilities can be found on:
  1130.  
  1131.   FHTS PC GURU III BBS, San Francisco, CA  (415) 882-1735
  1132.  
  1133.   CHANNEL 1 BBS, Cambridge, MA             (617) 354-8873
  1134.  
  1135.   COMPUSERVE INFORMATION SERVICE           PCVENB CONF. 13
  1136.  
  1137.