  -174-




  CHAPTER 6 / CONFIGURATION


  Part of the power of Take Command is its flexibility.  You can
  alter its configuration to match your style of computing.  Most of
  the configuration of Take Command is controlled through a file of
  initialization information with the extension .INI, which is
  discussed in this chapter.  This file is called TCMD.INI in Take
  Command/16, TCMD32.INI in Take Command/32, and TCMDOS2.INI in Take
  Command for OS/2.  (For brevity, we refer to all three files as
  .INI files throughout this manual.)  We also discuss many ways of
  configuring your command processor in other parts of this manual,
  for example:

            *  With aliases you can set default options for internal
               commands and create new commands (see pages 113 and
               206).

            *  With executable extensions you can associate data
               files with the applications you use to open them (see
               page 102).

            *  With the FILECOMPLETION environment variable, and the
               FileCompletion .INI directive (explained below) you
               can customize filename completion to match the
               command you are working with.

            *  With the COLORDIR environment variable and the
               ColorDir .INI directive you can set the colors used
               by the DIR command.

            *  With the SETDOS command (see page 384), you can
               change some aspects of Take Command's operation "on
               the fly."

            *  With command-line options (see the Introduction and
               Installation Guide) you can specify where Take
               Command looks for its startup files and how it
               operates for a specific session.


  Modifying the .INI File

       You can create, add to, and modify the .INI file in 2 ways:
       with the configuration dialogs or the OPTION command, and by
       editing the file with any ASCII editor.

       The configuration dialogs allow you to modify the settings
       that are used most often.  When you exit from the dialogs,
       you can select the Save button to save your changes in the
       .INI file for use in the current session and all future
       sessions, select the OK button to use your changes in the
  -175-



       current session only, or discard the changes you have made by
       selecting the Cancel button.

       When you exit the configuration dialogs, Save saves all
       changes since the last Save, or since the last time you
       started the command processor.  If you start the dialogs and
       exit with OK, changes will not be saved in the .INI file at
       that time.  However, if you use the dialogs later, and exit
       with Save, any earlier changes will automatically be saved in
       the .INI file along with any new changes from your most
       recent use of the dialogs.

       Changes you make in the Startup section of the configuration
       dialogs will only take effect when you restart Take Command.

       The dialogs handle most standard .INI file settings.  The
       Advanced directives, the Key Mapping directives, and a few
       other individual directives noted below do not have
       corresponding fields in the configuration dialogs, and must
       be entered manually.  For more details on the dialogs, see
       page 45.  For details about the OPTION command, which can be
       used to set individual options or to open the dialogs, see
       page 350.

       You can also create, add to, and edit the .INI file
       "manually" with any ASCII text editor.  Take Command reads
       its .INI file when it starts, and configures itself
       accordingly.  The .INI file is not re-read when you change it
       manually.  For manual changes to take effect, you must
       restart Take Command.  If you edit the .INI file manually,
       make sure you save the file in ASCII format.

       Each item that you can include in the .INI file has a default
       value.  You only need to include entries in the file for
       settings that you want to change from their default values.

       The .INI file has several sections.  All of the directives
       described here go into the [TakeCommand] section, which is
       usually first in the file.  You can edit this section
       manually.  Take Command uses the other sections to record
       information you set while you are using it, including its
       window size and position, the font you are using, and the
       buttons you create on the tool bar.  You should use Take
       Command's menu commands to change the settings in these other
       sections of the .INI file instead of editing them directly.


  Using the .INI File

       Some settings in the .INI file are initialized when you
       install Take Command and others (such as window size and
       position) are modified as you use Take Command, so you will
       probably have an .INI file even if you didn't create one
       yourself.  You should not delete this file.
  -176-



       Take Command searches for the .INI file in three places:

            *  If there is an "@d:\path\inifile" option on the
               startup command line, Take Command will use the path
               and file name specified there, and will not look
               elsewhere.  See the Introduction and Installation
               Guide for details about the startup command line.

            *  If there is no .INI file name on the startup command
               line, the search proceeds to the same directory where
               the Take Command program file (TCMD.EXE, TCMD32.EXE,
               or TCMDOS2.EXE) is stored.  This is the "normal"
               location for the .INI file.  Take Command determines
               this directory automatically.

