home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 010 / jp4add.zip / ADDENDUM.DOC next >
Text File  |  1994-10-12  |  84KB  |  2,079 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                      4DOS (r)
  7.  
  8.                                     Version 5.5
  9.  
  10.  
  11.  
  12.                                      4OS2 (tm)
  13.  
  14.                                     Version 2.5
  15.  
  16.  
  17.  
  18.                                 4DOS for Windows NT
  19.  
  20.                                     Version 2.5
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                   Manual Addendum
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                    Developed By
  34.                               Rex Conn and Tom Rawson
  35.  
  36.                                  Documentation By
  37.                      Hardin Brothers, Tom Rawson, and Rex Conn
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                    Published By
  46.  
  47.                                  JP Software Inc.
  48.                                    P.O. Box 1470
  49.                              East Arlington, MA 02174
  50.                                       U.S.A.
  51.  
  52.                                   (617) 646-3975
  53.                                 fax (617) 646-0904
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                   ACKNOWLEDGMENTS
  60.  
  61.  
  62.              We couldn't produce products like 4DOS, 4OS2, and 4DOS/NT
  63.              without the dedication and quality work of many people.  Our
  64.              thanks to:
  65.  
  66.                   JP Software Staff:  Mike Bessy, Bobby Kelley, Ellen
  67.                   Stone, Marcella Turner, Misty White.
  68.  
  69.                   Online Support:  Brian Miller and Tess Heder of Channel 1
  70.                   BBS; Don Watkins of CompuServe's IBMNET.
  71.  
  72.                   Beta Test Support:  David Moskowitz and the sysops of
  73.                   CompuServe's CONSULT forum.
  74.  
  75.                   Beta Testers:  We can't list all of our beta testers
  76.                   here!  A special thanks to all of you who helped make
  77.                   4DOS, 4OS2, and 4DOS/NT elegant, reliable, and friendly.
  78.  
  79.  
  80.              The following tools are used in creating and maintaining 4DOS,
  81.              4OS2, and 4DOS/NT:
  82.  
  83.                   Compilers:       Microsoft C, Microsoft Macro Assembler,
  84.                                    IBM C-Set/2, Borland Turbo Pascal
  85.                   Libraries:       Spontaneous Assembly (Base Two
  86.                                    Development), Turbo Professional (Turbo
  87.                                    Power Software)
  88.                   Editors:         Edix (Emerging Technology), Brief
  89.                                    (Solution Systems)
  90.                   Debuggers:       Periscope (The Periscope Company), Soft-
  91.                                    ICE (Nu-Mega Technologies)
  92.                   Version Control: PVCS (Sage Software)
  93.                   Documentation:   Microsoft Word for Windows with Adobe
  94.                                    Type Manager
  95.  
  96.  
  97.              Cover Design:  Gordon Design, Medford, MA.
  98.  
  99.  
  100.              Program and Documentation Copyright c 1988 - 1994, JP Software
  101.              Inc., All Rights Reserved.  4DOS is a registered trademark and
  102.              4OS2, JP Software, and the JP Software logo and product logos
  103.              are trademarks of JP Software Inc.  Other product and company
  104.              names are trademarks of their respective owners.
  105.  
  106.                                                                        9-94
  107.                                                                    CONTENTS
  108.         -------------------------------------------------------------------
  109.  
  110.  
  111.  
  112.         CONTENTS
  113.  
  114.         Introduction...............................................1
  115.  
  116.         Introduction and Installation Changes......................2
  117.             Startup................................................2
  118.             External Applications Under 4DOS/NT....................2
  119.  
  120.         General Concepts...........................................3
  121.             Color Names............................................3
  122.             File and Directory Names in Windows NT.................3
  123.  
  124.         Using 4DOS, 4OS2, and 4DOS/NT..............................4
  125.             Command History List...................................4
  126.             Local and Global Directory History.....................4
  127.             WildCards..............................................5
  128.             Date and Time Ranges...................................5
  129.  
  130.         Aliases and Batch Files....................................7
  131.             Batch Files............................................7
  132.             The Environment........................................7
  133.                 Internal Variables.................................7
  134.                 Variable Functions.................................7
  135.  
  136.         .INI File Directives......................................13
  137.             New Initialization Directives.........................13
  138.             New or Changed Configuration Directives...............13
  139.             New Advanced Directive................................14
  140.  
  141.         Command Reference.........................................15
  142.             Enhanced File Selection...............................15
  143.             Enhanced Commands.....................................16                                                             
  144.             ?.....................................................16
  145.             COPY..................................................17
  146.             DIR...................................................17
  147.             DRAWBOX...............................................19
  148.             FFIND.................................................19
  149.             FOR...................................................24
  150.             INKEY.................................................24
  151.             INPUT.................................................25
  152.             KEYSTACK..............................................25
  153.             LIST..................................................26
  154.             LOG...................................................27
  155.             MOVE..................................................27
  156.             PROMPT................................................28
  157.             REBOOT................................................28
  158.             REM...................................................29
  159.             SELECT................................................29
  160.             SETDOS................................................30
  161.  
  162.  
  163.         -------------------------------------------------------------------
  164.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / i
  165.                                                                    CONTENTS
  166.         -------------------------------------------------------------------
  167.  
  168.  
  169.             START.................................................31
  170.             WINDOW................................................32
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  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.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.         -------------------------------------------------------------------
  222.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / ii
  223.                                                                Introduction
  224.         -------------------------------------------------------------------
  225.  
  226.  
  227.  
  228.         Introduction
  229.  
  230.  
  231.         The newest versions of 4DOS, 4OS2, and 4DOS for Windows NT
  232.         incorporate dozens of enhancements and new features.  These changes
  233.         are documented in this Addendum.  With the exception of the
  234.         Introduction and Installation changes on the next page, this manual
  235.         is arranged in the same order as the Reference Manual that is
  236.         shipped with our products.
  237.  
  238.         We include enough information with each new feature so that you can
  239.         understand how it is related to existing features.  For example, if
  240.         a switch has been added to a command, this Addendum shows you the
  241.         revised syntax for the command as a whole, and the specific details
  242.         about the new switch.  In syntax specifications, each new switch is
  243.         also underlined so that you can see quickly what's new.  In each
  244.         case, we also tell you explicitly whether the feature is new or has
  245.         simply been modified since the last version.
  246.  
  247.         Paragraphs marked with one or more product names in the left margin
  248.         apply only to those products.
  249.  
  250.         Most of the changes in this Addendum affect the information in the
  251.         4DOS, 4OS2, and 4DOS/NT Reference Manual.  A few changes affect
  252.         information in the Introduction and Installation Guide for each
  253.         product.  In each case we've provided a page reference for the
  254.         change, so that you can find the original documentation of the same
  255.         topic easily.  The page references look like this:
  256.  
  257.                [RM 101]       Page 101 of the Reference Manual
  258.                [II-4DOS 34]   Page 34 of the 4DOS Introduction and
  259.                               Installation Guide
  260.                [II-4OS2 18]   Page 18 of the 4OS2 Introduction and
  261.                               Installation Guide
  262.                [II-4NT 7]     Page 7 of the 4DOS/NT Introduction and
  263.                               Installation Guide
  264.  
  265.         Page numbers in the text which do not explicitly reference one of
  266.         the other manuals are for pages in this Addendum.
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.         -------------------------------------------------------------------
  280.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 1
  281.                                       Introduction and Installation Changes
  282.         -------------------------------------------------------------------
  283.  
  284.  
  285.  
  286.         Introduction and Installation Changes
  287.  
  288.  
  289.  
  290.         Startup   [II-4DOS 12], [II-4OS2-21], [II-4NT 10]
  291.  
  292.              The command or startup line for 4DOS, 4OS2, and 4DOS for
  293.              Windows NT has been changed slightly to accommodate a new
  294.              feature:  shared directory histories.  Like the alias list and
  295.              the command history, the directory history can now be shared
  296.              globally or maintained privately by each shell or session (see
  297.              page 4).  The new syntax is
  298.  
  299.     4DOS          SHELL=d:\path\4DOS.COM [d:\path] [@d:\path\inifile]
  300.                        [//iniline]... [/D] [/E:nnnn] [/F] [/L] [/LA] [/LD]
  301.                        [/LH] [/Y] [/P[:filename]] [[/K]command]
  302.  
  303.     4OS2          [d:\path] [@d:\path\inifile] [//iniline]... [/L] [/LA]
  304.                        [/LD] [/LH] [/S] [/C | /K] [command]
  305.  
  306.     4NT           [d:\path] [@d:\path\inifile] [//iniline]... [/L] [/LA]
  307.                        [/LD] [/LH] [/Q] [/S] [/C | /K] [command]
  308.  
  309.              /LD is the new option.  It forces the use of a local directory
  310.              history list.  Also, the /L option now forces the use of local
  311.              aliases, a local command history, and a local directory
  312.              history.
  313.  
  314.  
  315.         External Applications Under 4DOS/NT
  316.  
  317.              [This topic was not discussed in the original 4DOS/NT
  318.              Introduction and Installation Guide.]
  319.  
  320.              4DOS for Windows NT will now save the screen buffer size
  321.              before running an external program, and restore it afterward.
  322.              This restores your screen to the proper size even after
  323.              running a DOS application, where Windows NT forces the screen
  324.              size to 80 x 25.  Also see page 32 for changes to the WINDOW
  325.              command which allow you to set the screen buffer size.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.         -------------------------------------------------------------------
  338.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 2
  339.                                                            General Concepts
  340.         -------------------------------------------------------------------
  341.  
  342.  
  343.  
  344.         General Concepts
  345.  
  346.  
  347.  
  348.         Color Names         [RM 25]
  349.  
  350.              You can now specify colors by number as well as by name.  The
  351.              numbers are most useful in potentially long .INI file
  352.              directives like ColorDir.  The following numbers are
  353.              recognized:
  354.  
  355.                   0 - Black            8 - Gray (bright black)
  356.                   1 - Blue             9 - Bright blue
  357.                   2 - Green           10 - Bright green
  358.                   3 - Cyan            11 - Bright cyan
  359.                   4 - Red             12 - Bright red
  360.                   5 - Magenta         13 - Bright magenta
  361.                   6 - Yellow          14 - Bright yellow
  362.                   7 - White           15 - Bright white
  363.  
  364.              Use one number to substitute for the [BRIght] fg portion of
  365.              the color name, and a second to substitute for the [BRIght] bg
  366.              portion.  For example, instead of bright cyan on blue you
  367.              could use 11 on 1 to save space in a ColorDir specification.
  368.  
  369.  
  370.         File and Directory Names in Windows NT  [RM 15-16]
  371.  
  372.     4NT      Beginning with version 3.5, Windows NT supports the use of
  373.              long filenames even on FAT drives.  4DOS/NT will take this
  374.              difference into account automatically under Windows NT 3.5 and
  375.              above.  For example, COPY will retain long filenames if
  376.              possible when copying files to a FAT drive, and DIR will use
  377.              the HPFS / NTFS display format which accommodates long
  378.              filenames on all drives by default.
  379.  
  380.              As a result of this change in Windows NT, 4DOS/NT assumes that
  381.              all file and directory names retain their case under Windows
  382.              NT 3.5 and above, even on FAT drives (normally this assumption
  383.              is made only for HPFS and NTFS drives; see page 15 of the
  384.              Reference Manual for details).  No case conversions are
  385.              performed on file and directory names; all filenames you enter
  386.              for new files are stored on the disk just as you type them,
  387.              and all filenames are displayed just as they are stored on the
  388.              disk, whether in upper, lower, or mixed case.
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.         -------------------------------------------------------------------
  396.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 3
  397.                                               Using 4DOS, 4OS2, and 4DOS/NT
  398.         -------------------------------------------------------------------
  399.  
  400.  
  401.  
  402.         Using 4DOS, 4OS2, and 4DOS/NT
  403.  
  404.  
  405.  
  406.         Command History List     [RM 35]
  407.  
  408.              If you press Ctrl-Enter in the command history list, the
  409.              current command will be copied to the end of the list, even if
  410.              you don't alter it.  You can use Ctrl-Enter to organize the
  411.              history list for repetitive tasks.  Instead of searching
  412.              through the command history for the next command in a
  413.              sequence, you can place all of the necessary commands next to
  414.              each other and make them easier to repeat.
  415.  
  416.  
  417.         Local and Global Directory History [RM 35]
  418.  
  419.              The directory history can now be stored in either a "local" or
  420.              "global" list.
  421.  
  422.              With a local directory history list, any changes made to the
  423.              directory history will only affect the current copy of the
  424.              command processor.  They will not be visible in other shells,
  425.              or other sessions.  A local directory history list is the
  426.              default under 4DOS.
  427.  
  428.              With a global directory history list, all copies of the
  429.              command processor will share the same directory history, and
  430.              any changes made in one copy will affect all other copies.
  431.              Global lists are the default for 4OS2 and 4DOS/NT.
  432.  
  433.              You can control the type of directory history list with the
  434.              LocalDirHistory directive in the .INI file (see page 13), and
  435.              with the /L and /LD options of the START command (see page
  436.              31).  You can control where a global directory history list is
  437.              stored with the UMBDirHistory directive in the .INI file (see
  438.              page 13).
  439.  
  440.              There is no fixed rule for deciding whether to use a local or
  441.              global directory history list.  Depending on your work style,
  442.              you may find it most convenient to use one type, or a mixture
  443.              of types in different sessions or shells.  We recommend that
  444.              you start with the default approach for your command
  445.              processor, then modify it if you find a situation where the
  446.              default is not convenient.
  447.  
  448.     4DOS     If you select a global directory history list for 4DOS running
  449.              under DOS, you can share the list among all copies of 4DOS.
  450.              However, if you run 4DOS under OS/2, global lists will apply
  451.  
  452.  
  453.         -------------------------------------------------------------------
  454.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 4
  455.                                               Using 4DOS, 4OS2, and 4DOS/NT
  456.         -------------------------------------------------------------------
  457.  
  458.  
  459.              within each DOS session, but will not allow you to share the
  460.              history between different DOS sessions.
  461.  
  462.     4OS2, ## If you select a global directory history list for 4OS2 or
  463.     4NT      4DOS/NT, you can share the list among all copies of the
  464.              command processor running in any session.  When you close all
  465.              4OS2 or 4DOS/NT sessions, the memory for the global directory
  466.              history list is released, and a new, empty directory history
  467.              list is created the next time you start 4OS2 or 4DOS/NT.  If
  468.              you want the list to be retained in memory even when no
  469.              command processor session is running, you need to load the
  470.              SHRALIAS program, which performs this service for the global
  471.              history, directory history, and alias lists.  SHRALIAS is
  472.              described in more detail under the ALIAS command on page 162
  473.              of the Reference Manual.
  474.  
  475.              Whenever you start a secondary shell which uses a local
  476.              directory history list, it inherits a copy of the directory
  477.              history from the previous shell.  However, any changes to the
  478.              list made in the secondary shell will affect only that shell.
  479.              If you want changes made in a secondary shell to affect the
  480.              previous shell, use a global directory history list in both
  481.              shells.
  482.  
  483.  
  484.         WildCards [RM 57]
  485.  
  486.              A pair of brackets with no characters between them [], or an
  487.              exclamation point and question mark together [!?], will now
  488.              match only if there is no character in that position.  For
  489.              example,
  490.  
  491.                   [c:\] dir letter[].doc
  492.  
  493.              will not display LETTER1.DOC or LETTERA.DOC, but will display
  494.              LETTER.DOC.  This is most useful for commands like
  495.  
  496.                   [c:\] dir /I"[]" *.btm
  497.  
  498.              which will display a list of all .BTM files which don't have a
  499.              description.
  500.  
  501.  
  502.         Date and Time Ranges     [RM 59]
  503.  
  504.     4OS2,    The HPFS and NTFS file systems maintain three sets of dates
  505.     4NT      and times for each file:  creation, last access, and last
  506.              modification.  By default, date and time ranges work with the
  507.              last modification time stamp.  You can use the "last access"
  508.  
  509.  
  510.  
  511.         -------------------------------------------------------------------
  512.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 5
  513.                                               Using 4DOS, 4OS2, and 4DOS/NT
  514.         -------------------------------------------------------------------
  515.  
  516.  
  517.              (a) or "created" (c) time stamp in a date range with the
  518.              syntax:
  519.  
  520.                   /[da...]  or  /[dc...]  or  /[ta...]  or  /[tc...]
  521.  
  522.              For example, to select files that were last accessed yesterday
  523.              or today:
  524.  
  525.                   /[da-1]
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.         -------------------------------------------------------------------
  570.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 6
  571.                                                     Aliases and Batch Files
  572.         -------------------------------------------------------------------
  573.  
  574.  
  575.  
  576.         Aliases and Batch Files
  577.  
  578.  
  579.  
  580.         Batch Files    [RM 76]
  581.  
  582.              Errors in batch files now display the batch file name and the
  583.              line number where the error occurred.  For example:
  584.  
  585.                   e:\test.bat [3] Invalid parameter "/d"
  586.  
  587.              shows that the error occurred in the third line of the file
  588.              TEST.BAT. The first line of the batch file is numbered 1.
  589.  
  590.  
  591.         The Environment
  592.  
  593.  
  594.              Internal Variables  [RM 96]
  595.  
  596.              The following internal variables are new:
  597.  
  598.              _BATCHLINE is the current line number in the current batch
  599.              file, or "-1" if no batch file is currently being processed.
  600.  
  601.              _BATCHNAME is the full pathname of the current batch file, or
  602.              an empty string if no batch file is currently being processed.
  603.  
  604.              _DNAME is the name of the file used to store file
  605.              descriptions.  It can be changed with the DescriptionName
  606.              directive in the .INI file (see page 14).
  607.  
  608.     4DOS     _DPMI returns the DPMI version number, or "0" if DPMI isn't
  609.              present.
  610.  
  611.              _KBHIT returns "1" if one or more keystrokes are waiting in
  612.              the keyboard buffer, or "0" if the keyboard buffer is empty.
  613.  
  614.     4OS2     _PIPE returns "1" if the current process is running inside a
  615.     4NT      pipe, or "0" if it is not.
  616.  
  617.  
  618.              Variable Functions  [RM 104]
  619.  
  620.              The following variable functions have been added or modified:
  621.  
  622.     4NT      @ALTNAME[filename]:  Returns the alternate (8.3 FAT-format)
  623.              name for the specified file.  Under Windows NT 3.1 this
  624.              function returns a valid name on HPFS and NTFS drives only.
  625.  
  626.  
  627.         -------------------------------------------------------------------
  628.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 7
  629.                                                     Aliases and Batch Files
  630.         -------------------------------------------------------------------
  631.  
  632.  
  633.              Under Windows NT 3.5 and above it works on all drives.  This
  634.              function is new.
  635.  
  636.              @ATTRIB[filename[,nrhsad]]:  [RM 106]  Returns a "1" if the
  637.              specified file has the matching attribute(s); otherwise
  638.              returns a "0".  The attributes are:
  639.  
  640.                   N      Normal (no attributes set)  S    System
  641.                   R      Read-only                   A    Archive
  642.                   H      Hidden                      D    Directory
  643.  
  644.              The attributes (other than N) can be combined (for example
  645.              %@ATTRIB[MYFILE,HS]).  ATTRIB will only return a 1 if all of
  646.              the attributes match.
  647.  
  648.              If you do not specify any attributes, @ATTRIB will return the
  649.              attributes of the specified file in the format RHSAD, rather
  650.              than a "0" or "1".  Attributes which are not set will be
  651.              replaced with an underscore.  For example, if SECURE.DAT has
  652.              the read-only, hidden, and archive attributes set,
  653.              %@ATTRIB[SECURE.DAT] would return "RH_A_" (without the
  654.              quotes).  If the file does not exist, @ATTRIB returns an empty
  655.              string.
  656.  
  657.              @ATTRIB's ability to return the attributes of a specific file
  658.              is new.
  659.  
  660.              @COMMA[n]:  Inserts commas, or the "thousands separator"
  661.              character for your country ID, into a numeric string.  For
  662.              example, @COMMA[1234567] returns "1,234,567" on a system that
  663.              uses U.S. English default settings.  This function is new.
  664.  
  665.              @EVAL[expression]:  [RM 107]  Evaluates an arithmetic
  666.              expression.  @EVAL supports addition (+), subtraction (-),
  667.              multiplication (*), division (/), integer division (\, returns
  668.              the integer part of the quotient), modulo (%%), and integer
  669.              exponentiation (**).  The expression can contain environment
  670.              variables and other variable functions.  @EVAL also supports
  671.              parentheses, commas, and decimals.  Parentheses can be nested.
  672.              @EVAL will strip leading and trailing zeros from the result.
  673.              When evaluating expressions, **, *, /, \, and %% take
  674.              precedence over + and -.  For example, 3 + 4 * 2 will be
  675.              interpreted as 3 + 8, not as 7 * 2.  To change this order of
  676.              evaluation, use parentheses to specify the order you want.
  677.  
  678.              The maximum precision is 16 digits to the left of the decimal
  679.              point and 8 digits to the right of the decimal point.  You can
  680.              alter the default precision to the right of the decimal point
  681.              with the EvalMax and EvalMin .INI file directives (see page
  682.              13) and with the SETDOS /F command (see page 30).
  683.  
  684.  
  685.         -------------------------------------------------------------------
  686.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 8
  687.                                                     Aliases and Batch Files
  688.         -------------------------------------------------------------------
  689.  
  690.  
  691.              You can alter the precision for a single evaluation with the
  692.              construct @EVAL[expression=x.y].  The x value specifies the
  693.              minimum decimal precision (i.e., the minimum number of decimal
  694.              places displayed); the y value sets the maximum decimal
  695.              precision.  If x is greater than y, it is ignored.  You can
  696.              specify either or both arguments, for example:
  697.  
  698.                   @eval[3/7]          returns 0.42857143
  699.                   @eval[3/7=.4]       returns 0.4286
  700.                   @eval[3/6=2.4]      returns 0.50
  701.  
  702.              The ** operator and the capability to set the precision of
  703.              @EVAL is new.
  704.  
  705.              @FILEREAD [n[,length]]:  [RM 108]  Reads a line or a series of
  706.              bytes from the file whose handle is "n."  Returns "**EOF**" if
  707.              you attempt to read past the end of the file.  Be sure to read
  708.              the cautionary note about file functions on page 105 of the
  709.              Reference Manual.  The optional length parameter is new.
  710.  
  711.              @FILES[filename [,-nrhsda]]:  [RM 109]  Returns the number of
  712.              files that match the filename specification, which may contain
  713.              wildcards and include lists. Returns an empty string if no
  714.              files match.  The filename must refer to a single directory;
  715.              to check several directories, use @FILES once for each
  716.              directory, and add the results together with @EVAL. The second
  717.              argument, if included, defines the attributes of the files
  718.              that will be included in the search. The attributes are:
  719.  
  720.                   N      Normal (no attributes set)  S    System
  721.                   R      Read-only                   D    Directory
  722.                   H      Hidden                      A    Archive
  723.  
  724.              The attributes (other than N) can be combined (for example
  725.              %@FILES[*.*,HS]).  @FILES will only find a file if all of the
  726.              attributes match.  You can prefix an attribute with "-" to
  727.              mean "everything except files with this attribute."  The
  728.              optional use of attributes is new.
  729.  
  730.              @FILESEEKL[n,line]:  Moves the file pointer to the specified
  731.              line in the file whose handle is "n".  Returns the new
  732.              position of the pointer, in bytes from the start of the file.
  733.              Be sure to read the cautionary note about file functions on
  734.              page 105 of the Reference Manual.  This function is new.
  735.  
  736.              @FILEWRITEB[n,length,string]:  Writes the specified number of
  737.              bytes from the string to the file whose handle is "n".
  738.              Returns the number of bytes written, or "-1" if an error
  739.              occurred.  Be sure to read the cautionary note about file
  740.  
  741.  
  742.  
  743.         -------------------------------------------------------------------
  744.         Copr. 1994 JP Software Inc.        4DOS, 4OS2, 4DOS/NT Addendum / 9
  745.                                                     Aliases and Batch Files
  746.         -------------------------------------------------------------------
  747.  
  748.  
  749.              functions on page 105 of the Reference Manual.  This function
  750.              is new.
  751.  
  752.     4NT      @FINDCLOSE[filename]:  Signals the end of an @FINDFIRST /
  753.              @FINDNEXT sequence.  You must use this function to release the
  754.              directory search handle.  This function is new.
  755.  
  756.              @FINDFIRST[filename [,-nrhsda]]:  Returns the name of the
  757.              first file that matches the filename, which may contain
  758.              wildcards and "include lists".  The second argument, if
  759.              included, defines the attributes of the files that will be
  760.              included in the search.  Returns an empty string if no files
  761.              match.  The attributes are:
  762.  
  763.                   N      Normal (no attributes set)  S    System
  764.                   R      Read-only                   D    Directory
  765.                   H      Hidden                      A    Archive
  766.  
  767.              The attributes (other than N) can be combined (for example
  768.              %@FINDFIRST[MYFILE,HS]).  @FINDFIRST will only find a file if
  769.              all of the attributes match.  You can prefix an attribute with
  770.              "-" to mean "everything except files with this attribute."
  771.  
  772.     4NT      After @FINDFIRST or the last @FINDNEXT, you must use
  773.              @FINDCLOSE to avoid running out of directory search handles.
  774.  
  775.              The ability to use include lists and the requirement for
  776.              @FINDCLOSE in 4DOS/NT are new.
  777.  
  778.              @FINDNEXT[[filename [,-nrhsda]]]:  Returns the name of the
  779.              next file that matches the filename passed to @FINDFIRST.
  780.              @FINDNEXT should only be used after a successful call to
  781.              @FINDFIRST.  The first argument is included for compatibility
  782.              with previous versions, but is ignored; it can be omitted if
  783.              the second argument is not used (e.g. %@FINDNEXT[]).  The
  784.              second argument, if included, defines the attributes of the
  785.              files that will be included in the search (see @FINDFIRST for
  786.              details).  Returns an empty string when no more files match.
  787.  
  788.     4NT      After the last @FINDNEXT, you must use @FINDCLOSE to avoid
  789.              running out of directory search handles.
  790.  
  791.              The ability to use the filename passed to @FINDFIRST, and the
  792.              requirement for @FINDCLOSE in 4DOS/NT, are new.
  793.  
  794.              @FORMAT[[-][x][.y],string]:  Reformats a string, truncating it
  795.              or padding it with spaces as necessary.  If you use the minus
  796.              [-], the string is left-justified; otherwise, it is right-
  797.              justified.  The x value is the minimum number of characters in
  798.              the result.  The y value is the maximum number of characters
  799.  
  800.  
  801.         -------------------------------------------------------------------
  802.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 10
  803.                                                     Aliases and Batch Files
  804.         -------------------------------------------------------------------
  805.  
  806.  
  807.              in the result.  You can combine the options as necessary.  For
  808.              example:
  809.  
  810.                   %@format[12,JPSoftware]  returns "  JPSoftware"
  811.                   %@format[.3,JPSoftware]  returns "JPS"
  812.  
  813.              @IF[condition,true,false]:  Evaluates the condition and
  814.              returns a string based on the result.  The condition can
  815.              include any of the tests allowed in the IF command (see page
  816.              229 of the Reference Manual).  If the condition is true, @IF
  817.              returns the first result string; if it is false, @IF returns
  818.              the second string.  For example, %IF[2==2,Correct!,Oops!]
  819.              returns "Correct!"  This function is new.
  820.  
  821.              @MAKEAGE[date[,time]]:  Returns the date and time (if
  822.              included) as a single value in the same format as @FILEAGE.
  823.              @MAKEAGE can be used to compare the time stamp of a file with
  824.              a specific date and time, for example:
  825.  
  826.                   if %@fileage[myfile] lt %@makeage[1/1/85] echo OLD!
  827.  
  828.              This function is new.
  829.  
  830.     4OS2     @REXX[expr]:  Calls the REXX interpreter to execute the
  831.              expression.  Returns the result string from REXX; if the REXX
  832.              expression does not return a string, @REXX returns the REXX
  833.              numeric result code.  This function is new.
  834.  
  835.              @TIMER[n]:  Returns the current split time for a timer started
  836.              with the TIMER command (see page 312 of the Reference Manual).
  837.              The value of n specifies the timer to read and can be 1, 2, or
  838.              3.  This function is new.
  839.  
  840.              @WORD[["xxx",]n,string]:  [RM 113]  Returns the "nth" word in
  841.              a string.  The first word is numbered 0.  If n is negative,
  842.              words are returned from the end of the string.  You can use
  843.              the optional first argument, "xxx" to specify the separators
  844.              that you wish to use.  If you want to use a double quote as a
  845.              separator, prefix it with an escape character.  If you don't
  846.              specify a list of separators, @WORD will consider only spaces,
  847.              tabs, and commas as word separators.  If the string argument
  848.              is enclosed in quotation marks, you must enter a list of
  849.              separators.  For example:
  850.  
  851.                   %@word[2,NOW IS THE TIME]     returns "THE"
  852.                   %@word[-0,NOW IS THE TIME]    returns "TIME"
  853.                   %@word[-2,NOW IS THE TIME]    returns "IS"
  854.                   %@word["=",1,2 + 2=4]         returns "4"
  855.  
  856.              The "xxx" list of separators is new.
  857.  
  858.  
  859.         -------------------------------------------------------------------
  860.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 11
  861.                                                     Aliases and Batch Files
  862.         -------------------------------------------------------------------
  863.  
  864.  
  865.              @WORDS[["xxx"],string]:  Returns the number of words in the
  866.              string.  The optional list of delimiters follows the same
  867.              format as @WORD.  If the string argument is enclosed in
  868.              quotation marks, you must enter a list of delimiters. This
  869.              function is new.
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.         -------------------------------------------------------------------
  918.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 12
  919.                                                        .INI File Directives
  920.         -------------------------------------------------------------------
  921.  
  922.  
  923.  
  924.         .INI File Directives
  925.  
  926.  
  927.  
  928.         New Initialization Directives [RM 124]
  929.  
  930.              DirHistory = nnnn (256):  Sets the amount of memory allocated
  931.              to the directory history list in bytes.  The allowable range
  932.              of values is 128 to 2048 bytes. If you use a global directory
  933.              history list (see page 4), the DirHistory value is ignored in
  934.              all shells except the shell which first establishes the global
  935.              list.
  936.  
  937.              LocalDirHistory = Yes | No:  The default value is Yes in 4DOS
  938.              and No in 4OS2 and 4DOS/NT.  No forces all copies of the
  939.              command processor to share the same directory history.  Yes
  940.              keeps the directory histories for each shell separate.  See
  941.              page 4 for additional details on local and global directory
  942.              history.
  943.  
  944.     4DOS     UMBDirHistory= Yes | NO | 1 | 2 ... | 8:  Yes attempts to load
  945.              the global directory history list into a UMB (Upper Memory
  946.              Block).  If you use a specific region number (1 through 8),
  947.              4DOS will attempt to reserve room for the global directory
  948.              history list in that UMB region.  See UMBAlias on page 127 of
  949.              Reference Manual for information on the use of UMBs and region
  950.              numbers. UMBDirHistory will be ignored if a global directory
  951.              history list is not used.
  952.  
  953.  
  954.         New or Changed Configuration Directives [RM 129]
  955.  
  956.              CursorIns and CursorOver:  [RM 130]  Set the cursor shape for
  957.              insert and overstrike mode, respectively.  If either of these
  958.              directives is set to -1, the command processor won't attempt
  959.              to modify the cursor shape at all.  This is a new feature for
  960.              those who have other programs controlling the cursor shape.
  961.  
  962.              DescriptionMax = nnnn (40):  [RM 130]  Controls the
  963.              description length limit for DESCRIBE.  The allowable range is
  964.              20 to 512 characters (the previous maximum value was 200).
  965.  
  966.              EvalMax = nnnn (8):  Controls the maximum number of digits
  967.              after the decimal point in values returned by @EVAL.  This
  968.              setting can be overridden with the construct
  969.              @EVAL[expression=n.n] (see page 8).  The allowable range is 0
  970.              to 8.  Also see SETDOS /F on page 30.
  971.  
  972.  
  973.  
  974.  
  975.         -------------------------------------------------------------------
  976.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 13
  977.                                                        .INI File Directives
  978.         -------------------------------------------------------------------
  979.  
  980.  
  981.              EvalMin = nnnn (0):  Controls the minimum number of digits
  982.              after the decimal point in values returned by @EVAL.  The
  983.              allowable range is 0 to 8.  This directive will be ignored if
  984.              EvalMin is larger than EvalMax.  This setting can be
  985.              overridden with the construct @EVAL[expression=n.n] (see page
  986.              8).  Also see SETDOS /F on page 30.
  987.  
  988.  
  989.         New Advanced Directives       [RM 140]
  990.  
  991.              DescriptionName = File:  Sets the file name in which to store
  992.              file descriptions.  The default file name is DESCRIPT.ION.
  993.              Use this directive with caution because changing the name from
  994.              the default will make it difficult to transfer file
  995.              descriptions to another system.
  996.  
  997.              SDFlush = Yes | NO:  Determines whether 4DOS instructs
  998.              Microsoft SMARTDRV (and other SMARTDRV-compatible disk caching
  999.              programs) to flush any "write-behind" buffers to the disk
  1000.              before the 4DOS prompt is displayed.  Setting SDFlush to Yes
  1001.              may decrease performance, but will ensure that SMARTDRV is
  1002.              instructed to write all modified data to disk before the
  1003.              prompt is displayed.  Also, SDFlush does not take into account
  1004.              any changes in the design or behavior of SMARTDRV after the
  1005.              release of 4DOS, or your SMARTDRV startup options.  Therefore
  1006.              setting SDFlush to Yes does not guarantee that write-behind
  1007.              data will be written to disk before the prompt is displayed,
  1008.              only that SMARTDRV will be instructed to do so.
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.         -------------------------------------------------------------------
  1034.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 14
  1035.                                                           Command Reference
  1036.         -------------------------------------------------------------------
  1037.  
  1038.  
  1039.  
  1040.         Command Reference
  1041.  
  1042.  
  1043.              This version of 4DOS, 4OS2, and 4DOS/NT includes a new
  1044.              command, FFIND, which can search for files by name or by
  1045.              contents.
  1046.  
  1047.              The ATTRIB, COPY, DEL, DESCRIBE, LIST, MOVE, REN, and TYPE
  1048.              commands have a new switch, /A, which improves their file
  1049.              selection abilities.
  1050.  
  1051.              In addition, the ?, COPY, DIR, DRAWBOX, FOR, INKEY, INPUT,
  1052.              KEYSTACK, LIST, LOG, MOVE, PROMPT, REBOOT, SELECT, SETDOS, and
  1053.              WINDOW commands have been enhanced.
  1054.  
  1055.     4NT      The DPATH command is not used in Windows NT, and has been
  1056.              removed from 4DOS/NT.
  1057.  
  1058.              New commands and enhancements are described in this section.
  1059.              We begin with the commands which have the new /A switch and
  1060.              then describe the other commands in alphabetical order.
  1061.  
  1062.  
  1063.         Enhanced File Selection
  1064.  
  1065.              The following commands have a new /A option which allows you
  1066.              to process files based on their attributes (the number at the
  1067.              end of each line shows the corresponding page in the Reference
  1068.              Manual).  The same option has been added to the commands COPY
  1069.                    17             (page   ), LIST (page 26), and MOVE (page 27):
  1070.  
  1071.                ATTRIB [/A[[:][-]rhsda] /D /P /Q /S] [+|-[AHRS]] files ...
  1072.                                                                 [164]
  1073.  
  1074.                DEL [/A[[:][-]rhsda] /F /N /P /Q /S /T /X /Y /Z] file...
  1075.                                                                 [184]
  1076.  
  1077.                DESCRIBE [/A[[:][-]rhsda]] file ["description"] ...  [188]
  1078.  
  1079.                REN [/A[[:][-]rhsda] /N /P /Q /S /T] old_name... new_name
  1080.                                                                 [278]
  1081.  
  1082.                TYPE [/A[[:][-]rhsda] /L /P] file...             [316]
  1083.  
  1084.              The syntax for the /A option is:
  1085.  
  1086.              /A(ttribute select):  Process only those files that have the
  1087.              specified attribute(s) set.  Preceding the attribute character
  1088.  
  1089.  
  1090.  
  1091.         -------------------------------------------------------------------
  1092.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 15
  1093.                                                           Command Reference
  1094.         -------------------------------------------------------------------
  1095.  
  1096.  
  1097.              with a hyphen [-] will select files that do not have that
  1098.              attribute set.  The attributes are:
  1099.  
  1100.                       R    Read-only       D    Subdirectory
  1101.                       H    Hidden          A    Archive
  1102.                       S    System                    
  1103.  
  1104.              If no attributes are listed at all (e.g., TYPE /A), the
  1105.              command will select all files and subdirectories including
  1106.              hidden and system files.  If attributes are combined, all the
  1107.              specified attributes must match for a file to be included in
  1108.              the listing.  For example, /A:RHS will select only those files
  1109.              with all three attributes set.  See page 16 of the Reference
  1110.              Manual for more information on file attributes.
  1111.  
  1112.  
  1113.         Enhanced Commands
  1114.  
  1115.              Each of the following commands has new switches or other new
  1116.              features.  Each is shown with its complete format line, with
  1117.              the new switches, if any, underlined.  The text following the
  1118.              format line explains both the new switches and other changes
  1119.              in the operation of the command.
  1120.  
  1121.              The FFIND command is completely new.
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.         ?                                                     [RM 151]
  1128.  
  1129.         Purpose:    Display a list of internal commands or prompt for a
  1130.                     command.
  1131.  
  1132.         Format:     ? ["prompt text" command]
  1133.  
  1134.                     ? by itself still displays a list of internal
  1135.                     commands.
  1136.  
  1137.                     If you add prompt text and a command, ? will display
  1138.                     the prompt followed by "(Y/N)?" and wait for the
  1139.                     user's response.  If the user presses "Y" or "y", the
  1140.                     command will be executed.  If the user presses "N" or
  1141.                     "n", the command will be ignored.  For example, the
  1142.                     following command might be used in a batch file:
  1143.  
  1144.                          ? "Load the network" call netstart.btm
  1145.  
  1146.  
  1147.  
  1148.  
  1149.         -------------------------------------------------------------------
  1150.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 16
  1151.                                                           Command Reference
  1152.         -------------------------------------------------------------------
  1153.  
  1154.  
  1155.                     This feature is provided for compatibility with Novell
  1156.                     DOS version 7.0 and above, which introduced this use
  1157.                     of the ? command.
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.         COPY                                                  [RM 176]
  1164.  
  1165.         Purpose:    Copy data between disks, directories, files, or
  1166.                     physical hardware devices (such as your printer or
  1167.                     serial port).
  1168.  
  1169.         Format:     COPY [/A:[[-]rhsda] /C /H /M /N /P /Q /R /S /T /U /V]
  1170.                          source[+] ... [/A /B] destination [/A /B]
  1171.  
  1172.                     /A:(ttribute select) works in the same manner as the
  1173.                     /A option explained on page 15 under Enhanced File
  1174.                     Selection.  However, the colon is required when using
  1175.                     /A for attribute selection in COPY, in order to
  1176.                     differentiate this option from the /A(SCII) option
  1177.                     used to copy ASCII text.
  1178.  
  1179.             4NT  ## If you COPY files with long filenames from an NTFS
  1180.                     volume to a FAT volume, 4DOS/NT will now store the
  1181.                     destination files with their short, FAT-compatible
  1182.                     names when running under Windows NT 3.1 (long names
  1183.                     are used under Windows NT 3.5 and above; see page 3
  1184.                     for additional details).  You can view the short names
  1185.                     before executing the COPY with the DIR /X command.
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.         DIR                                                   [RM 191]
  1192.  
  1193.         Purpose:    Display information about files and subdirectories.
  1194.  
  1195.         Format:     DIR [/1 /2 /4 /A[[:][-]rhsda] /B /C[HP] /D /E /F /H
  1196.                          /I"text" /J /K /L /M /N /O[[:][-]acdeginrsu] /P
  1197.                          /R /S /T[:acw] /U /V /W /X /Z] [file...]
  1198.  
  1199.                     There are no new options.
  1200.  
  1201.                     Files and directories are now listed separately in the
  1202.                     summary at the end of the DIR output.
  1203.  
  1204.              4OS2   The /E (upper case) and /L (lower case) options now
  1205.  
  1206.  
  1207.         -------------------------------------------------------------------
  1208.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 17
  1209.                                                           Command Reference
  1210.         -------------------------------------------------------------------
  1211.  
  1212.  
  1213.              4NT    work on HPFS and NTFS drives.  If neither option is
  1214.                     used, the filename will be displayed in the case in
  1215.                     which it is stored on the disk.
  1216.  
  1217.                     The /T (attribute display) option no longer suppresses
  1218.                     file descriptions; instead, descriptions are displayed
  1219.                     to the right of the attributes.  You can combine /T
  1220.                     with /R if you want to avoid the possibility of
  1221.                     descriptions wrapping from one line to the next.
  1222.  
  1223.                     The /T (attribute display) option is incorrectly
  1224.                     documented in the Reference Manual as available only
  1225.                     under 4DOS.  It can be used with 4DOS, 4OS2, and
  1226.                     4DOS/NT.  However, if you want to follow /T (attribute
  1227.                     display) with another switch under 4OS2 or 4DOS/NT,
  1228.                     you must start the next option with a forward slash.
  1229.                     Otherwise, the command processor will assume that you
  1230.                     are using the /T[:acw] (time display) switch.  For
  1231.                     example:
  1232.  
  1233.                          [c:\] dir /tz   incorrect, will display error
  1234.                          [c:\] dir /t/z  correct
  1235.  
  1236.            4NT  ##  DIR's default output format has been changed for
  1237.                     Windows NT 3.5 and above, where long filenames can be
  1238.                     used on on FAT drives (see page 3 for additional
  1239.                     information). DIR now defaults to HPFS / NTFS-style
  1240.                     output, normally selected with /N; you can switch back
  1241.                     to standard FAT-style output with /Z.  DIR also
  1242.                     retains the case in which filenames are stored in
  1243.                     Windows NT 3.5 and above (see page 3 for an
  1244.                     explanation).
  1245.  
  1246.                     You can override the new default output format with an
  1247.                     alias if you wish.  For example, to use FAT-style
  1248.                     output on all drives, define an alias like this:
  1249.  
  1250.                          alias dir=*dir /z
  1251.  
  1252.                     To use FAT-style output on FAT drives only you may
  1253.                     want to try the following alias or a variation on it.
  1254.                     The alias extracts the drive letter from the first
  1255.                     argument to DIR (or uses the current drive if there is
  1256.                     no argument), then changes the display format based on
  1257.                     whether that argument specifies a FAT or non-FAT
  1258.                     drive:
  1259.  
  1260.                          alias dir=`set _drv=%_disk: & if %# != 0 set
  1261.                          _drv=%@fstype[%@substr[%@full[%1],0,2]] & iff
  1262.  
  1263.  
  1264.  
  1265.         -------------------------------------------------------------------
  1266.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 18
  1267.                                                           Command Reference
  1268.         -------------------------------------------------------------------
  1269.  
  1270.  
  1271.                          "%_drv" == "FAT" then & *dir /z %$ & else & *dir
  1272.                          %$ & endiff & unset /q _drv`
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.         DRAWBOX                                               [RM 203]
  1279.  
  1280.         Purpose:    Draw a box on the screen.
  1281.  
  1282.         Format:     DRAWBOX ulrow ulcol lrrow lrcol style [BRIght]
  1283.                     [BLInk] fg ON [BRIght] bg [FILl [BRIght] bgfill]
  1284.                     [ZOOm] [SHAdow]
  1285.  
  1286.                     You can now use BRIght fill colors in DRAWBOX.  All
  1287.                     other options are unchanged.
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.         FFIND                                                    (New)
  1294.  
  1295.         Purpose:    Search for files by name or contents.
  1296.  
  1297.         Format:     FFIND [/A[[:][-]rhsda] /B /C /D[list] /E /K /L /M
  1298.                     /O[[:][-]acdeginrsu] /P /S /T"xx" /V /X"xx"] file...
  1299.  
  1300.                     list:  A list of disk drive letters (without colons).
  1301.                     file:  The file, directory, or list of files or
  1302.                     directories to display.
  1303.  
  1304.                     /A(ttribute select)      /M (no footers)
  1305.                     /B(are)                  /O(rder)
  1306.                     /C(ase sensitive)        /P(ause)
  1307.                     /D(rive)                 /S(ubdirectories)
  1308.                     /E (upper case display)  /T"xx" (text search string)
  1309.                     /K (no headers)          /V(erbose)
  1310.                     /L(ine numbers)          /X["xx"] (hex display/search)
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.         -------------------------------------------------------------------
  1324.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 19
  1325.                                                           Command Reference
  1326.         -------------------------------------------------------------------
  1327.  
  1328.  
  1329.         Selection:  Supports extended wildcards, ranges, multiple file
  1330.                     names, and include lists (see Reference Manual pages
  1331.                     56 - 64).
  1332.  
  1333.         Usage:      FFIND is a flexible search command that looks for
  1334.                     files based on their names and their contents.
  1335.                     Depending on the options you choose, FFIND can display
  1336.                     filenames, matching text, or a combination of both in
  1337.                     a variety of formats.
  1338.  
  1339.                     If you want to search for files by name, FFIND works
  1340.                     much like the DIR command.  For example, to generate a
  1341.                     list of all the .BTM files in the current directory,
  1342.                     you can use the command
  1343.  
  1344.                          c:\> ffind *.btm
  1345.  
  1346.                     The output from this command is a list of full
  1347.                     pathnames, followed by the number of files found.
  1348.  
  1349.                     If you want to limit the output to a list of .BTM
  1350.                     files which contain the string color, you can use this
  1351.                     command instead:
  1352.  
  1353.                          c:\> ffind /t"color" *.btm
  1354.  
  1355.                     The output from this version of FFIND is a list of
  1356.                     files that contain the string color along with the
  1357.                     first line in each file that contains that string.  By
  1358.                     default, FFIND uses a case-insensitive search, so the
  1359.                     command above will include files that contain COLOR,
  1360.                     Color, color, or any other combination of upper-case
  1361.                     and lower-case letters.
  1362.  
  1363.                     You can use extended wildcards in the search string to
  1364.                     increase the flexibility of FFIND's search.  For
  1365.                     example, the following command will find .TXT files
  1366.                     which contain either the string June or July.  (It
  1367.                     will also find Juny and Jule.)  The /C option makes
  1368.                     the search case-sensitive:
  1369.  
  1370.                          c:\> ffind /c/t"Ju[nl][ey]" *.txt
  1371.  
  1372.                     (See pages 57 - 59 of the Reference Manual for more
  1373.                     information on extended wildcards.)
  1374.  
  1375.                     At times, you may need to search for data that cannot
  1376.                     be represented by ASCII characters.  You can use
  1377.                     FFIND's /X option to represent the search string in
  1378.                     hexadecimal format.  With /X, the search must be
  1379.  
  1380.  
  1381.         -------------------------------------------------------------------
  1382.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 20
  1383.                                                           Command Reference
  1384.         -------------------------------------------------------------------
  1385.  
  1386.  
  1387.                     represented by pairs of hexadecimal digits separated
  1388.                     by spaces; a search of this type is always case-
  1389.                     sensitive (41 63 65 is the hex code for "Ace"):
  1390.  
  1391.                          c:\> ffind /x"41 63 65" *.txt
  1392.  
  1393.                     You can use FFIND's other options to further specify
  1394.                     the files for which you are searching and to modify
  1395.                     the way in which the output is displayed.
  1396.  
  1397.              4DOS ##If you are using a disk compression program, you can
  1398.                     sort the display by compression ratios with the /O:c
  1399.                     switch. See APPNOTES.DOC for a list of supported
  1400.                     compression systems.
  1401.  
  1402.         Options:    /A(ttribute select):  Find only those files that have
  1403.                     the specified attribute(s) set.  Preceding the
  1404.                     attribute character with a hyphen [-] will display
  1405.                     files that do not have that attribute set.  The
  1406.                     attributes are:
  1407.  
  1408.                          R    Read-only         D    Subdirectory
  1409.                          H    Hidden            A    Archive
  1410.                          S    System
  1411.  
  1412.                     If no attributes are listed at all (e.g., FFIND /A
  1413.                     ...), FFIND will search all files including hidden and
  1414.                     system files.  If attributes are combined, all the
  1415.                     specified attributes must match for a file to be
  1416.                     included in the search.  For example, /A:RHS will
  1417.                     search only those files with all three attributes set.
  1418.                     See page 16 of the Reference Manual for more
  1419.                     information on file attributes.
  1420.  
  1421.                     /B(are):  Display file names only and omit the text
  1422.                     that matches the search.  This option is only useful
  1423.                     in combination with /T or /X, which normally force
  1424.                     FFIND to display file names and matching text.
  1425.  
  1426.                     /C(ase sensitive):  Perform a case-sensitive search.
  1427.                     This option is only valid with /T, which defaults to a
  1428.                     case-insenitive search.  It is not needed with a /X
  1429.                     hexadecimal search, which is always case-sensitive.
  1430.  
  1431.                     /D(rive):  Search all files on one or more drives.  If
  1432.                     you use /D without a list of drives, FFIND will search
  1433.                     the drives specified in the list of files.  If no
  1434.                     drive letters are listed, FFIND will search the
  1435.                     default drive.  You can include a list of drives or a
  1436.                     range of drives to search as part of the /D option.
  1437.  
  1438.  
  1439.         -------------------------------------------------------------------
  1440.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 21
  1441.                                                           Command Reference
  1442.         -------------------------------------------------------------------
  1443.  
  1444.  
  1445.                     For example, to search drives C:, D:, E:, and G:, you
  1446.                     can use either of these commands:
  1447.  
  1448.                          c:\> ffind /dcdeg ...
  1449.                          c:\> ffind /dc-eg ...
  1450.  
  1451.                     /E (Upper case):  Display matching filenames in upper-
  1452.                     case characters.
  1453.  
  1454.                     /K (No headers):  Suppress the display of the header
  1455.                     or filename for each matching text line.
  1456.  
  1457.                     /L(ine numbers):  Include the line number for each
  1458.                     text line displayed.
  1459.  
  1460.                     /M (No footers):  Suppress the footer (the number of
  1461.                     files and number of matches) at the end of FFIND's
  1462.                     display.
  1463.  
  1464.                     /O(rder)  Set the sort order for the files that FFIND
  1465.                     displays.  You may use any combination of the
  1466.                     following sorting options; if multiple options are
  1467.                     used, the listing will be sorted with the first sort
  1468.                     option as the primary key, the next as the secondary
  1469.                     key, and so on:
  1470.  
  1471.                          -    Reverse the sort order for the next option
  1472.                          a    Sort names and extensions in standard ASCII
  1473.                               order, rather than sorting numerically when
  1474.                               digits are included in the name or
  1475.                               extension.
  1476.              4DOS        c    Sort by compression ratio (the least
  1477.                               compressed file in the list will be
  1478.                               displayed first).
  1479.                          d    Sort by date and time (oldest first).
  1480.                          e    Sort by extension.
  1481.                          g    Group subdirectories first, then files.
  1482.                          i    Sort by the file description (ignored if
  1483.                               /O:c is also used).
  1484.                          n    Sort by filename (this is the default).
  1485.                          r    Reverse the sort order for all options.
  1486.                          s    Sort by size.
  1487.                          u    Unsorted.
  1488.  
  1489.                     /P(ause):  Wait for a key to be pressed after each
  1490.                     screen page before continuing the display.  Your
  1491.                     options at the prompt are explained in detail on page
  1492.                     48 of the Reference Manual.
  1493.  
  1494.  
  1495.  
  1496.  
  1497.         -------------------------------------------------------------------
  1498.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 22
  1499.                                                           Command Reference
  1500.         -------------------------------------------------------------------
  1501.  
  1502.  
  1503.                     /S(ubdirectories):  Display matches from the current
  1504.                     directory and all of its subdirectories.
  1505.  
  1506.                     /T"xx" (text search):  Specify the text search string.
  1507.                     /T must be followed by a text string in double quotes
  1508.                     (e.g., /t"color").  FFIND will perform a case-
  1509.                     insensitive search unless you also use the /C option.
  1510.                     For a hexadecimal search and/or hexadecimal display of
  1511.                     the location where the search string is found, see /X.
  1512.                     You can specify a search string with either /T or /X,
  1513.                     but not both.
  1514.  
  1515.                     /V(erbose):  Show every matching line.  FFIND's
  1516.                     default behavior is to show only the first matching
  1517.                     line and then go on to the next file.  This option is
  1518.                     only valid with /T or /X.
  1519.  
  1520.                     /X["xx"]  (Hexadecimal display / search):  Specify
  1521.                     hexadecimal display and an optional hexadecimal search
  1522.                     string.
  1523.  
  1524.                     If /X is followed by one or more pairs of hexadecimal
  1525.                     digits in quotes (e.g., /x"44 63 65"), FFIND will
  1526.                     search for that exact sequence of characters or data
  1527.                     bytes.  If those bytes are found, the offset is
  1528.                     displayed (also in hexadecimal).  A search of this
  1529.                     type will always be case-sensitive.
  1530.  
  1531.                     If /X is not followed by a hexadecimal search string
  1532.                     it must be used in conjunction with /T, and will
  1533.                     change the output format to display hexadecimal
  1534.                     offsets rather than actual text lines when the search
  1535.                     string is found.  For example, this command uses /T to
  1536.                     display the first line in each .BTM file containing
  1537.                     the word "hello":
  1538.  
  1539.                          c:\>ffind /t"hello" *.btm
  1540.                          ---- c:\test.btm:
  1541.                          echo hello
  1542.  
  1543.                     If you use the same command with /X, the hexadecimal
  1544.                     offset is displayed instead of the text:
  1545.  
  1546.                          c:\>ffind /t"hello" /x *.btm
  1547.                          ---- c:\test.btm:
  1548.                          Offset: 1A
  1549.  
  1550.                     You can specify a search string with either /T or /X,
  1551.                     but not both.
  1552.  
  1553.  
  1554.  
  1555.         -------------------------------------------------------------------
  1556.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 23
  1557.                                                           Command Reference
  1558.         -------------------------------------------------------------------
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.         FOR                                                   [RM 216]
  1565.  
  1566.         Purpose:    Repeat a command for several values of a variable.
  1567.  
  1568.         Format:     FOR [/A[[:][-]rhsda] /D /H] %var IN ([@]set) [DO]
  1569.                     command ...
  1570.  
  1571.                     There are two new options:
  1572.  
  1573.              4DOS ##/D(isable "/"):  Disables the special processing of
  1574.                     the forward slash [/] character in the FOR set.
  1575.                     COMMAND.COM and 4DOS normally treat a forward slash
  1576.                     inside the set as an "escape" character, discard the
  1577.                     slash, and return the character after the slash,
  1578.                     followed by the remainder of the string.  This
  1579.                     behavior can be used in batch files to separate a
  1580.                     string into individual characters (although 4DOS
  1581.                     provides a much easier method with the %@INSTR and
  1582.                     %@SUBSTR variable functions).
  1583.  
  1584.                     The /D option must follow the FOR keyword and come
  1585.                     before the variable name. These examples show the
  1586.                     effects of /D:
  1587.  
  1588.                          c:\> for %s in (/abcdef) do echo %s
  1589.                          a
  1590.                          bcdef
  1591.  
  1592.                          c:\> for /d %s in (/abcdef) do echo %s
  1593.                          /abcdef
  1594.  
  1595.                     /H(ide dots):  Suppress the assignment of the "." and
  1596.                     ".." directories to the var.
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.         INKEY                                                 [RM 236]
  1603.  
  1604.         Purpose:    Get a single keystroke from the user and store it in
  1605.                     an environment variable.
  1606.  
  1607.         Format:     INKEY [/C /D /K"keys" /P /Wn /X] [prompt] %%varname
  1608.  
  1609.                     There are two new options:
  1610.  
  1611.  
  1612.  
  1613.         -------------------------------------------------------------------
  1614.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 24
  1615.                                                           Command Reference
  1616.         -------------------------------------------------------------------
  1617.  
  1618.  
  1619.                     /D(igits only):  Prevents INKEY from accepting any
  1620.                     keystroke except a digit from 0 to 9.
  1621.  
  1622.                     /X (no carriage return):  Prevents INKEY from adding a
  1623.                     carriage return and line feed after the user's entry.
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.         INPUT                                                 [RM 238]
  1630.  
  1631.         Purpose:    Get a string from the keyboard and save it in an
  1632.                     environment variable.
  1633.  
  1634.         Format:     INPUT [/C /D /E /Ln /N /P /Wn /X] [prompt] %%varname
  1635.  
  1636.                     There are three new options:
  1637.  
  1638.                     /D(igits only):  Prevents INPUT from accepting any
  1639.                     keystrokes except digits from 0 to 9.
  1640.  
  1641.                     /N(o colors):  Disables the use of input colors
  1642.                     defined in the InputColor directive in the .INI file.
  1643.                     This switch forces INPUT to use the default display
  1644.                     colors.
  1645.  
  1646.                     /X (no carriage return):  Prevents INPUT from adding a
  1647.                     carriage return and line feed after the user's entry.
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.         KEYSTACK      [4DOS]                                  [RM 242]
  1654.  
  1655.         Purpose:    Feed keystrokes to a program or command automatically.
  1656.  
  1657.         Format:     KEYSTACK [/Wn] ["abc"] [keyname] [!] ...
  1658.  
  1659.                  ## KEYSTACK now mimics the BIOS by stacking both an ASCII
  1660.                     code and a scan code for each key.  It does so by
  1661.                     calculating the scan code for each character entered
  1662.                     as part of a quoted string, as a key name, or as an
  1663.                     ASCII value less than 128.  In previous versions, you
  1664.                     had to do these calculations yourself for programs
  1665.                     which required them.
  1666.  
  1667.                     If you are stacking keys for a program which
  1668.                     distinguishes between keys with the same symbol, like
  1669.  
  1670.  
  1671.         -------------------------------------------------------------------
  1672.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 25
  1673.                                                           Command Reference
  1674.         -------------------------------------------------------------------
  1675.  
  1676.  
  1677.                     the plus on the keyboard and the "gray plus", you will
  1678.                     have to calculate the codes for the keys on the
  1679.                     numeric keypad yourself.  Calculate the value ((256 *
  1680.                     scan code) + ASCII code) and enter that numeric value
  1681.                     as an argument for KEYSTACK.  For example, for the
  1682.                     Enter key on the numeric keypad, the scan code is 224
  1683.                     and the ASCII code is 13, so to stack both values use
  1684.                     ((256 * 224) + 13) or KEYSTACK 57357.  Use this
  1685.                     approach only if you need to differentiate between
  1686.                     different keys with the same keycap symbol or ASCII
  1687.                     code.
  1688.  
  1689.                     See Appendix B in the Reference Manual for a complete
  1690.                     list of ASCII codes and scan codes.
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.         LIST                                                  [RM 248]
  1697.  
  1698.         Purpose:    Display a file, with forward and backward paging and
  1699.                     scrolling.
  1700.  
  1701.         Format:     LIST [/A[[:][-]rhsda] /H /S /W /X] file...
  1702.  
  1703.                     /A(ttribute select) is a new option which works in the
  1704.                     same manner as the /A option explained on page 15
  1705.                     under Enhanced File Selection.
  1706.  
  1707.                     Even if you do not use /A, LIST now displays hidden
  1708.                     and system files by default, as well as normal files.
  1709.  
  1710.                     When LIST is running, you can use one new and one
  1711.                     modified keystroke command:
  1712.  
  1713.                          B       Go back one file to the previous file in
  1714.                                  the current group of files.
  1715.  
  1716.                          G       Go to a specific line or, in hex mode, to
  1717.                                  a specific hexadecimal offset (the use of
  1718.                                  the offset in hex mode is new).
  1719.  
  1720.                     If you print the file which LIST is displaying, you
  1721.                     will now be asked whether you wish to print the entire
  1722.                     file or the current display page.
  1723.  
  1724.                     LIST now supports wildcards in the search string (see
  1725.                     page 57 of the Reference Manual for information on
  1726.                     wildcards).  For example, you can search for the
  1727.  
  1728.  
  1729.         -------------------------------------------------------------------
  1730.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 26
  1731.                                                           Command Reference
  1732.         -------------------------------------------------------------------
  1733.  
  1734.  
  1735.                     string "to*day" to find the next line which contains
  1736.                     the word "to" followed by the word "day" later on the
  1737.                     line, or search for the numbers "101" or "401" with
  1738.                     the search string "[14]01".
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.         LOG                                                   [RM 252]
  1745.  
  1746.         Purpose:    Save a log of commands to a disk file.
  1747.  
  1748.         Format:     LOG [/H /W file] [ON | OFF | text]
  1749.  
  1750.                     Entering LOG or LOG /H with no parameters now displays
  1751.                     the name of the log file in addition to the log status
  1752.                     (ON or OFF):
  1753.  
  1754.                          c:\> log
  1755.                          LOG (C:\4DOSLOG) is OFF
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.         MOVE                                                  [RM 257]
  1762.  
  1763.         Purpose:    Move files to a new directory and drive.
  1764.  
  1765.         Format:     MOVE  [/A[[:][-]rhsda] /C /D /F /H /M /N /P /Q /R /S
  1766.                     /T /U /V] source...  destination
  1767.  
  1768.                     There are three new options:
  1769.  
  1770.                     /A(ttribute select) works in the same manner as the /A
  1771.                     option explained on page 15 under Enhanced File
  1772.                     Selection.
  1773.  
  1774.                     /M(odified files):  Move only files that have the
  1775.                     archive bit set.  The archive bit will remain set
  1776.                     after the MOVE.
  1777.  
  1778.                  ## /V(erify):  Verify each disk write.  This is the same
  1779.                     as executing the VERIFY ON command, but is only active
  1780.                     during the MOVE.  /V does not read back the file and
  1781.                     compare its contents with what was written; it only
  1782.                     verifies that the data written to disk is physically
  1783.                     readable.
  1784.  
  1785.  
  1786.  
  1787.         -------------------------------------------------------------------
  1788.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 27
  1789.                                                           Command Reference
  1790.         -------------------------------------------------------------------
  1791.  
  1792.  
  1793.              4NT  ##If you MOVE files with long filenames from an NTFS
  1794.                     volume to a FAT volume, 4DOS/NT will now store the
  1795.                     destination files with their short, FAT-compatible
  1796.                     names when running under Windows NT 3.1 (long names
  1797.                     are used under Windows NT 3.5 and above; see page 3
  1798.                     for additional details).  You can view the short names
  1799.                     before executing the MOVE with the DIR /X command.
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.         PROMPT                                                [RM 268]
  1806.  
  1807.         Purpose:    Change the command-line prompt.
  1808.  
  1809.         Format:     PROMPT [text]
  1810.  
  1811.                     PROMPT recognizes two new metacharacters:
  1812.  
  1813.                          m    Time in hours and minutes using 24-hour
  1814.                               format (e.g. 16:07).
  1815.                          M    Time in hours and minutes using the default
  1816.                               country format and retaining "a" or "p" if
  1817.                               appropriate for that format (e.g. 4:07p).
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.         REBOOT                                                [RM 275]
  1824.  
  1825.         Purpose:    Do a warm or cold system reboot.
  1826.  
  1827.         Format:     REBOOT [/C /L /S /V]
  1828.  
  1829.                     /C(old reboot)           /S(hutdown)
  1830.                     /L(ogoff)                /V(erify)
  1831.  
  1832.                     There is one new option, for 4DOS/NT:
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.         -------------------------------------------------------------------
  1846.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 28
  1847.                                                           Command Reference
  1848.         -------------------------------------------------------------------
  1849.  
  1850.  
  1851.              4NT    /L(ogoff):  Log off Windows NT, but do not reboot.
  1852.                     This option is equivalent to Logoff choice on the
  1853.                     Program Manager's File menu in Windows NT.
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.         REM                                                   [RM 277]
  1860.  
  1861.         Purpose:    Put a comment in a batch file.
  1862.  
  1863.         Format:     REM [comment]
  1864.  
  1865.                     If you use REM to create a zero-byte file, the
  1866.                     redirection symbol no longer needs to be immediately
  1867.                     adjacent to the command:
  1868.  
  1869.                          c:\> REM>foo
  1870.  
  1871.                     It must, however, be the first character following REM
  1872.                     other than spaces or tabs:
  1873.  
  1874.                          c:\> REM > foo
  1875.  
  1876.                     This change was made to improve compatibility with
  1877.                     COMMAND.COM.
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.         SELECT                                                [RM 283]
  1884.  
  1885.         Purpose:    Interactively select files for a command.
  1886.  
  1887.         Format:     SELECT [/A[:][-]rhsda /C[HP] /D /E /H /I"text"
  1888.                          /O[:][-]acdeginrsu /Z] [command] ...
  1889.                          (files...)...
  1890.  
  1891.                     /H(ide dots) is a new option which suppresses the
  1892.                     display of the "." and ".." directories.
  1893.  
  1894.                     You can now press the L key to view the current
  1895.                     highlighted file with LIST.  When you exit from LIST,
  1896.                     the SELECT screen will be restored.
  1897.  
  1898.                     Also, you can now use the cursor right and cursor left
  1899.                     keys to scroll through file descriptions that are
  1900.                     longer than the screen width.
  1901.  
  1902.  
  1903.         -------------------------------------------------------------------
  1904.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 29
  1905.                                                           Command Reference
  1906.         -------------------------------------------------------------------
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.         SETDOS                                                [RM 292]
  1913.  
  1914.         Purpose:    Display or set the 4DOS, 4OS2, or 4DOS/NT
  1915.                     configuration.
  1916.  
  1917.         Format:     SETDOS [/A? /B? /C? /D /E? /Fn.n /I+|- command /L? /M?
  1918.                          /N?  /P? /R? /S?:? /U? /V? /X[+|-]n /Y]
  1919.  
  1920.                     The /F option is new and the /S option has been
  1921.                     enhanced.
  1922.  
  1923.                     /F(ormat for @EVAL)  [EvalMax, EvalMin]:  The FORMAT
  1924.                     option lets you set default decimal precision for the
  1925.                     @EVAL variable function (see page 8 for information on
  1926.                     @EVAL).  The maximum precision is 16 digits to the
  1927.                     left of the decimal point and up to 8 digits to the
  1928.                     right of the decimal point.  By default, the minimum
  1929.                     precision to the right of the decimal point is 0.
  1930.  
  1931.                     The general form of this option is /Fx.y, where the x
  1932.                     value sets the minimum number of digits to the right
  1933.                     of the decimal place and the y value sets the maximum
  1934.                     number of digits.  Both values can range from 0 to 8;
  1935.                     if x is greater than y, it is ignored.  You can
  1936.                     specify either or both values:  /F2.5, /F2, and /F.5
  1937.                     are all valid entries.  See the @EVAL function if you
  1938.                     want to set the precision for a single computation.
  1939.  
  1940.                     /S(hape) [CursorOver, CursorIns]:  The SHAPE option
  1941.                     sets the cursor shape.  The format is /So:i where o is
  1942.                     the cursor size for overstrike mode, i the cursor size
  1943.                     for insert mode.
  1944.  
  1945.                     If either value is -1, the command processor will not
  1946.                     attempt to modify the cursor shape at all.  You can
  1947.                     use this feature to give another program full control
  1948.                     of the cursor shape.
  1949.  
  1950.                     The ability to disable the command processor's control
  1951.                     of the cursor shape is new.
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.         -------------------------------------------------------------------
  1962.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 30
  1963.                                                           Command Reference
  1964.         -------------------------------------------------------------------
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.         START                                                 [RM 300]
  1971.  
  1972.         Purpose:    Start a program in another session or window.
  1973.  
  1974.         Format:     The format for START depends on which command
  1975.                     processor you are using:
  1976.  
  1977.              4DOS   START ["program title"] [/B[G] /C /DOS[=optfile] /F[G]
  1978.              4OS2   /FS /ICON=iconfile /INV /K /L /LA /LD /LH /MAX /MIN /N
  1979.                     /PGM progname /PM /POS=row,col,width,height /WIN
  1980.                     /WIN3[=optfile] /WIN3S[=optfile]] [command]
  1981.  
  1982.              4NT    START ["program title"] [/B /C /Dpath /HIGH /I
  1983.                     /INV /K /L /LD /LA /LH /LOW /MAX /MIN /NORMAL
  1984.                     /PGM progname /POS=row,col,width,height
  1985.                     /REALTIME /SIZE=rows,cols /SEPARATE /WAIT]
  1986.                     [command]
  1987.  
  1988.                     There are two new options.
  1989.  
  1990.                     /LD (Local Directory List):  Start the command
  1991.                     processor with a local directory history list.  See
  1992.                          4                    page   for information about local and global
  1993.                     directory history.
  1994.  
  1995.              4NT    /SEPARATE (Separate virtual machine):  Start a 16-bit
  1996.                     Windows application in a separate virtual machine
  1997.                     (Windows NT 3.5 and above only).
  1998.  
  1999.                     In addition, the /L option now forces the use of local
  2000.                     aliases, a local command history, and a local
  2001.                     directory history.
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.         -------------------------------------------------------------------
  2020.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 31
  2021.                                                           Command Reference
  2022.         -------------------------------------------------------------------
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.         WINDOW [4OS2, 4DOS/NT]                                [RM 323]
  2029.  
  2030.         Purpose:    Minimize or maximize the current window, set or
  2031.                     restore the default window size, or change the window
  2032.                     title.
  2033.  
  2034.         Format:     WINDOW [MIN | MAX | RESTORE] [/POS=row,col,width,
  2035.                     height] [/SIZE=rows,columns] ["title"]
  2036.  
  2037.                     title:  A new title for the window.
  2038.  
  2039.                     /POS(ition)              /SIZE (of screen buffer)
  2040.  
  2041.                     There is one new option:
  2042.  
  2043.                     /SIZE (of screen buffer):  Specify the screen buffer
  2044.                     size.  The full syntax is /SIZE=rows, columns, where
  2045.                     rows is the number of text rows and columns is the
  2046.                     number of text columns.
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.         -------------------------------------------------------------------
  2078.         Copr. 1994 JP Software Inc.       4DOS, 4OS2, 4DOS/NT Addendum / 32
  2079.