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