TC16,       *  If the .INI file is not found in the directory where
TC32           the program file is stored, a final check is made in
               the Windows directory.


  .INI File Directives

       Most lines in the .INI file consist of a one-word directive,
       an equal sign [=], and a value.  For example, in the
       following line, the word "History" is the directive and
       "2048" is the value:

            History = 2048

       Any spaces before or after the equal sign are ignored.

       If you have a long string to enter in the .INI file (for
       example, for the ColorDir directive), you must enter it all
       on one line.  Strings cannot be "continued" to a second line.
       Each line may be up to 1023 characters long.

       The format of the value part of a directive line depends on
       the individual directive.  It may be a numeric value, a
       single character, a choice (like "Yes" or "No"), a color
       setting, a key name, a path, a filename, or a text string.
       The value begins with the first non-blank character after the
       equal sign and ends at the end of the line or the beginning
       of a comment.

       Blank lines are ignored in the .INI file and can be used to
       separate groups of directives.  You can place comments in the
       file by beginning a line with a semicolon [;].  You can also
       place comments at the end of any line except one containing a
       text string value.  To do so, enter at least one space or tab
       after the value, a semicolon, and your comment, like this:

            History = 2048      ;set history list size
  -177-



       If you try to place a comment at the end of a string value,
       the comment will become part of the string and will probably
       cause an error.

       If you use the configuration dialogs to modify the .INI file,
       comments on lines modified from within the dialogs will not
       be preserved when the new lines are saved.  To be sure .INI
       file comments are preserved, put them on separate lines in
       the file.

       When Take Command detects an error while processing the .INI
       file, it displays an error message and prompts you before
       processing the remainder of the file.  This allows you to
       note any errors before the startup process continues.  The
       directive in error will retain its previous or default value.

       If you need to test different values for an .INI directive
       without repeatedly editing the .INI file, use the OPTION
       command or see the INIQuery directive on page 180.

       If you want to include the text of one .INI file within
       another (for example, if you have a set of common directives
       used by several JP Software products), see the Include
       directive on page 196.

       The SETDOS command can override several of the .INI file
       directives (see page 384).  For example, the cursor shape
       used by Take Command can be adjusted either with the
       CursorIns and CursorOver directives or the SETDOS /S command.
       The correspondence between SETDOS options and .INI directives
       is noted under each directive below, and under each option of
       the SETDOS command.

       The first section below lists the different types of
       directives.  Subsequent sections list all the individual
       directives, divided by function and then alphabetically by
       directive name.


       Types of Directives

       There are 8 types of directives in the .INI file.  The
       different types of directives are shown in the lists below as
       follows:

            *  Name = nnnn (1234):  This directive takes a numeric
               value which replaces the "nnnn."  The default value
               is shown in parentheses.

            *  Name = c (X):  This directive accepts a single
               character as its value.  The default character is
               shown in parentheses.  You must type in the actual
               character; you cannot use a key name.
  -178-



            *  Name = CHOICE1 | Choice2 | ... :  This directive
               takes a choice value.  The possible choices are
               listed, separated by vertical bars.  The default
               value is shown in all upper case letters in the
               directive description, but in your file any of the
               choices can be entered in upper case or lower case.
               For example, if the choices were shown as "YES | No"
               then "YES" is the default.

            *  Name = Color:  This directive takes a color
               specification.  See page 27 for the format of color
               names.

            *  Name = Key (Default):  This directive takes a key
               specification.  See page 28 for the format of key
               names.

            *  Name = Path:  This directive takes a path
               specification, but not a filename.  The value should
               include both a drive and path (e.g., C:\TCMD) to
               avoid any possible ambiguities.  A trailing backslash
               [\] at the end of the path name is acceptable but not
               required.  Any default path is described in the text.

            *  Name = File:  This directive takes a filename.  We
               recommend that you use a full filename including the
               drive letter and path to avoid any possible
               ambiguities.  Any default filename is described in
               the text.

            *  Name = String:  This directive takes a string in the
               format shown.  The text describes the default value
               and any additional requirements for formatting the
               string correctly.  No comments are allowed.

       Take Command contains a fixed-length area for storing strings
       entered in the .INI file, including file names, paths, and
       other strings.  This area is large and is unlikely to
       overflow; if it does, you will receive an error message.  If
       this occurs, reduce the complexity of your .INI file or
       contact our technical support department for assistance.

       Each directive is listed below with its name, type, and
       default value.  In some cases, no default is shown because
       the default value varies between Take Command/16, Take
       Command/32, and Take Command for OS/2; in these cases, the
       default is described in the text.

*      Directives that are preceded by an asterisk can be set with
       the configuration dialogs or the OPTION command.  We suggest
       you use the dialogs for these directives because of their
       ease of use and because they generally enforce correct syntax
       and values for the option in question.
  -179-



       Initialization Directives

       The directives in this section control how Take Command
       starts and where it looks for its files.

* TC32      ConsoleColumns = nnnn (80); ConsoleRows = nnnn:  These
            directives set the width and height of the screen buffer
            used for the Take Command/32 console window (see your
            Take Command Introduction and Installation Guide or the
            online help for more information on the console window).
            The width range is 80 - 132 columns; the height range is
            25 - 4096 rows.  These directives control the text
            buffer used for the console window, not the actual
            dimensions of the window on your screen.  The window
            dimensions are determined by the operating system, not
            Take Command/32, and may be smaller than the text buffer
            (if they are, scroll bars are provided to allow viewing
            of all text columns).  Due to operating system
            limitations under Windows 95, ConsoleColumns is ignored
            and the window is fixed at 80 columns, and ConsoleRows
            is ignored unless it is set to 25 or 50.

*           DirHistory = nnnn (256): Sets the amount of memory
            allocated to the directory history list in bytes.  The
            allowable range of values is 256 to 32767 bytes.  If you
            use a global directory history list (see page 70), the
            DirHistory value is ignored in all sessions except that
            which first establishes the global list.

  TC32,     DuplicateBugs = Yes | NO:  Tells the Take Command parser
  TCOS2     to duplicate certain well-known bugs in CMD.EXE.  The
            only bug currently replicated is in the IF command (see
            page 312 for details).

* TCOS2     HelpBook = String:  Sets the names of the "books" to be
            loaded when help is invoked with the HELP command or the
            F1 key.  The default is TCMDOS2 which loads only the
            Take Command for OS/2 help; this directive allows you to
            load other help "books" at the same time.  See the Take
            Command for OS/2 Introduction and Installation Guide for
            additional details.

*           HideConsole = YES | No:  Normally Take Command/32 will
            hide the console window after running a DOS or Win32
            console mode program.  If HideConsole is set to No, the
            console window will only be hidden until the first
            character-mode application you run.  After that it
            remains on-screen after a character-mode application.
            This option works on all screens, but is primarily
            intended for large screens where you can resize the
            console and Take Command/32 windows to run side by side.
            See your Take Command Introduction and Installation
            Guide or the online help for more information on the
            console window.
  -180-



*           History = nnnn  (1024):  Sets the amount of memory
            allocated to the command history list in bytes.  The
            allowable range of values is 256 to 32767 bytes.  If you
            use a global history list (see page 63), the History
            value is ignored in all sessions except the session
            which first establishes the global list.

