home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / progm / xbatch.zip / XBATCH.DOC < prev   
Text File  |  1989-04-07  |  38KB  |  2,311 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   
  8.                                   
  9.                                   
  10.                                   
  11.                                   
  12.                   X-BATCH Extended Batch Commands
  13.                                   
  14.                             Version 1.1
  15.                                   
  16.                                   
  17.                Copyright (c) 1989 by Gary R. Pannone
  18.                         All rights reserved.
  19.                                   
  20.         You may freely distribute this version of X-BATCH if
  21.        you include this documentation file and the demo batch
  22.                                files.
  23.                                   
  24.                                   
  25.                                   
  26.                                   
  27.        If you  find these  programs  useful,  please  send  a
  28.        contribution ($20  suggested) to  the  address  below.
  29.        For a contribution of $25 you will receive an enhanced
  30.        version of  these programs and notification of planned
  31.        future versions.
  32.        
  33.                           Gary R. Pannone
  34.                           35 Park View Rd.
  35.                           Hamden, CT 06514
  36.                                   
  37.                                   
  38.                                   
  39.                                   
  40.                                   
  41.                                   
  42.        If you  have problems with these programs, please send
  43.        a note to the address above.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                        TABLE OF CONTENTS
  74.                        -----------------
  75.      
  76.      
  77.      1.  Introduction..................................1
  78.      
  79.      2.  Running the Demo..............................2
  80.      
  81.      3.  Using the Extended Batch Commands.............3
  82.      3.1   Creating Batch Files........................3
  83.      3.2   Specifying Command Parameters and Keywords..3
  84.      3.2.1   Specifying Colors.........................4
  85.      3.2.2   Specifying Line and Column Numbers........6
  86.      3.2.3   Specifying Text...........................7
  87.      3.3   Checking the ERRORLEVEL Exit Code...........7
  88.      
  89.      4.  Commands......................................9
  90.            BOX.........................................10
  91.            CHKENVIR....................................12
  92.            CHKSCRN.....................................14
  93.            CLRSCRN.....................................16
  94.            COMPFILE....................................18
  95.            CREATE......................................20
  96.            CURSOR......................................21
  97.            DISPFILE....................................22
  98.            DISPLAY.....................................25
  99.            GETCHAR.....................................27
  100.            SHOW........................................29
  101.            SOUND.......................................31
  102.            WAIT........................................32
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.        
  140.        
  141.        
  142.        
  143.        1.   Introduction
  144.        -----------------
  145.  
  146.        X-BATCH is  a collection  of useful  utility programs.
  147.        Some of  the programs  (CLRSRCN, CREATE,  SHOW, SOUND)
  148.        can be  used by  starting them  at the DOS prompt. The
  149.        programs are  especially useful, however, when used as
  150.        commands in batch files.
  151.        
  152.        Command        Description
  153.        ---------      ----------------------------------
  154.        BOX            Display a box with optional border
  155.        CHKENVIR       Test environment variable
  156.        CHKSCRN        Search screen for text
  157.        CLRSCRN        Clear screen with selected colors
  158.        COMPFILE       Compare date, time, or size of files
  159.        CREATE         Create a file
  160.        CURSOR         Position cursor on screen
  161.        DISPFILE       Display text from file in box
  162.        DISPLAY        Display text on screen
  163.        GETCHAR        Wait for specific keys, and report
  164.        SHOW           Display date, time, or day of week
  165.        SOUND          Sound a specific tone for N seconds
  166.        WAIT           Wait for time of day, key, or N seconds
  167.  
  168.        If this manual is printed at 6 vertical lines per inch
  169.        (the standard),  the pages  can be  cut to fit in your
  170.        DOS manual.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.                                  1
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      
  206.      
  207.      
  208.      
  209.      2.   Running the Demo
  210.      ---------------------
  211.  
  212.      An instructional  demonstration is  provided  on  this
  213.      diskette. Although  the  demo  can  be  run  from  the
  214.      diskette, it runs much faster from a hard disk.
  215.  
  216.      To run the demo:
  217.  
  218.      1. Copy  the  files  on  this  diskette  to  an  empty
  219.      subdirectory on your hard disk.
  220.  
  221.      2. Start the demo:
  222.  
  223.           a. If you are using a monochrome monitor, type-
  224.  
  225.                DEMO  /M  <ENTER>
  226.  
  227.           b. If you are using a color monitor, type-
  228.  
  229.                DEMO  <ENTER>
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                                2
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.        
  272.        
  273.        
  274.        
  275.        3.   Using The Enhanced Batch Commands
  276.        --------------------------------------
  277.        
  278.        
  279.        3.1  Creating Batch Files
  280.        -------------------------
  281.  
  282.        You can create batch files with almost any editor that
  283.        produces standard text files. These include:
  284.             
  285.             . EDLIN
  286.             . The IBM Personal Editor
  287.             . The IBM Professional Editor
  288.             . Many popular word processors
  289.        
  290.  
  291.        If possible, save the batch file text without imbedded
  292.        tab characters.
  293.        
  294.        
  295.        3.2  Specifying Command Parameters
  296.        ----------------------------------
  297.  
  298.        Command parameters can be values, or keywords (such as
  299.        BRIGHT), or  keywords followed  by one or more values.
  300.        For example:
  301.        
  302.             screens.dat
  303.        
  304.             CHOICES "abc"
  305.        
  306.             COLORS 7 3
  307.        
  308.             BRIGHT
  309.             
  310.  
  311.  
  312.  
  313.                                  3
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.      This manual describes the format of each command using
  338.      the same notation as your DOS manual:
  339.      
  340.           . Optional parameters are enclosed in []
  341.           . Non-optional choices are enclosed in {}
  342.           . Choices are separated with |
  343.  
  344.      For example:
  345.      
  346.           filename.ext
  347.      
  348.      Means that you must specify a filename.
  349.      
  350.           [BLINK]
  351.      
  352.      Means that the keyword "BLINK" is optional.
  353.      
  354.           [COLOR fg | COLORS fg bg]
  355.      
  356.      Means that you can, for example,  specify "COLOR 5",
  357.      "COLORS 6 5", or neither.
  358.      
  359.           {BYDATE | BYTIME | BYSIZE}
  360.      
  361.      Means that you must specify "BYDATE", "BYTIME", or
  362.      BYSIZE".
  363.  
  364.      Keywords  can  be  typed  in  uppercase  or  lowercase
  365.      letters. Optional  parameters can  be entered  in  any
  366.      order after required parameters.
  367.      
  368.      
  369.      3.2.1  Specifying Colors
  370.      ------------------------
  371.  
  372.      There are  several parameters  that  can  be  used  to
  373.      specify colors.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                                4
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.        The COLORS parameter lets you specify a foreground and
  404.        a background color. For example,
  405.        
  406.             COLORS 4 3
  407.  
  408.        specifies a  foreground color  of 4  and a  background
  409.        color of 3.
  410.  
  411.        The COLOR  parameter lets  you specify  just a   fore-
  412.        ground color. For example,
  413.        
  414.             COLOR 5
  415.  
  416.        specifies a foreground color of 5.
  417.  
  418.        If you  have a  Color/Graphics Adapter,  the available
  419.        foreground colors are:
  420.        
  421.        0 Black        8  Gray
  422.        1 Blue         9  Light Blue
  423.        2 Green        10 Light Green
  424.        3 Cyan         11 Light Cyan
  425.        4 Red          12 Light Red
  426.        5 Magenta      13 Light Magenta
  427.        6 Brown        14 Yellow
  428.        7 White        15 Bright White
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.                                  5
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.      If you  have a  Monochrome Display Adapter, the avail-
  470.      able foreground colors are:
  471.      
  472.      0         Black when  the background  color is 0 or 7,
  473.                white otherwise.
  474.      
  475.      1         Underlined white.
  476.      
  477.      2-7       White.
  478.      
  479.      8         Black when  background is  0  or  7,  bright
  480.                white otherwise.
  481.      
  482.      9         Underlined bright white.
  483.      
  484.      10-15     Bright white.
  485.      
  486.  
  487.      If you specify a low intensity foreground color (0-7),
  488.      you can  make  it  bright  by  specifying  the  BRIGHT
  489.      parameter.
  490.  
  491.      You can  make the characters blink by adding 16 to the
  492.      number  of   the  desired   foreground  color,  or  by
  493.      specifying the BLINK parameter.
  494.  
  495.      Background colors  are always  low intensity, and must
  496.      be in the range 0 to 7.
  497.      
  498.      
  499.      3.2.2  Specifying Line and Column Numbers
  500.      -----------------------------------------
  501.  
  502.      Line numbers  are numbered from 1 to 25. Line 1 is the
  503.      top line  on the screen. Line 25 is the bottom line on
  504.      the screen.
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.                                6
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.        Column numbers  are numbered from 1 to 80. Column 1 is
  536.        the left-most  column on  the screen. Column 80 is the
  537.        right-most column on the screen.
  538.        
  539.        
  540.        3.2.3  Specifying Text
  541.        -----------------------
  542.  
  543.        Some parameters are text strings:
  544.        
  545.             . Text to be displayed (DISPLAY command)
  546.             . Text to be search for (CHKSCRN command)
  547.             . Text to be compared (CHKENVIR command)
  548.             . Environment variable names (CHKENVIR command)
  549.             . Valid characters list (GETCHAR command)
  550.  
  551.        You  can   specify  text  with  or  without  enclosing
  552.        quotation marks. For example:
  553.        
  554.             DISPLAY text AT 6 30
  555.             
  556.                  or
  557.        
  558.             DISPLAY "Some text" AT 6 30
  559.  
  560.        The quotation  marks are  required only  if  the  text
  561.        contains blanks.   If  enclosing quotation  marks  are
  562.        used, a  quotation mark can be imbedded in the text by
  563.        inserting a  back-slash (\)  in front of the quotation
  564.        mark. For example, "He said \"Hello.\"".
  565.        
  566.        
  567.        3.3  Checking the ERRORLEVEL Exit Code
  568.        --------------------------------------
  569.  
  570.        Every command  returns an exit code that can be tested
  571.        using the IF ERRORLEVEL batch command.
  572.  
  573.  
  574.  
  575.  
  576.  
  577.                                  7
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.      The  IF  ERRORLEVEL  command  performs  the  specified
  602.      action if  the exit  code is  GREATER OR  EQUAL TO the
  603.      specified number. For example, the batch command:
  604.      
  605.           IF ERRORLEVEL == 2 ECHO Exit code is >= 2
  606.  
  607.      will display  the message  "Exit code  is >= 2" if the
  608.      exit code is 2, or greater than 2.
  609.  
  610.      Because of the way the IF ERRORLEVEL command works, be
  611.      sure to  check for  the highest  exit codes first. For
  612.      example, to  perform different  actions  depending  on
  613.      exit code values of 0,1,2, or 9, you can write:
  614.      
  615.           IF ERRORLEVEL == 9  action
  616.           IF ERRORLEVEL == 2  action
  617.           IF ERRORLEVEL == 1  action
  618.           default action
  619.  
  620.      The description  of each  command lists  the  possible
  621.      exit codes.  See your  DOS manual for details on using
  622.      IF ERRORLEVEL,  and see the sample batch files on this
  623.      diskette for examples of exit code checking.
  624.  
  625.           Note:   When a  command detects  a syntax
  626.           error or  invalid  parameter,  it  always
  627.           displays an  error message  on the screen
  628.           at the current cursor position.
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.                                8
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.        
  668.        
  669.        
  670.        
  671.        4.   Commands
  672.        -------------
  673.  
  674.        This chapter  contains descriptions  of  each  X-BATCH
  675.        command.
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.                                  9
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.       BOX Command
  731.       -----------
  732.  
  733.      
  734.      
  735.      Purpose:
  736.  
  737.          The BOX  command displays  a box  on  the  screen.
  738.          Optionally, a border is draw around the box.
  739.      
  740.      Format:
  741.      
  742.          BOX [FROM line1 col1] [TO line2 col2]
  743.              [BORDER | SINGLE | DOUBLE] [NOCLEAR]
  744.              [COLORS fg bg | COLOR fg] [BRIGHT]
  745.              [BLINK]
  746.      
  747.      Remarks:
  748.  
  749.          Specify parameters:
  750.  
  751.          [FROM line1  col1] to  set  the  screen  line  and
  752.          column of  the upper-left  corner of the box.  The
  753.          default is  the upper-left  corner of  the  screen
  754.          (line 1 and column 1).
  755.  
  756.          [TO line2  col2] to set the screen line and column
  757.          of the lower-right corner of the box.  The default
  758.          is the  lower-right corner  of the screen (line 25
  759.          and column 80).
  760.  
  761.          [BORDER] to  draw a  block border  around the box.
  762.          The border will appear in the background color.
  763.  
  764.          [SINGLE] to  draw a  single-line border around the
  765.          box.
  766.  
  767.          [DOUBLE] to  draw a  double-line border around the
  768.          box.
  769.  
  770.          [NOCLEAR] to  prevent clearing the interior of the
  771.          box (inside the border).
  772.  
  773.  
  774.  
  775.                                10
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                                     BOX Command
  797.                                                     -----------
  798.  
  799.            [COLORS fg bg] to specify the foreground color and
  800.            the background  color of  the box (both border and
  801.            interior). The  default foreground  color is white
  802.            (7) and the default background color is black (0).
  803.  
  804.                Note:  See section 3.2.1 for a list of
  805.                the color choices.
  806.  
  807.            [COLOR fg] to specify the foreground color.
  808.  
  809.            [BRIGHT] to specify a bright foreground color.
  810.  
  811.            [BLINK] to make the displayed characters blink.
  812.        
  813.        Notes:
  814.  
  815.            Borders connect  the screen  coordinates given  by
  816.            the FROM  and TO  parameters. That  is, the border
  817.            around a  box specifed with the parameters "FROM 4
  818.            10 TO 20 70", will start on line 4 not line 3.
  819.        
  820.        Returned exit codes:
  821.        
  822.            0     Success
  823.            9     Command syntax error or invalid parameter
  824.        
  825.        Examples:
  826.            
  827.            BOX FROM 4 10 TO 20 69 COLORS 15 1
  828.  
  829.            Clears a  blue box,  and sets the foreground color
  830.            within the  box to  bright white.   The upper-left
  831.            corner of the box is at line 4 column 10.
  832.            
  833.            BOX FROM 4 10 TO 20 69 COLORS 15 1 SINGLE NOCLEAR
  834.  
  835.            Draws a  bright-white-on-blue single  line  border
  836.            around a box.  The upper-left corner of the border
  837.            is at line 4 column 10. The interior is unchanged.
  838.  
  839.  
  840.  
  841.                                  11
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.       CHKENVIR Command
  863.       ----------------
  864.  
  865.      
  866.      
  867.      Purpose:
  868.  
  869.          The CHKENVIR command checks whether an environment
  870.          variable is  defined, or  whether it  is set  to a
  871.          specific value.
  872.      
  873.      Format:
  874.      
  875.          CHKENVIR varname [DEFINED | EQUALS "value" [CASE]]
  876.      
  877.      Remarks:
  878.  
  879.          Specify parameters:
  880.  
  881.          [DEFINED] to test whether the variable is defined.
  882.  
  883.          [EQUALS] "value"  to test  whether the variable is
  884.          set equal to "value".
  885.  
  886.          [CASE] to make a case-sensitive comparison (upper-
  887.          case and  lowercase  letters  are  not  considered
  888.          equal).
  889.      
  890.      Notes:
  891.  
  892.          DEFINED is the default action.
  893.  
  894.          The quotation marks are required only if the value
  895.          contains blanks.  If enclosing quotation marks are
  896.          used, a quotation mark can be imbedded in the text
  897.          by inserting  a back-slash  (\) in  front  of  the
  898.          quotation mark. For example, "He said \"Hello.\"".
  899.      
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.                                12
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                              CHKENVIR Command
  929.                                              ----------------
  930.  
  931.        Returned exit codes:
  932.        
  933.            0     Defined, or Equal to
  934.            1     Not equal to
  935.            2     Not defined
  936.            9     Command syntax error or invalid parameter
  937.        
  938.        Examples:
  939.  
  940.            CHKENVIR path DEFINED
  941.  
  942.            Tests whether  the environment  variable  PATH  is
  943.            defined.   The exit  code is  set to  0 if  it  is
  944.            defined, or 2 othewise.
  945.  
  946.            CHKENVIR comspec EQUALS "C:\COMMAND.COM"
  947.  
  948.            Tests whether  the environment variable COMSPEC is
  949.            equal to "C:\COMMAND.COM" (uppercase and lowercase
  950.            letters are considered equivalent).  The exit code
  951.            is set  to 0  if it  is equal,  1  if  COMSPEC  is
  952.            defined to   a different value, or 2 if COMSPEC is
  953.            undefined.
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.                                  13
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.       CHKSCRN Command
  995.       ---------------
  996.  
  997.      
  998.      
  999.      Purpose:
  1000.  
  1001.          The CHKSCRN command searches the screen for a text
  1002.          string.   You can  check every line of the screen,
  1003.          or only one line.
  1004.      
  1005.      Format:
  1006.      
  1007.          CHKSCRN "text string" [LINE n]
  1008.      
  1009.      Remarks:
  1010.  
  1011.          Specify parameters:
  1012.  
  1013.          [LINE n] to check only screen line n.
  1014.      
  1015.      Notes:
  1016.  
  1017.          For CHKSCRN  to find  a match,  the complete  text
  1018.          string must  fit completely  on one  screen  line.
  1019.          Uppercase and  lowercase  letters  are  considered
  1020.          equal.
  1021.  
  1022.          The quotation  marks are required only if the text
  1023.          contains blanks.  If enclosing quotation marks are
  1024.          used, a quotation mark can be imbedded in the text
  1025.          by inserting  a back-slash  (\) in  front  of  the
  1026.          quotation mark.
  1027.      
  1028.      Returned exit codes:
  1029.      
  1030.          0     Found
  1031.          1     Not found
  1032.          9     Command syntax error or invalid parameter
  1033.      
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.                                14
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                                               CHKSCRN Command
  1061.                                               ---------------
  1062.  
  1063.        Examples:
  1064.  
  1065.            CHKSCRN "Can't create directory"
  1066.  
  1067.            Searches every  line of  the screen  for the  text
  1068.            "Can't create directory".
  1069.  
  1070.            CHKSCRN "Can't create directory" LINE 2
  1071.  
  1072.            Searches screen  line 2 for the text "Can't create
  1073.            directory".
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                                  15
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.       CLRSCRN Command
  1127.       ---------------
  1128.  
  1129.      
  1130.      
  1131.      Purpose:
  1132.  
  1133.          The CLRSCRN command clears the screen and sets the
  1134.          selected foreground and background colors.
  1135.      
  1136.      Format:
  1137.      
  1138.          CLRSCRN [BCOLOR bg | COLORS fg bg] [BRIGHT]
  1139.                  [BLINK]
  1140.      
  1141.      Remarks:
  1142.  
  1143.          Specify parameters:
  1144.  
  1145.          [COLORS fg  bg]  to  specify  the  foreground  and
  1146.          background  colors   to  be   used.  The   default
  1147.          foreground color  is white  (7), and  the  default
  1148.          background color is black (0).
  1149.  
  1150.              Note:  See section 3.2.1 for a list of
  1151.              the color choices.
  1152.  
  1153.          [BCOLOR bg] to specify the background color.
  1154.  
  1155.          [BRIGHT] to specify a bright foreground color.
  1156.  
  1157.          [BLINK] to make the displayed characters blink.
  1158.      
  1159.      Returned exit codes:
  1160.      
  1161.          0     Success
  1162.          9     Command syntax error or invalid parameter
  1163.      
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.                                16
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                               CLRSCRN Command
  1193.                                               ---------------
  1194.  
  1195.        Examples:
  1196.  
  1197.            CLRSCRN
  1198.  
  1199.            Clears to  screen to white on black. Equivalent to
  1200.            the DOS CLS command.
  1201.  
  1202.            CLRSCRN BCOLOR 4
  1203.  
  1204.            Clears the screen to white on red.
  1205.  
  1206.            CLRSCRN COLORS 4 2
  1207.  
  1208.            Clears the screen to red on green.
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.                                  17
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.       COMPFILE Command
  1259.       ----------------
  1260.  
  1261.      
  1262.      
  1263.      Purpose:
  1264.  
  1265.          The  COMPFILE   command  compares   the  sizes  or
  1266.          creation dates/times of two files.
  1267.      
  1268.      Format:
  1269.      
  1270.          COMPFILE [d:][path]filename1.ext
  1271.                   [d:][path]filename2.ext
  1272.                   {BYDATE | BYSIZE | BYTIME}
  1273.      
  1274.      Remarks:
  1275.  
  1276.          Specify parameters:
  1277.  
  1278.          BYDATE to compare the creation dates of the files.
  1279.  
  1280.          BYSIZE to compare the sizes of the files.
  1281.  
  1282.          BYTIME to  compare the creation dates and times of
  1283.          the files.  The dates  are compared.  If the dates
  1284.          are equal, the times are compared.
  1285.      
  1286.      Returned exit codes:
  1287.      
  1288.          0     Equal to
  1289.          1     File1 > file2
  1290.          2     File2 > file1
  1291.          9     Command syntax error or invalid parameter
  1292.      
  1293.      Examples:
  1294.  
  1295.          COMPFILE demo.bat dd2.dat BYDATE
  1296.  
  1297.          Compares the  creation dates of the files demo.bat
  1298.          and dd2.bat.
  1299.  
  1300.  
  1301.  
  1302.  
  1303.                                18
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                                              COMPFILE Command
  1325.                                              ----------------
  1326.  
  1327.            COMPFILE demo.bat dd2.dat BYTIME
  1328.  
  1329.            Compares the creation dates and times of the files
  1330.            demo.bat and dd2.bat.
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.                                  19
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.       CREATE Command
  1391.       --------------
  1392.  
  1393.      
  1394.      
  1395.      Purpose:
  1396.  
  1397.          The CREATE command creates a file.
  1398.      
  1399.      Format:
  1400.      
  1401.          CREATE [d:][path]filename.ext
  1402.      
  1403.      Remarks:
  1404.  
  1405.          The CREATE  command creates  a zero-length (empty)
  1406.          file if the file does not currently exist.
  1407.      
  1408.      Returned exit codes:
  1409.      
  1410.          0     Success
  1411.          1     Already exists
  1412.          2     Can't create
  1413.          9     Command syntax error or invalid parameter
  1414.      
  1415.      Examples:
  1416.  
  1417.          CREATE temp.dat
  1418.  
  1419.          Looks for a file called TEMP.DAT. If the file does
  1420.          not exist, CREATE creates it.
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.                                20
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.                                                CURSOR Command
  1457.                                                --------------
  1458.  
  1459.        
  1460.        
  1461.        Purpose:
  1462.  
  1463.            The CURSOR  command positions  the cursor  on  the
  1464.            screen.
  1465.        
  1466.        Format:
  1467.        
  1468.            CURSOR AT line col
  1469.        
  1470.        Remarks:
  1471.  
  1472.            The  CURSOR   command  moves  the  cursor  to  the
  1473.            specified line and column.
  1474.        
  1475.        Returned exit codes:
  1476.        
  1477.            0     Success
  1478.            9     Command syntax error or invalid parameter
  1479.        
  1480.        Examples:
  1481.  
  1482.            CURSOR AT 2 5
  1483.  
  1484.            Moves the cursor to the fifth column on the second
  1485.            line.
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.                                  21
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.       DISPFILE Command
  1523.       ----------------
  1524.  
  1525.      
  1526.      
  1527.      Purpose:
  1528.  
  1529.          The DISPFILE  command reads  text from a disk file
  1530.          and displays it in a box on the screen.
  1531.      
  1532.      Format:
  1533.      
  1534.          DISPFILE [d:][path]filename.ext [SCREEN n]
  1535.                   [FROM line1 col1] [TO line2 col2]
  1536.                   [BORDER | SINGLE | DOUBLE | EDGE]
  1537.                   [COLORS fg bg | COLOR fg] [NOCLEAR]
  1538.                   [BRIGHT] [BLINK]
  1539.      
  1540.      Remarks:
  1541.  
  1542.          Specify parameters:
  1543.  
  1544.          [SCREEN  n]   to  specify   what  text  is  to  be
  1545.          displayed. The screens are numbered starting at 1.
  1546.          The text  in  the  file  must  be  separated  into
  1547.          "screens" by  lines that  begin  with  two  dollar
  1548.          signs ($$). The default screen number is 1.
  1549.  
  1550.              Note: The  DISPFILE  command  may  not
  1551.              work as  expected if the text contains
  1552.              tab  characters,   or  other   control
  1553.              characters.
  1554.  
  1555.          [FROM line1  col1] to  set  the  screen  line  and
  1556.          column of  the upper-left  corner of  the box. The
  1557.          default is  the upper-left  corner of  the  screen
  1558.          (line 1 and column 1).
  1559.  
  1560.          [TO line2  col2] to set the screen line and column
  1561.          of the  lower-right corner of the box. The default
  1562.          is the  lower-right corner  of the screen (line 25
  1563.          and column 80).
  1564.  
  1565.  
  1566.  
  1567.                                22
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.                                              DISPFILE Command
  1589.                                              ----------------
  1590.  
  1591.            [BORDER] to  draw a  block border  around the box.
  1592.            The border will appear in the foreground color.
  1593.  
  1594.            [SINGLE] to  draw a  single-line border around the
  1595.            box.
  1596.  
  1597.            [DOUBLE] to  draw a  double-line border around the
  1598.            box.
  1599.  
  1600.            [EDGE] to  draw a block border around the box. The
  1601.            border will appear in the background color.
  1602.  
  1603.            [COLORS fg bg] to specify the foreground color and
  1604.            the background  color of  the box (both border and
  1605.            interior).
  1606.  
  1607.                Note:  See section 3.2.1 for a list of
  1608.                the color choices.
  1609.  
  1610.            [COLOR fg] to specify the foreground color.
  1611.  
  1612.            [NOCLEAR] to  prevent clearing the interior of the
  1613.            box (inside  the  border)  before  displaying  the
  1614.            text.
  1615.  
  1616.            [BRIGHT] to specify a bright foreground color.
  1617.  
  1618.            [BLINK] to make the displayed characters blink.
  1619.        
  1620.        Notes:
  1621.  
  1622.            Borders connect  the screen  coordinates given  by
  1623.            the FROM  and TO  parameters. That  is, the border
  1624.            around a  box specifed with the parameters "FROM 4
  1625.            10 TO 20 70", will start on line 4 not line 3.
  1626.        
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.                                  23
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.       DISPFILE Command
  1655.       ----------------
  1656.  
  1657.      Returned exit codes:
  1658.      
  1659.          0     Success
  1660.          9     Command syntax error or invalid parameter
  1661.      
  1662.      Examples:
  1663.  
  1664.          If the file TFILE.TXT contains the following text,
  1665.      
  1666.                Screen 1 line 1
  1667.                Screen 1 line 2
  1668.                Screen 1 line 3
  1669.                $$
  1670.                Screen 2 line 1
  1671.                Screen 2 line 2
  1672.                Third line on Screen 2
  1673.                $$
  1674.  
  1675.          this command,
  1676.  
  1677.          DISPFILE tfile.txt SCREEN 2 FROM 4 4 TO 12 76
  1678.  
  1679.          displays the following text in the box:
  1680.      
  1681.                Screen 2 line 1
  1682.                Screen 2 line 2
  1683.                Third line on Screen 2
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.                                24
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.                                               DISPLAY Command
  1721.                                               ---------------
  1722.  
  1723.        
  1724.        
  1725.        Purpose:
  1726.  
  1727.            The DISPLAY command displays text on a line of the
  1728.            screen.
  1729.        
  1730.        Format:
  1731.        
  1732.            DISPLAY "text" [AT line col | LINE line] [CLEAR]
  1733.                    [COLORS fg bg | COLOR fg] [CENTER]
  1734.                    [NORETURN] [BRIGHT] [BLINK]
  1735.        
  1736.        Remarks:
  1737.  
  1738.            Specify parameters:
  1739.  
  1740.            [AT line  col] to  specify  the  screen  line  and
  1741.            column where the text should be displayed.
  1742.  
  1743.            [LINE line]  to specify the line on which the text
  1744.            should  be   displayed.  The   text  is  displayed
  1745.            starting in column 1 unless the [CENTER] parameter
  1746.            is also specified.
  1747.  
  1748.            [CLEAR] to  clear the  entire line before the text
  1749.            is displayed.
  1750.  
  1751.            [COLORS fg bg] to specify the foreground color and
  1752.            the background color of the text.
  1753.  
  1754.                Note:  See section 3.2.1 for a list of
  1755.                the color choices.
  1756.  
  1757.            [COLOR fg] to specify the foreground color.
  1758.  
  1759.            [CENTER] to center the text on the line.
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.                                  25
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.       DISPLAY Command
  1787.       ---------------
  1788.  
  1789.          [NORETURN] to  leave the  cursor at the end of the
  1790.          text after it is displayed.
  1791.  
  1792.          [BRIGHT] to specify a bright foreground color.
  1793.  
  1794.          [BLINK] to make the displayed characters blink.
  1795.      
  1796.      Notes:
  1797.  
  1798.          If neither  the LINE,  nor the  AT parameters  are
  1799.          specified, the  text is  displayed at  the current
  1800.          cursor position.
  1801.  
  1802.          The quotation  marks are required only if the text
  1803.          contains blanks.  If enclosing quotation marks are
  1804.          used, a quotation mark can be imbedded in the text
  1805.          by inserting  a back-slash  (\) in  front  of  the
  1806.          quotation mark. For example, "He said \"Hello.\"".
  1807.      
  1808.      Returned exit codes:
  1809.      
  1810.          0     Success
  1811.          9     Command syntax error or invalid parameter
  1812.      
  1813.      Examples:
  1814.  
  1815.          DISPLAY "any text" AT 3 10 COLORS 14 1
  1816.  
  1817.          Displays "any  text" on  line 3  at column  10  in
  1818.          yellow on blue.
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.                                26
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.                                               GETCHAR Command
  1853.                                               ---------------
  1854.  
  1855.        
  1856.        
  1857.        Purpose:
  1858.  
  1859.            The GETCHAR  command waits for the user to press a
  1860.            key, and then returns the key's ASCII value.
  1861.        
  1862.        Format:
  1863.        
  1864.            GETCHAR [CHOICES "keys"] [AT line col]
  1865.                    [NOECHO] [CASE]
  1866.        
  1867.        Remarks:
  1868.  
  1869.            Specify parameters:
  1870.  
  1871.            [CHOICES "keys"] to specify which keys to wait for
  1872.            (by default,  GETCHAR  waits  for  any  key).  For
  1873.            example, to wait for the M or K keys, specify:
  1874.        
  1875.                  CHOICES "mk"    or   CHOICES "MK"  , etc.
  1876.  
  1877.            [AT line  col] to  specify where  to position  the
  1878.            cursor while  waiting for  the user  to press  the
  1879.            key. If  the AT  parameter is  not specified,  the
  1880.            cursor position is unchanged.
  1881.  
  1882.            [NOECHO] to  prevent GETCHAR  from displaying  the
  1883.            character equivalent of the key on the screen.
  1884.  
  1885.            [CASE] to  specify that  lowercase  and  uppercase
  1886.            letters are NOT to be treated as equivalent.
  1887.        
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.                                  27
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.       GETCHAR Command
  1919.       ---------------
  1920.  
  1921.      Notes:
  1922.  
  1923.          You can  specify special  keys, such  as the ENTER
  1924.          key, by inserting a back-slash (\) followed by the
  1925.          decimal value  of the  key's  ASCII  value.  ASCII
  1926.          values of 1 to 126 are allowed. For example:
  1927.           
  1928.           Key Name       Insert
  1929.           -----------    ------
  1930.           ENTER          \013
  1931.           ESC            \027
  1932.           TAB            \009
  1933.           BACKSPACE      \008
  1934.  
  1935.          The quotation  marks are required only if the text
  1936.          contains blanks.  If enclosing quotation marks are
  1937.          used, a quotation mark can be imbedded in the text
  1938.          by inserting  a back-slash  (\) in  front  of  the
  1939.          quotation mark. For example, "ab\"cd".
  1940.      
  1941.      Returned exit codes:
  1942.      
  1943.          1-126 ASCII value of key pressed
  1944.          255   Command syntax error or invalid parameter
  1945.      
  1946.      Examples:
  1947.  
  1948.          GETCHAR
  1949.  
  1950.          Waits until the user presses any key.
  1951.  
  1952.          GETCHAR CHOICES "ab\027"
  1953.  
  1954.          Waits until the user presses the A key, the B key,
  1955.          or the ESC key.
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.                                28
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.                                                  SHOW Command
  1985.                                                  ------------
  1986.  
  1987.        
  1988.        
  1989.        Purpose:
  1990.  
  1991.            The SHOW  command displays the current date, time,
  1992.            or day of the week.
  1993.        
  1994.        Format:
  1995.        
  1996.            SHOW {DAY | DATE | TIME | TIME12} [AT line col]
  1997.                 [NORETURN] [COLORS fg bg | COLOR fg]
  1998.                 [BRIGHT] [BLINK]
  1999.        
  2000.        Remarks:
  2001.  
  2002.            Specify parameters:
  2003.  
  2004.            DAY to display the day of the week (e.g., Monday).
  2005.  
  2006.            DATE to display the current date (e.g., 12/01/88).
  2007.  
  2008.            TIME to display the current time in 24-hour format
  2009.            (e.g., 17:15 is 5:15 PM).
  2010.  
  2011.            TIME12 to  display the  current  time  in  12-hour
  2012.            format (e.g., 5:15 is both 5:15 AM and 5:15 PM).
  2013.  
  2014.            [AT line  col] to  specify  the  position  on  the
  2015.            screen where  the information should be displayed.
  2016.            If the  AT parameter is not specified, the text is
  2017.            displayed at the current cursor position.
  2018.  
  2019.            [NORETURN] to  leave the  cursor  after  the  last
  2020.            character displayed.
  2021.        
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.                                  29
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.       SHOW Command
  2051.       ------------
  2052.  
  2053.          [COLORS fg bg] to specify the foreground color and
  2054.          the background color of the displayed text.
  2055.  
  2056.              Note:  See section 3.2.1 for a list of
  2057.              the color choices.
  2058.  
  2059.          [COLOR fg] to specify the foreground color.
  2060.  
  2061.          [BRIGHT] to specify a bright foreground color.
  2062.  
  2063.          [BLINK] to make the displayed characters blink.
  2064.      
  2065.      Notes:
  2066.  
  2067.          If the  AT parameter is not specified, the text is
  2068.          displayed at the current cursor position.
  2069.      
  2070.      Returned exit codes:
  2071.      
  2072.          0     Success
  2073.          9     Command syntax error or invalid parameter
  2074.      
  2075.      Examples:
  2076.  
  2077.          SHOW DATE
  2078.  
  2079.          Displays the  current date  at the  current cursor
  2080.          position.
  2081.  
  2082.          SHOW TIME AT 6 20 COLOR 14
  2083.  
  2084.          Displays the time at line 6 column 20 in yellow on
  2085.          black.
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.                                30
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.                                                 SOUND Command
  2117.                                                 -------------
  2118.  
  2119.        
  2120.        
  2121.        Purpose:
  2122.  
  2123.            The SOUND command sounds a tone (beeps).
  2124.        
  2125.        Format:
  2126.        
  2127.            SOUND [FREQ frequency] [FOR secs]
  2128.        
  2129.        Remarks:
  2130.  
  2131.            Specify parameters:
  2132.  
  2133.            [FREQ frequency]  to specify  the frequency of the
  2134.            tone. The default is 1000.
  2135.  
  2136.            [FOR secs]  to specify the duration of the tone in
  2137.            seconds. The default is 1 second.
  2138.        
  2139.        
  2140.        Returned exit codes:
  2141.        
  2142.            0     Success
  2143.            9     Command syntax error or invalid parameter
  2144.        
  2145.        Examples:
  2146.  
  2147.            SOUND
  2148.  
  2149.            Sounds a 1000 hertz tone for 1 second.
  2150.  
  2151.            SOUND FREQ 3000 FOR 3
  2152.  
  2153.            Sounds a 3000 hertz tone for 3 seconds.
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.                                  31
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.       WAIT Command
  2183.       ------------
  2184.  
  2185.      
  2186.      
  2187.      Purpose:
  2188.  
  2189.          The WAIT command waits for an event.
  2190.      
  2191.      Format:
  2192.      
  2193.          WAIT {ANYKEY | FOR secs | UNTIL time}
  2194.      
  2195.      Remarks:
  2196.  
  2197.          Specify parameters:
  2198.  
  2199.          ANYKEY to wait until the user presses any key.
  2200.  
  2201.          FOR secs  to  wait  until  a  specific  number  of
  2202.          seconds have passed.
  2203.  
  2204.          UNTIL time  to wait  until a specific time of day.
  2205.          The time  must be  specified as  hh:mm in  24-hour
  2206.          time.
  2207.  
  2208.              Note: Both  the hours and minutes must
  2209.              be specified  as 2-digit  numbers. For
  2210.              example, 7  AM is  specified as 07:00,
  2211.              not 7:00.
  2212.      
  2213.      Returned exit codes:
  2214.      
  2215.          0     Success
  2216.          9     Command syntax error or invalid parameter
  2217.      
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.                                32
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.                                                  WAIT Command
  2249.                                                  ------------
  2250.  
  2251.        Examples:
  2252.  
  2253.            WAIT anykey
  2254.  
  2255.            Waits until the user presses any key.
  2256.  
  2257.            WAIT FOR 5
  2258.  
  2259.            Waits for 5 seconds.
  2260.  
  2261.            WAIT UNTIL 13:05
  2262.  
  2263.            Waits until 1:05 PM.
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.                                  33
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.