*           IBeamCursor = YES | No:  If set to Yes, Take Command
            will display the standard "I-Beam" cursor in text areas
            of its window.  If IBeamCursor is set to No, an arrow is
            used in all areas of the window (this can be helpful on
            laptop systems where the I-Beam cursor is hard to see).

            INIQuery = Yes | NO:  If set to Yes, a dialog box will
            be displayed before execution of each subsequent line in
            the current .INI file.  This allows you to modify
            certain directives when you start Take Command in order
            to test different configurations.  INIQuery can be reset
            to No at any point in the file.  Normally INIQuery = Yes
            is only used during testing of other .INI file
            directives.

            The dialog displayed when INIQuery = Yes gives you three
            options:

                 Yes     Executes the directive

                 No      Skips the directive

                 Cancel  Executes the directive and all remaining
                         directives in the [TakeCommand] section of
                         the .INI file (i.e., cancels the INIQuery =
                         Yes setting)

* TC16,     LoadAssociations = YES | No:  No prevents Take Command
  TC32      from loading Windows' direct file associations from the
            WIN.INI file (in Take Command/16) or the Windows
            Registry (in Take Command/32) and using them when
            searching for executable files.  The default of Yes
            allows loading of the file associations.  See Windows
            File Associations on page 105 for additional details.

* TC32,     LocalAliases = Yes | NO:  No forces all copies of Take
  TCOS2     Command to share the same alias list.  Yes keeps the
            lists for each shell separate.  See page 214 for more
            details on local and global alias lists.

* TC32,     LocalDirHistory = Yes | NO:  No forces all copies of
  TCOS2     Take Command to share the same directory history.  Yes
            keeps the directory histories for each shell separate.
            See page 70 for more details on local and global
            directory histories.

* TC32,     LocalHistory = Yes | NO:  No forces all copies of Take
  -181-



  TCOS2     Command to share the same history list.  Yes keeps the
            lists for each shell separate.  See page 63 for more
            details on local and global history lists.

*           ScreenBufSize = nnnn (64000):  Sets the size of the
            screen scrollback buffer in bytes.  The allowable range
            is from 16000 to 64000 bytes in Take Command/16, and
            from 16000 to 512000 bytes in Take Command/32 and Take
            Command for OS/2.

*           TCStartPath = Path:  Sets the drive and directory where
            the TCSTART and TCEXIT automatic batch files (if any)
            are located.  See page 121 for details about these batch
            files.

*           TreePath = Path:  Sets the location of JPSTREE.IDX, the
            file used for extended directory searches (see pages 77
            and 79 for information about extended searches).  By
            default, the file is placed in the root directory of
            drive C:.

*           WindowState = STANDARD | Maximize | Minimize | Custom:
            Sets the initial state of the Take Command window.
            Standard puts the window in the default position on the
            Windows desktop, and is the default setting.  Maximize
            maximizes the window; Minimize minimizes it, and Custom
            sets it to the position specified by the WindowX,
            WindowY, WindowWidth, WindowHeight directives.

*           WindowX = nnnn, WindowY = nnnn, WindowWidth = nnnn,
            WindowHeight = nnnn:  These 4 directives set the initial
            size and position of the Take Command window.  The
            measurements are in pixels or pels.  WindowX and WindowY
            refer to the position of the top left corner of the
            window relative to the top left corner of the screen.
            These directives will be ignored unless WindowState is
            set to Custom.


       Configuration Directives

       These directives control the way that Take Command operates.
       Some can be changed with the SETDOS command while Take
       Command is running.  Any corresponding SETDOS command is
       listed in the description of each directive; information on
       SETDOS begins on page 384.

*           AmPm = Yes | NO | Auto:  Yes displays times in 12-hour
            format with a trailing "a" for AM or "p" for PM.  The
            default of No forces a display in 24-hour time format.
            Auto formats the time according to the country code set
            for your system.  AmPm controls the time format used by
            DIR and SELECT, in LOG files, and in the output of the
            TIMER, DATE, and TIME commands.  It has no effect on
  -182-



            %_TIME, %@MAKETIME, the $t and $T options of PROMPT, or
            date and time ranges.

*           ANSI = Yes | No: Sets the initial state of ANSI support.
            Yes enables ANSI string processing in the Take Command
            window.  No disables ANSI strings. The default is No in
            Take Command/16 and Take Command/32, and Yes in Take
            Command for OS/2.

            See page 90 for more information on ANSI support. See
            the ANSI Codes Reference in the Reference section of the
            online help for a reference list of the ANSI sequences
            supported by Take Command.  Also see SETDOS /A, and  the
            _ANSI internal variable on page 144.

*           AppendToDir = Yes | NO:  If set to Yes, a trailing
            backslash [\] will be appended to directory names when
            doing filename completion.  Regardless of the setting of
            this directive, a trailing backslash is always appended
            to a directory name at the beginning of the command line
            to enable automatic directory changes.

*           BatchEcho = YES | No:  Sets the default batch ECHO mode.
            Yes enables echoing of all batch file commands unless
            ECHO is explicitly set off in the batch file.  No
            disables batch file echoing unless ECHO is explicitly
            set on.  Also see SETDOS /V.

*           BeepFreq = nnnn  (440):  Sets the default BEEP command
            frequency in Hz.  This is also the frequency for "error"
            beeps (for example, if you press an illegal key).  To
            disable all error beeps, set this or BeepLength to 0.
            If you do, the BEEP command will still be operable, but
            will not produce sound unless you explicitly specify the
            frequency and duration.

*           BeepLength = nnnn  (2):  Sets the default BEEP length in
            system clock ticks (approximately 1/18 of a second per
            tick).  BeepLength is also the default length for
            "error" beeps (for example, if you press an illegal
            key).

*           CDDWinLeft, CDDWinTop, CDDWinWidth, CDDWinHeight = nnnn:
            These values set the initial position and size of the
            popup window used by extended directory searches (see
            page 79), in characters, including the border.  The
            defaults are 3, 3, 72, and 16, respectively (i.e., a
            window beginning in column 3, row 3, 72 columns wide and
            16 rows high).  The position is relative to the top left
            corner of the screen.  The width and height values
            include the space required for the window border.  The
            window cannot be smaller than than 10 columns wide by 5
            rows high (including the border).  The values you enter
  -183-



            will be adjusted if necessary to keep a minimum-size
            window visible on the screen.

*           CommandSep = c:  This is the character used to separate
            multiple commands on the same line.  The default is the
            caret [^] in Take Command/16, and the ampersand [&] in
            Take Command/32 and Take Command for OS/2.  You cannot
            use any of the redirection characters (| > < ) or any of
            the whitespace characters (space, tab, comma, or equal
            sign).  The command separator is saved by SETLOCAL and
            restored by ENDLOCAL.  Also see SETDOS /C, the %+
            internal variable on page 144, and page 168 for
            information on using compatible command separators for
            two or more products.

TC16,       CUA = YES | No:  With the default setting of "Yes", Take
TC32        Command will use the Common User Access (CUA) standard
            keys for cut and paste:  Ctrl-Del for cut, Ctrl-Ins for
            copy, and Shift-Ins for paste.  If set to "No," Take
            Command will use the Windows non-CUA editing keys:
            Ctrl-X for cut, Ctrl-C for copy, and Ctrl-V for paste.
            Note that if set to "No," these keys will not be
            available for their normal usage (Ctrl-X for the Take
            Command/16 escape character and Ctrl-C for interrupting
            commands or text-mode applications).

*           CursorIns = nnnn  (15):  This is the width of the cursor
            for insert mode during command-line editing and all
            commands which accept line input (DESCRIBE, ESET, etc.).
            The size is a percentage of the total character cell
            size, between 0% and 100%.  Because of the way video
            drivers map the cursor shape, you may not get a smooth
            progression in cursor shapes as CursorIns and CursorOver
            change.  If CursorIns and CursorOver are set to -1, the
            shape won't be modified at all.  If you set them to 0,
            the cursor will be invisible.  You can retrieve the
            current cursor shape values with the %_CI and %_CO
            internal variables (see page 145).  Also see SETDOS /S.

*           CursorOver = nnnn  (100):  This is the width of the
            cursor for overstrike mode during command-line editing
            and all commands which accept line input.  The size is a
            percentage of the total character cell size, between 0%
            and 100%.  Also see SETDOS /S.

*           DecimalChar = . | , | AUTO:  Sets the character used as
            the decimal separator for @EVAL, numeric IF and IFF
            tests, version numbers, and other similar uses.  The
            only valid settings are period [.], comma [,], and Auto
            (the default).  A setting of Auto tells the command
            processor to use the decimal separator associated with
            your current country code.  If you change the decimal
            character you must also adjust the thousands character
  -184-



            (with ThousandsChar, see below) so that the two
            characters are different.  Also see SETDOS /G.

*           DescriptionMax = nnnn (511):  Controls the description
            length limit for DESCRIBE (see page 248).  The allowable
            range is 20 to 511 characters.

* !         DescriptionName = [File | EA]:  Sets Sets the file name
            in which to store file descriptions.  The default file
            name is DESCRIPT.ION.  Use this directive with caution
            because changing the name from the default will make it
            difficult to transfer file descriptions to another
            system.  Also see SETDOS /D.

  TCOS2     If you set DescriptionName = EA, Take Command for OS/2
            will use the ".SUBJECT" extended attribute (EA) for file
            descriptions instead of a separate file.  Note that
            using EAs will slow the DIR and SELECT commands
            noticeably.  On a FAT volume, performance may be
            substantially slower, depending on whether the system
            has cached the extended attributes.

*           Descriptions = YES | No:  Turns description handling on
            or off during the file processing commands COPY, DEL,
            MOVE, and REN.  If set to No, Take Command will not
            update the description file when files are moved,
            copied, deleted or renamed.  Also see SETDOS /D.

*           EditMode = INSERT | Overstrike:  This directive lets you
            start the command-line editor in either insert or
            overstrike mode.  Also see SETDOS /M.

*           Editor  = File:  Specifies the path and filename of the
            program that Take Command will execute when you select
            "Editor" from the Utilities menu.  The default is
            NOTEPAD.EXE for Take Command/16 and Take Command/32, and
            the OS/2 "E" editor for Take Command for OS/2.

*           EscapeChar = c :  Sets the character used to suppress
            the normal meaning of the following character.  The
            default is Ctrl-X in Take Command/16, and a caret [^] in
            Take Command/32 and Take Command for OS/2.  See page 110
            for a description of the escape character and special
            escape sequences.  You cannot use any of the redirection
            characters (|, >, or < ) or the whitespace characters
            (space, tab, comma, or equal sign) as the escape
            character.  The escape character is saved by SETLOCAL
            and restored by ENDLOCAL.  Also see SETDOS /E, the %=
            internal variable on page 143, and page 168 for
            information on using compatible escape characters for
            two or more products.

*           EvalMax = nnnn (8):  Controls the maximum number of
            digits after the decimal point in values returned by
  -185-



            @EVAL (see page 155).  This setting can be overridden
            with the construct @EVAL[expression=x.y].  The allowable
            range is 0 to 8.  Also see SETDOS /F.

*           EvalMin = nnnn (0):  Controls the minimum number of
            digits after the decimal point in values returned by
            @EVAL (see page 155).  The allowable range is 0 to 8.
            EvalMin will be ignored if it is larger than EvalMax.
            This setting can be overridden with the construct
            @EVAL[expression=x.y].  Also see SETDOS /F.

*           ExecWait = Yes | NO:  Controls whether Take Command
            waits for an external program started from the command
            line to complete before redisplaying the prompt.  See
            Waiting for Applications to Finish on page 74 for
            details on the effects of this directive.

*           FileCompletion = cmd1: ext1 ext2 ...; cmd2: ext3 ext4
            ...  Sets the files made available during filename
            completion for selected commands.  The format is the
            same as that used for the FILECOMPLETION environment
            variable.  See page 66 for a detailed explanation of
            selective filename completion.

*           FuzzyCD = 0 | 1 | 2 | 3:  Enables or disables extended
            directory searches, and controls their behavior.  A
            setting of 0 (the default) disables extended searches.
            For complete details on the meaning of the other
            settings see Extended Directory Searches on page 79.

*           HistCopy = Yes | NO:  Controls what happens when you re-
            execute a line from the command history.  If this option
            is set to Yes, the line is appended to the end of the
            history list.  By default, or if this option is set to
            No, the command is not copied..  The original copy of
            the command is always retained at its original position
            in the list, regardless of the setting of HistCopy.  Set
            this option to No if you want to use HistMove = Yes;
            otherwise, the HistCopy setting will override HistMove.

*           HistLogName = File:  Sets the history log file name
            and / or path.  If only a path is given, the default log
            file name (TCMDHLOG, TC32HLOG, OS2HLOG) will be used.
            Using HistLogName does not turn history logging on; you
            must use a LOG /H ON command to do so.

*           HistMin = nnnn  (0):  Sets the minimum command-line size
            to save in the command history list.  Any command line
            whose length is less than this value will not be saved.
            Legal values range from 0, which saves everything, to
            256 in Take Command/16 or 1024 in Take Command/32 or
            Take Command for OS/2, which disables all command
            history saves.
  -186-



*           HistMove = Yes | NO:  If set to Yes, a recalled line is
            moved to the end of the command history.  The difference
            between this directive and HistCopy, above, is that
            HistCopy = Yes copies each recalled line to the end of
            the history but leaves the original in place.  HistMove
            = Yes places the line at the end of history and removes
            the original line.  This directive has no effect if
            HistCopy = Yes.

*           HistWrap = YES | No:  Controls whether the command
            history "wraps" when you reach the top or bottom of the
            list.  The default setting enables wrapping, so the list
            appears "circular".  If HistWrap is set to No, history
            recall will stop at the beginning and end of the list
            rather than wrapping.

*           LogName = File:  Sets the log file name and / or path.
            If only a path is given, the default log file name
            (TCMDLOG, TCMD32LOG, OS2LOG) will be used.  Using
            LogName does not turn logging on; you must use a LOG ON
            command to do so.

*           NoClobber = Yes | NO:  If set to Yes, will prevent
            standard output redirection (see page 84) from
            overwriting an existing file, and will require that the
            output file already exist for append redirection.  Also
            see SETDOS /N.

*           ParameterChar = c:  Sets the character used after a
            percent sign to specify all or all remaining command-
            line arguments in a batch file or alias (e.g., %$ or
            %n$; see pages 118 and 213).  The default is the
            ampersand [&] for Take Command/16 and the dollar sign
            [$] for Take Command/32 and Take Command for OS/2.  The
            parameter character is saved by SETLOCAL and restored by
            ENDLOCAL.  Also see SETDOS /P.  See page 168 for
            information on using compatible parameter characters for
            two or more products.

*           Left, PopupWinTop, PopupWinWidth, PopupWinHeight = nnnn:
            These values set the initial position and size of the
            command-line, directory history, and filename completion
            windows, and most other popup windows (see CDDWinLeft
            etc. for the extended directory search window).  The
            values are in characters, and include the border.  The
            defaults are 40, 1, 36, and 12, respectively (i.e., a
            window beginning in column 40, row 1, 36 columns wide
            and 12 rows high).  The position is relative to the top
            left corner of the Take Command window.  The width and
            height values include the space required for the window
            border.  The window cannot be smaller than than 10
            columns wide by 5 rows high (including the border).  The
            values you enter will be adjusted if necessary to keep a
            minimum-size window visible on the screen.
  -187-



* TC16      ProgmanDDE = Yes | No | AUTO:  Sets the method Take
            Command uses to retrieve group names and data for the
            Apps menu.  If set to Auto, Take Command first tries to
            establish DDE communications with Program Manager (or a
            replacement Windows shell which emulates it).  If the
            DDE link fails, Take Command will try to read the
            Program Manager's .GRP (group) files directly.  If set
            to Yes, Take Command will use DDE and ignore the .GRP
            files.  If set to No, Take Command will read the .GRP
            files and not attempt to use DDE communications.

            If your Windows shell supports Program Manager DDE and
            does not keep the Program Manager .GRP files up to date,
            you may want to set ProgManDDE to Yes to prevent use of
            the .GRP files.

            If your Windows shell does not support Program Manager
            DDE you may find that Take Command's Apps menu takes a
            long time to display, because Take Command must wait to
            see if Program Manager is responding.  In this case, set
            ProgManDDE to No and Take Command will read the Program
            Manager .GRP files immediately, without waiting for a
            DDE response.

            Some Windows shells (for example, HP Dashboard) start
            Program Manager whenever an application attempts to send
            a Program Manager DDE message.  If you have this type of
            shell, you will see Program Manager start when you try
            to use Take Command's Apps menu.  To avoid this side
            effect, set ProgManDDE to No.

* TC32      ProgmanDDE = YES | No:  Controls whether Take
            Command/32, if it is running under Windows NT 3.51 or
            earlier, retrieves group names and data for the Apps
            menu.  If set to Yes, Take Command will establish DDE
            communications with Program Manager and obtain the group
            names.  If set to No, Take Command will not attempt to
            display group names on the Apps menu.  If Take
            Command/32 is running under Windows 95 or Windows NT 4.0
            or later, this setting has no effect.

  TC16      PromptShellExit = Yes | NO:  Controls whether Take
            Command/16 asks for confirmation when exiting when it is
            the Windows shell.  The prompt will appear whether you
            exit Take Command with the EXIT command, by pressing
            Alt-F4, or with the File/Exit menu option.

*           ScreenColumns = nnnn (80):  Sets the number of virtual
            screen columns used by the Take Command window.  If the
            virtual screen width is greater than the physical window
            width, Take Command will display a horizontal scrollbar
            at the bottom of the window.  See page 33 for more
            information on the virtual screen size.
  -188-



*           ScreenRows = nnnn (25):  Sets the initial height of the
            Take Command window.  See page 33 for more information
            on screen size.

*           ScrollLines = nnnn (2):  Sets the number of lines
            displayed before the screen is physically scrolled.
            Take Command will scroll up when output reaches the
            bottom of the window.  Higher values will speed up the
            display of scrolled output but also make it jerky; lower
            values will make scrolling smoother but will slow it
            down.

*           StatusBarOn = YES | No:  Yes enables the status bar when
            Take Command starts.  No disables it.  The status bar
            can be enabled or disabled while Take Command is running
            by using the Options or Setup menu.  The StatusBarOn
            setting is automatically updated to reflect the current
            state of the status bar each time Take Command exits;
            this preserves the status bar state between sessions.

*           StatBarText = nnnn (8):  Sets the point size of the text
            on the status bar.  The allowable range is 4 to 16.

  TCOS2     SwapFilePath = Path:  Sets the path to the OS/2 swap
            file if it is in a non-standard location.  This allows
            Take Command to find the swap file and display
            information about it in the status bar and the output of
            the MEMORY command.

*           SwapScrollKeys = Yes | NO:  Yes switches to 4DOS-style
            keystrokes for manipulating the scrollback buffer.

            If SwapScrollKeys is set to Yes, the Up and Down arrow
            keys will scroll through the command history list and
            the PgUp key will pop up the history window.  The Ctrl-
            Up, Ctrl-Down, Ctrl-PgUp, and Ctrl-PgDn keys will scroll
            the text in the screen buffer.

            If SwapScrollKeys is set to No, these keys will assume
            their default meanings.  The Up and Down arrow keys and
            the PgUp and PgDn keys will scroll the text in the
            screen buffer.  The Ctrl-Up and Ctrl-Down keys will
            scroll through the command history list and the Ctrl-
            PgUp key will pop up the history window.

            For additional details see Scrolling and History
            Keystrokes on page 111.

            Do not set SwapScrollKeys to Yes if you use key mapping
            directives to reassign the scrolling or history keys
            individually.  SwapScrollKeys takes effect before other
            key mappings, and using both methods at the same time
            will be confusing at best.  Setting SwapScrollKeys to
            Yes has essentially the same effect as including the
  -189-



            following individual key mapping directives in the .INI
            file:

                 PrevHistory = Up
                 NextHistory = Down
                 HistWinOpen = PgUp
                 HistWinOpen = PgDn
                 ScrollUp = Ctrl-Up
                 ScrollDown = Ctrl-Down
                 ScrollPgUp = Ctrl-PgUp
                 ScrollPgDn = Ctrl-PgDn

            TabStops = nnnn (8):  Sets the tab stops for Take
            Command's output (including the output from the LIST and
            TYPE commands).  The allowable range is 1 to 32.

* TC16      TCMDTaskList = YES | No:  If set to No, disables the
            internal Take Command task list manager called up by
            Ctrl-Esc within the Take Command window, and uses the
            Windows Task Manager instead.

*           ThousandsChar = . | , | AUTO:  Sets the character used
            as the thousands separator for numeric output.  The only
            valid settings are period [.], comma [,], and Auto (the
            default).  A setting of Auto tells the command processor
            to use the thousands separator associated with your
            current country code.  If you change the thousands
            character you must also adjust the decimal character
            (with DecimalChar, see above) so that the two characters
            are different.  Also see SETDOS /G.

*           ToolBarOn = YES | No:  Yes enables the tool bar when
            Take Command starts.  No disables it.  The tool bar can
            be enabled or disabled while Take Command is running by
            using the Options or Setup menu.  The ToolBarOn setting
            is automatically updated to reflect the current state of
            the tool bar each time Take Command exits; this
            preserves the tool bar state between sessions.

*           ToolBarText = nnnn (8):  Sets the point size of text on
            the tool bar.  The allowable range is 4 to 16.

            UpperCase = Yes | NO:  Yes specifies that file and
            directory names should be displayed in the traditional
            upper-case by internal commands like COPY and DIR.  No
            allows the normal Take Command lower-case style.  This
            directive does not affect the display of filenames on
            drives which support long filenames; see page 14 for
            more details.  Also see SETDOS /U.
  -190-



       Color Directives

       These directives control the colors that Take Command uses
       for its display.  For complete details on color names see
       page 27.

*           ColorDir = ext1 ext2 ...:colora;ext3 ext4 ... :colorb;
            ...:  Sets the directory colors used by DIR.  The format
            is the same as that used for the COLORDIR environment
            variable.  See page 259 for a detailed explanation of
            color-coded directories.

*           InputColors = Color:  Sets the colors used for command-
            line input.  This setting is useful for making your
            input stand out from the normal output.

*           ListColors = Color:  Sets the colors used by the LIST
            command.  If this directive is not used, LIST will use
            the current default colors set by the CLS or COLOR
            command or by the StdColors directive.

*           SelectColors = Color:  Sets the color used by the SELECT
            command.  If this directive is not used, SELECT will use
            the current default colors set by the CLS or COLOR
            command or by the StdColors directive.

*           StdColors = Color:  Sets the standard colors to be used
            when CLS is used without a color specification, and for
            LIST and SELECT if ListColors and SelectColors are not
            used.  Using this directive is similar to placing a
            COLOR command in the TCSTART automatic batch file.


     ##Key Mapping Directives

       These directives allow you to change the keys used for
       command-line editing and other internal functions.  They
       cannot be entered via the configuration dialogs; you must
       enter them manually (see page 174 for details).

       The description of each directive below explains the function
       of the corresponding key.  Using the directive allows you to
       assign a different or additional key to perform the function
       described.  For example, to use function key F3 to invoke the
       HELP facility (normally invoked with F1):

            Help = F3

       Any directive can be used multiple times to assign multiple
       keys to the same function.  For example:

            ListFind = F        ;F does a find in LIST
            ListFind = F4       ;F4 also does a find in LIST
  -191-



    !  Use some care when you reassign keystrokes.  If you assign a
       default key to a different function, it will no longer be
       available for its original use.  For example, if you assign
       F1 to the AddFile directive (a part of filename completion),
       the F1 key will no longer invoke the help system, so you will
       probably want to assign a different key to Help.

       Please read the information on key names beginning on page 28
       before using the key mapping directives.

       Key assignments are processed before looking for keystroke
       aliases.  For example, if you assign Shift-F1 to HELP and
       also assign Shift-F1 to a key alias, the key alias will be
       ignored.

       Assigning a new keystroke for a function does not deassign
       the default keystroke for the same function.  If you want to
       deassign one of the default keys, use the NormalKey directive
       described below or the corresponding directive for keys in
       the other key groups (NormalEditKey, NormalHWinKey, or
       NormalListKey).


       General Input Keys

            This first set of Key Mapping Directives applies to all
            input.  These directives are in effect whenever Take
            Command requests input from the keyboard, including
            during command-line editing and the DESCRIBE, ESET,
            INPUT, LIST, and SELECT commands.  See page 56 for more
            information about command-line editing.

            Backspace = Key  (Bksp):  Deletes the character to the
            left of the cursor.

            BeginLine = Key  (Home):  Moves the cursor to the
            beginning of the line.

            Del = Key  (Del):  Deletes the character at the cursor.

            DelToBeginning = Key (Ctrl-Home):  Deletes from the
            cursor to the start of the line.

            DelToEnd = Key (Ctrl-End):  Deletes from the cursor to
            the end of the line.

            DelWordLeft = Key  (Ctrl-L):  Deletes the word to the
            left of the cursor.

            DelWordRight = Key  (Ctrl-R, Ctrl-Bksp):  Deletes the
            word to the right of the cursor.  See ClearKeyMap on
            page 196 if you need to remove the default mapping of
            Ctrl-Bksp to this function.
  -192-



            Down = Key  (Down):  Scrolls the display down one line
            in LIST; moves the cursor down one line in SELECT and in
            the command-line history, directory history, or %@SELECT
            window.

            EndLine = Key  (End):  Moves the cursor to the end of
            the line.

            EraseLine = Key  (Esc):  Deletes the entire line.

            ExecLine = Key (Enter):  Executes or accepts a line.

            Ins = Key (Ins):  Toggles insert / overstrike mode
            during line editing.

            Left = Key  (Left):  Moves the cursor left one character
            on the input line; scrolls the display left 8 columns in
            LIST; scrolls the display left 4 columns in the command-
            line, directory history, or %@SELECT window.

            NormalKey = Key:  Deassigns a general input key in order
            to disable the usual meaning of the key within Take
            Command and / or make it available for keystroke
            aliases.  This will make the keystroke operate as a
            "normal" key with no special function.  For example:

                 NormalKey = Ctrl-End

            will disable Ctrl-End, which is the standard "delete to
            end of line" key.  Ctrl-End could then be assigned to a
            keystroke alias.  Another key could be assigned the
            "delete to end of line" function with the DelToEnd
            directive (above).

            Right = Key  (Right):  Moves the cursor right one
            character on the input line; scrolls the display right 8
            columns in LIST; scrolls the display right 4 columns in
            the command-line history, directory history, or %@SELECT
            window.

            Up = Key  (Up):  Scrolls the display up one line in
            LIST; moves the cursor up one line in SELECT and in the
            command-line history, directory history, or %@SELECT
            window.

            WordLeft = Key  (Ctrl-Left):  Moves the cursor left one
            word; scrolls the display left 40 columns in LIST.

            WordRight = Key  (Ctrl-Right):  Moves the cursor right
            one word; scrolls the display right 40 columns in LIST.
  -193-



       Command-Line Editing Keys

            The following directives apply only to command-line
            editing.  They are only effective at the Take Command
            prompt.

            AddFile = Key  (Ctrl-Shift-Tab):  Keeps the current
            filename completion entry and inserts the next matching
            name.

            AliasExpand = Key (Ctrl-F):  Expands all aliases in the
            current command line without executing them.

            CommandEscape = Key  (Alt-0255):  Allows direct entry of
            a keystroke that would normally be handled by the
            command line editor (e.g. Tab or Ctrl-D).

            DelHistory = Key  (Ctrl-D):  Deletes the displayed
            history list entry and displays the previous entry.

            EndHistory = Key  (Ctrl-E):  Displays the last entry in
            the history list.

            Help = Key  (F1):  Invokes the HELP facility.

TC32        LFNToggle = Key (Ctrl-A):  Toggles filename completion
            between long filename and short filename modes on LFN
            drives.

            LineToEnd = Key  (Ctrl-Enter):  Copies the current
            command line to the end of the history list, then
            executes it.

            NextFile = Key  (F9, Tab):  Gets the next matching
            filename during filename completion.  See ClearKeyMap on
            page 196 if you need to remove the default mapping of
            Tab to this function.

            NextHistory = Key  (Ctrl-Down):  Recalls the next
            command from the command history.  Also see Scrolling
            and History Keystrokes on page 111 and SwapScrollKeys on
            page 188.

            NormalEditKey = Key:  Deassigns a command-line editing
            key in order to disable the usual meaning of the key
            while editing a command line, and / or make it available
            for keystroke aliases.  For details see the NormalKey
            directive on page 192.

            PopFile = Key  (F7, Ctrl-Tab):  Opens the filename
            completion window.  See ClearKeyMap on page 196 if you
            need to remove the default mapping of Ctrl-Tab to this
            function.
  -194-



            PrevFile = Key  (F8, Shift-Tab):  Gets the previous
            matching filename during filename completion.  See
            ClearKeyMap on page 196 if you need to remove the
            default mapping of Shift-Tab to this function.

            PrevHistory = Key  (Ctrl-Up):  Recalls the previous
            command from the command history.  Also see Scrolling
            and History Keystrokes on page 111 and SwapScrollKeys on
            page 188.

            SaveHistory = Key  (Ctrl-K):  Saves the command line in
            the command history list without executing it.


       Scrollback Buffer Keys

            The following keys are also part of the command line
            editing group.  They are used to manipulate the
            scrollback buffer rather than to edit commands.  For
            additional information see Scrolling and History
            Keystrokes on page 111 and SwapScrollKeys on page 188.
            (To deassign one of the scrollback keys use the
            NormalEditKey directive above.)

            ScrollUp = Key (Up):  Scrolls the Take Command
            scrollback buffer up one line.

            ScrollDown = Key (Down):  Scrolls the Take Command
            scrollback buffer down one line.

            ScrollPgUp = Key (PgUp):  Scrolls the Take Command
            scrollback buffer up one page.

            ScrollPgDn = Key (PgDn):  Scrolls the Take Command
            scrollback buffer down one page.


       Popup Window Keys

            The following directives apply to popup windows,
            including the command history window, the directory
            history window, the filename completion window, the
            extended directory search window, and the @SELECT
            window.

            DirWinOpen = Key (F6):  Opens the directory history
            window while at the command line.

            HistWinOpen = Key (Ctrl-PgUp):  Brings up the history
            window while at the command line.  Also see Scrolling
            and History Keystrokes on page 111 and SwapScrollKeys on
            page 188.
  -195-



            NormalPopupKey = Key:  Deassigns a popup window key in
            order to disable the usual meaning of the key within the
            popup window.  For details see the NormalKey directive
            on page 192.

            PopupWinBegin = Key (Ctrl-PgUp):  Moves to the first
            item in the list when in the popup window.

            PopupWinDel = Key (Ctrl-D):  Deletes a line from within
            the command history or directory history window.

            PopupWinEdit = Key (Ctrl-Enter):  Moves a line from the
            command history or directory history window to the
            prompt for editing.

            PopupWinEnd = Key (Ctrl-PgDn):  Moves to the last item
            in the list when in the popup window.

            PopupWinExec = Key (Enter):  Selects the current item
            and closes the window.


       LIST Keys

            The keys in this group are effective only inside the
            LIST command.

            ListExit = Key (Esc):  Exits from LIST command.

            ListFind = Key (F):  Prompts and searches for a string.

            ListFindReverse = Key (Ctrl-F):  Prompts and searches
            backward for a string.

            ListHex = Key (X):  Toggles hexadecimal display mode.

            ListHighBit = Key (H):  Toggles LIST's "strip high bit"
            option, which can aid in displaying files from certain
            word processors.

            ListInfo = Key (I):  Displays information about the
            current file.

            ListNext = Key (N):  Finds the next matching string.

            ListPrevious = Key (Ctrl-N):  Finds the previous
            matching string.

            ListPrint = Key (P):  Prints the file.

            ListWrap = Key (W):  Toggles LIST's wrap option on and
            off.  The wrap option wraps text at the right margin.
  -196-



            NormalListKey = Key:  Deassigns a LIST key in order to
            disable the usual meaning of the key within LIST.  For
            details see the NormalKey directive on page 192.


     ##Advanced Directives

       These directives are generally used for unusual
       circumstances, or for diagnosing problems.  Most often they
       are not needed in normal use.  They cannot be entered via the
       configuration dialogs; you must enter them manually.

            ClearKeyMap:  Clears all current key mappings.
            ClearKeyMap is a special directive which has no value or
            "=" after it.  Use ClearKeyMap to make one of the keys
            in the default map (Tab, Shift-Tab, Ctrl-Tab, or Ctrl-
            Bksp) available for a keystroke alias.  ClearKeyMap
            should appear before any key mapping directives.  If you
            want to clear some but not all of the default mappings,
            use ClearKeyMap, then recreate the mappings you want to
            retain (e.g., with "NextFile=Tab", etc.).

            Debug = nnnn (0):  Controls certain debugging options
            which can assist you in tracking down unusual problems.
            See the online help for details.

            Include = File:  Include the text from the named file at
            this point in the processing of the current .INI file.
            Use this option to share a file of directives between
            several products.  The text in the named file is
            processed just as if it were part of the original .INI
            file.  When the include file is finished, processing
            resumes at the point where it left off in the original
            file.  The included file may contain any valid directive
            for the current section, but may not contain a section
            name.  Includes may be nested up to three levels deep
            (counting the original file as level 1).  You must
            maintain include files manually -- the configuration
            dialogs modify the original .INI file only, and do not
            update included files.
