  -31-




  CHAPTER 3 / THE TAKE COMMAND INTERFACE


  This chapter describes Take Command's Windows and OS/2
  Presentation Manager-related features, such as windows, menus,
  dialogs, and the tool bar and status bar.

  Most of the features described in this section are easy to use,
  but a few are more technical in nature.  You may want to skip over
  any menu and dialog options which seem more technical than you
  need at the moment, and come back to them later as you start to
  use them.

  Most of the features documented in this chapter are covered in
  equal or greater detail in the online help, in the section
  entitled "Using the Take Command Interface".  In particular, this
  section includes basic information on most Take Command dialogs,
  but leaves more detailed descriptions dialog fields and behavior
  to the online help system (each Take Command dialog has a Help
  button which will display the corresponding help information).

  If you come across terms or concepts in this chapter that you are
  unsure about, refer to Chapter 1 / General Concepts, the Index, or
  the Glossary in the Take Command online help system.


  The Take Command Window

       The Take Command window has five parts:  the Title Bar, Menu
       Bar, Tool Bar, Command Window, and Status Bar.

       The Title Bar is the same as the one used in most Windows and
       OS/2 applications, with a control menu button on the left and
       the maximize and minimize buttons on the right.  Under
       Windows 95 and Windows NT 4.x or later, there is also a close
       button at the right side of the title bar.  You can change
       the text that appears on the Title Bar, and adjust the size
       of the Take Command window, with the WINDOW command (see page
       424).

       The Menu Bar and all of its menus are explained in detail
       starting on page 36.

       The Tool Bar is used to execute internal or external
       commands, aliases, batch files, and applications with the
       click of a mouse.  You can show or hide the Tool Bar with
       either a menu choice (see page 40) or with a configuration
       option (see page 46).  You can define up to 24 Tool Bar
       buttons.  See page 48 for instructions.

       The Command Window accepts your input and displays Take
       Command's output.  You can use the scroll bars or the Up
       arrow and Down arrow keys to view text that has scrolled
  -32-



       through the window.  You can also save the contents of the
       Command Window and scrollback buffer to a file, restore a
       previous session from a file, copy text from Command Window
       to the clipboard, and copy text from the clipboard or from
       the Command Window to the command line.  See page 35 for
       information about saving and retrieving text in the Command
       Window and page 56 for complete details about using the
       Command Line.

       Finally, the Status Bar at the bottom of the Take Command
       window displays information about your system:

            *  The date and time, based on the Windows or OS/2
               clock.

            *  In Take Command/16 only:

                 The Windows mode (Enh for 386 enhanced mode, or Std
                 for standard mode) and the amount of free virtual
                 memory, in kilobytes.  The amount of memory shown
                 includes virtual memory that Windows creates on
                 disk.

                 The percentages of free GDI (Graphics Device
                 Interface) and User resources.  When either number
                 drops below 25% the corresponding value will turn
                 red.  When resources are this low, Windows may
                 begin to slow down and you may want to shut down
                 some applications.

            *  In Take Command/32 only, the percentage "memory load"
               as reported by Windows 95 or Windows NT.  If you are
               running a CPU monitor program or a program in the
               background that runs while the CPU is idle, the load
               may not be what you expect.  This is due to the
               design of such programs, and is not a problem in Take
               Command.

            *  In Take Command for OS/2 only, the size of the OS/2
               swap file (if you use a non-standard swap file
               location this value will be displayed as 0 unless you
               set the SwapPath directive; see page 188 for
               details).

            *  The state of the Caps Lock key on the keyboard.

            *  The state of the Num Lock key on the keyboard.

       You can show or hide the Status Bar with either a menu choice
       (see page 40) or with a configuration option (see page 46).

       If you use a laptop or LCD screen and find the "I-Beam"
       cursor in the Take Command window difficult to see, disable
       it from the Startup page of the configuration dialogs, or set
  -33-



       IBeamCursor to No in the .INI file (see page 180), to force
       the use of an arrow cursor in all parts of the window.


       Resizing the Take Command Window

       You can resize the Take Command window at any time with
       standard Windows or OS/2 techniques (e.g., by dragging a
       corner with the mouse).  Resizing the window changes the
       number of rows and columns of text which will fit in the
       command window (the actual number of rows and columns for any
       given window size depends on the font you are using).  Take
       Command reacts to these changes using two sets of rules:  one
       for the height and one for the width.

       When the height of the command window changes, future
       commands simply use the new height as you see it on the
       screen.  For example, if you reduce the window to three rows
       high and do a DIR /P (display a directory of files and pause
       at the bottom of each visual "page"), DIR will display two
       lines of output, a prompt ("Press any key to continue ..."),
       and then pause.  If you expand the window to 40 lines high
       and repeat the same command, DIR will display 39 lines, a
       prompt, and then pause.

       However, when the width of the window changes, Take Command
       must check the current "virtual screen width".  The virtual
       width is the maximum number of characters on each line in
       Take Command's internal screen buffer.  You can think of it
       as the width of the data which can be displayed in the Take
       Command window, including an invisible portion to the right
       of the window's right-hand edge.  When the virtual width is
       larger than the actual width, a standard horizontal scroll
       bar is displayed to allow you to see any hidden output.

       The screen height normally starts at 25 lines; you can alter
       this default with the ScreenRows directive in the .INI file
       (see page 188), or the Height setting on the Display page of
       the configuration dialogs.  The _ROWS internal variable (see
       page 147) can be used to determine the current screen height.

       The virtual screen width starts at 80 columns or the number
       of columns which fit into the startup Take Command window,
       whichever is larger.  You can alter the default minimum width
       of 80 columns with the ScreenColumns directive (see page 187)
       in the .INI file, or the Width setting on the Display page of
       the configuration dialogs.  The _COLUMNS internal variable
       (see page 145) can be used to determine the current virtual
       screen width.

       If you use keyboard commands or the mouse to expand the Take
       Command window beyond its previous virtual width, the virtual
       width is automatically increased.  This ensures that the
       internal buffer can hold lines which will fill the newly
  -34-



       enlarged window.  If you contract the window, the virtual
       width is not reduced because this might require removing
       output already on the screen or in the scrollback buffer.

       As a result, widening the window will make future commands
       use the new enlarged size (for example, as the window is
       widened DIR /W, which displays a "wide" directory listing,
       will display additional columns of file names).  However, if
       the window is narrowed future commands will still remember
       the enlarged virtual width, and display data to the right of
       the window edge.  The horizontal scroll bar will make this
       data visible.

       When the font is changed, Take Command will recalculate the
       virtual screen width.  The new virtual width will be the
       width set by the Screen Columns directive or on the Display
       page of the configuration dialogs, or the current width of
       the window in the new font, whichever is larger.


       Using the Scrollback Buffer

       Take Command retains the text displayed on its screen in
       a"scrollback buffer."

       You can scroll through this buffer using the mouse and the
       vertical scroll bar at the right side of the Take Command
       window, just as you can in any Windows or OS/2 application.

       You can also use the Up Arrow and Down Arrow keys to scroll
       the display one line at a time from the keyboard, and the
       PgUp and PgDn keys to scroll one page at a time.

       If you scroll back through the buffer to view previous
       output, and then enter text on the command line, Take Command
       will automatically return to the bottom of the buffer to
       display the text.

       If you prefer to use the Arrow and PgUp keys to access the
       command history (as in 4DOS, 4OS2, and 4NT), see the
       SwapScrollKeys .INI file directive (page 188), or the
       corresponding option on the Command Line 1 page of the
       configuration dialogs (page 46).  SwapScrollKeys switches the
       keystroke mapping so that the Up Arrow, Down Arrow, PgUp, and
       PgDn keys manipulate the command history, and Ctrl-Up Arrow,
       Ctrl-Down Arrow, Ctrl-PgUp, and Ctrl-PgDn are used to control
       the scrollback buffer.  For more details see page 111.

       You can set the size of the scrollback buffer on the Display
       page of the configuration dialogs available from the Options
       menu, or with the ScreenBufSize .INI file directive.

       To clear the entire scrollback buffer, use the CLS /C command
       (see page 231).
  -35-



       Highlighting and Copying Text

       While you are working at the Take Command prompt, you can use
       common Windows or OS/2 keystrokes to edit commands and use
       the clipboard to copy text between Take Command and other
       applications.  You can also select all of the text in the
       Take Command screen buffer by using the Select All command on
       the Edit menu.

       To copy text from the Take Command window to the clipboard,
       first use the mouse to highlight the text, then press Ctrl-
       Ins, or use the Copy command on the Edit menu.

       If you double-click on a word in the Take Command window, the
       entire word is highlighted or selected.  You can also mark
       the text using mouse button 2 (normally, the right mouse
       button); in this case the text will be copied to the
       clipboard immediately when you release the mouse button.

       To highlight text on the command line, use the Shift key in
       conjunction with the Left, Right, Ctrl-Left, Ctrl-Right,
       Home, and End cursor keys.  The Del key will delete any
       highlighted text on the command line, or you can type new
       text to replace the highlighted text.

       While the Take Command window contains text, it is not a
       document window like those used by word processors and other
       similar software, and you cannot move the cursor throughout
       the window as you can in text processing programs.  As a
       result, you cannot use the Windows shortcut keys like Shift-
       Left or Shift-Right to highlight text in the window.  These
       keys work only at the command line; to highlight text
       elsewhere in the window you must use the mouse.

       To copy text from the clipboard to the command line use
       Shift-Ins, or the Paste command on the Edit menu.

       To paste text from elsewhere in the Take Command window
       directly onto the command line, highlight the text with the
       mouse and press Ctrl-Shift-Ins, or use the Copy+Paste command
       on the Edit menu.  This is equivalent to highlighting the
       text and pressing Ctrl-Ins followed by Shift-Ins.  It's a
       convenient way to copy a filename from a previous DIR or
       other command directly to the command line.

TC16,  Some Windows applications support the use of Ctrl-C for Copy,
TC32   Ctrl-X for Cut, and Ctrl-V for Paste.  Take Command uses a
       different set of keystrokes to avoid conflicts with the use
       of Ctrl-C (the "break" keystroke) under DOS, and Ctrl-X (the
       "escape character") under Take Command/16 and 4DOS.  If you
       prefer, you can configure Take Command to use Ctrl-C, Ctrl-X,
       and Ctrl-V for Copy, Cut, and Paste on the Options 1 page of
       the configuration dialogs (see page 45), or with the CUA .INI
       directive (see page 183).
  -36-



       You should use caution when pasting text containing carriage
       return or line feed characters onto the command line.  If the
       text you insert contains one of these characters, the command
       line will be executed just as if you had pressed Enter.  If
       you insert multiple lines, the text will be treated just like
       multiple lines of commands typed at the prompt.


       Using Drag and Drop

       Take Command is compatible with the Windows and OS/2 Drag-
       and-Drop facilities.

       To add a filename to the command line using drag and drop,
       simply drag the file from another application using the mouse
       and release the mouse button with the file icon anywhere
       inside the Take Command window.  The full name of the file
       will be pasted onto the command line at the current cursor
       position.

       Take Command is a drag and drop "client," which means it can
       accept files dragged in from other applications and paste
       their names onto the command line as described above.  It is
       not a drag and drop "server," so you cannot drag filenames
       from the Take Command window into other applications.
       However, you can copy filenames and other text from the Take
       Command screen to other applications using the clipboard; see
       above for details.


  Take Command Menus

       Like most Windows applications, Take Command displays a menu
       bar near the top of its window.  To select a particular menu
       item, click once on the menu heading, or use Alt-x where "x"
       is the underlined letter on the menu bar (for example, Alt-F
       displays the File menu).  You can also select a menu by
       pressing Alt or F10 and then moving the highlight with the
       cursor keys.


       File Menu

            Save to File saves the contents of the Command Window
            and Scrollback Buffer to a file.  A Save As dialog box
            appears in which you can enter the name of the file that
            you wish to use.

            Print sends the contents of the Command Window and
            Scrollback Buffer to the printer.  A Print dialog box
            appears in which you can choose the portion of the
            Screen Buffer you wish to print.

TC16,       Setup Printer displays a standard printer setup dialog
  -37-



TC32        box.  The options available in the dialog box depend on
            the printer driver(s) you are using.

            Refresh redraws everything in the Take Command window
            (use this selection if the display appears incorrect,
            for example if it is not repainted properly after
            another application exits).  You can also press F5 at
            the Take Command prompt to refresh the screen.

       The exit and shutdown choices on this menu vary considerably
       depending on which product you are running.  Take Command/16
       offers two choices:

            Exit Windows shuts down Windows and returns to the DOS
            prompt.

            Restart Windows exits Windows and then automatically
            restarts it.  This option may be useful for checking the
            effects of changes (for example, changes to Windows'
            WIN.INI or SYSTEM.INI files).

       Take Command/32 offers three choices:

            Log Off exits Take Command and logs off the current
            session in Windows NT.  This choice will also restart
            the desktop in Windows 95.

            Shutdown exits Take Command and shuts down Windows NT or
            Windows 95.

            Restart Windows exits Take Command, shuts down Windows
            NT and then reboots the system.  This option only works
            in Windows NT, not in Windows 95.

       Take Command for OS/2 offers only one choice:

            Shutdown shuts down OS/2.

       Finally, all products offer the Exit option:

            Exit ends the current Take Command session.  If Take
            Command/16 is running as the Windows shell, this option
            performs the same action as Exit Windows.


       Edit Menu

            Cut removes text from the Take Command command line and
            moves it to the clipboard.

            Copy copies selected text from the Take Command command
            line or scrollback buffer to the clipboard.
  -38-



            Paste copies text from the clipboard to the Take Command
            command line.  If the text you insert contains a line
            feed or carriage return, the command line will be
            executed just as if you had pressed Enter.  If you
            insert multiple lines, each line will be treated like a
            command typed at the prompt.

            Delete removes text from the Take Command command line.

            Copy + Paste copies the selected text from the Take
            Command scrollback buffer directly to the command line.

            Select All marks the entire contents of the Take Command
            scrollback buffer as selected text.

       To use the Cut, Copy, or Delete commands, you must first
       select a block of text with the mouse, the keyboard, or with
       the Select All command.  If you hold down the mouse button 2
       while you select a block of text, that block will be copied
       to the clipboard automatically when you release the button.

       Note that you can also access the clipboard with redirection
       to or from the CLIP: device (see page 84), or with the @CLIP
       variable function (page 153).


       Apps Menu

            This menu varies significantly between Take Command/16,
            Take Command/32, and Take Command for OS/2.  The only
            common item for all products is Run.  The additional
            choices for each product are listed below.

            Run displays the run dialog box from which you can run
            an application or batch file.  Take Command remembers
            the commands you have run from this dialog in the
            current session.  To select from this list, click on the
            drop-down arrow to the right of the "Command Line" field
            or press the down-arrow.

TC16        DOS Box starts a DOS session by running the default
            command processor.  The DOS session is started using the
            Windows _DEFAULT.PIF file.  To start a DOS session with
            your own PIF (Program Information File) settings, do not
            use this option; instead, enter the name of the
            corresponding .PIF file at the Take Command prompt.

TC16        Task List displays a list of all tasks currently
            running.  When the list is displayed, you can choose to
            switch to a different task, display information about a
            task, or close a task.  You can also close a specific
            window; doing so may also close the associated task
            (depending on how the program whose window you are
            closing was written).
  -39-



TC16        End DOS app in Caveman terminates the DOS program
            currently running under Caveman (see your Introduction
            and Installation Guide), and destroys the Caveman
            virtual machine (the virtual machine will be restarted
            when necessary to run another DOS program).  Work you
            were doing in the application running under Caveman may
            be lost.  Use this option if a DOS program "hangs" and
            does not respond to Ctrl-C or Ctrl-Break.

TC32        Console Session starts a new console (text-mode)
            session, separate from Take Command, by running the
            default character-mode command processor.

TC32        View Console toggles the Take Command console window to
            visible or hidden.  Take Command creates the console
            window to run DOS and 32-bit Windows character-mode
            applications.  Many such applications can be run under
            Take Command/32's Caveman support, and will then display
            their output directly in the Take Command window.  For
            complete details on character-mode applications,
            Caveman, and the console window, see Console
            Applications and the Console Window in the online help
            (under "Using the Take Command Interface"), or your
            Introduction and Installation Guide..  You can also
            control whether the console window remains hidden after
            an application finishes; see the Startup page of the
            configuration dialogs (page 45) or the HideConsole
            directive in TCMD32.INI (page 179).

TCOS2       Go to Desktop minimizes the Take Command for OS/2 window
            and returns control to the OS/2 desktop.

TCOS2       OS/2 Window starts an OS/2 text-mode window (using the
            command processor defined in the SET OS2_SHELL statement
            in CONFIG.SYS).

TCOS2       DOS Window starts a DOS text-mode window (using the
            command processor defined in the SHELL statement in
            CONFIG.SYS).

TCOS2       Win 3.x Window starts a seamless WinOS2 window in 386
            enhanced mode, running your Windows shell (e.g. Program
            Manager or Take Command/16).

TC16,       Group Lists  At the end of the Run Menu, you will see
TC32        the names of the groups defined in your Windows shell
            (Program Manager or a similar program).  If you select a
            group name, a sub-menu will appear with the items in the
            group.  When you click on an item in the sub-menu, it
            will be launched for you.  If the item is set to run
            minimized, Take Command will start it minimized.  (The
            group lists only appear in Take Command/32 if you are
            using Windows NT 3.51 or earlier.)
  -40-



            Take Command collects the group names and the list of
            applications in each group by communicating with the
            Program Manager (or another Windows shell which responds
            to Take Command's request for group information), or by
            reading the Program Manager's .GRP files.  For more
            information or to change the way group names are
            collected see ProgManDDE on page 187.


       Options or Setup Menu

            [This menu is called Options in Take Command/16 and Take
            Command/32, and Setup in Take Command for OS/2.]

            Configure Take Command opens a series of dialogs which
            you can use to change the configuration of Take Command
            (see page 45).

            Configure Tool Bar opens a dialog in which you can
            define up to 24 buttons for the Take Command tool bar
            (see page 48).

TC32        Configure Caveman Apps opens a dialog in which you can
            specify character-mode applications to run under Take
            Command/32's "Caveman" feature, which allows character-
            mode applications to run in the Take Command window.
            See page 50 for details on this dialog.  See the online
            help or your Introduction and Installation Guide for
            more information on Caveman.

TCOS2       Configure TTY Apps opens a dialog in which you can
            specify character-mode DOS and OS/2 applications to run
            under Take Command for OS/2's TTY application support.
            See page 50 for details on this dialog.  For complete
            details on TTY applications and the use of the TTY
            Applications dialog see Starting Character-Mode
            Applications in the online help (under "Using the Take
            Command Interface"), and its subsidiary topics, which
            discuss TTY applications in detail.  TTY application
            support is also discussed in the Introduction and
            Installation Guide.

            Select Font opens a dialog box from which you can select
            the font and type size for the Take Command window.  You
            can choose from any monospaced font that has been
            properly installed in Windows or OS/2.  (A monospaced
            font is one which uses the same fixed width for all
            characters, rather than varying the width based on each
            character's shape.)  When you change the font,
            everything in the command window is displayed in the new
            font; you cannot mix fonts.

TCOS2       In Take Command for OS/2 the font selection menu item is
            entitled Font, and leads to a submenu which allows you
  -41-



            to choose the font for the command window, tool bar, or
            status bar.  The command window is restricted to
            monospaced fonts as described in the preceding
            paragraph, but the tool bar and status bar can use any
            installed font.

         !  Caution:  Some fonts will not display all of the
            characters used by Take Command.  In particular the
            DRAWBOX, DRAWHLINE, and DRAWVLINE commands use line-
            drawing characters which are not included in many
            standard fonts.  To ensure that these commands work
            properly, use the "Terminal" font in Windows or the
            "System VIO" font in OS/2, both of which typically
            include line-drawing characters.

            You can experiment with different fonts by using DRAWBOX
            or a similar command to display line drawing characters
            in the command window.  Then use Select Font to choose a
            different font.  When you leave the dialog, the new font
            will be used to display the entire command window,
            including the line drawing characters.  You can select
            different fonts until you find one that satisfies you.

            Logging controls logging via a submenu with two choices
            (see the LOG command on page 336 for more details on
            logging):

                 Command:  Enables or disables command logging using
                 the default log file (TCMDLOG in Take Command/16,
                 TC32LOG in Take Command/32, or OS2LOG in Take
                 Command for OS/2) or the file you have chosen with
                 the LOG command or the LogName directive in the
                 .INI file.

                 History:  Enables or disables command history
                 logging using the default log file (TCMDHLOG in
                 Take Command/16, TC32HLOG in Take Command/32, or
                 OS2HLOG in Take Command for OS/2) or the file you
                 have chosen with the LOG /H command or the
                 HistLogName directive in the .INI file.

            Show Tool Bar enables or disables the Take Command tool
            bar (see page 48), which appears near the top of the
            Take Command window.  The tool bar will not appear until
            you have defined at least one item for it with Configure
            Tool Bar, above.

            Show Status Bar enables or disables the Take Command
            status bar, which appears near the bottom of the Take
            Command window.

TC16        VM Setup sets the parameters for the Caveman "Virtual
            Machine" used to run DOS applications from Take Command.
            This option is only available if Caveman is enabled.
  -42-



            For additional details on Caveman see your Take
            Command/16 Introduction and Installation Guide.


       Utilities Menu

            Find Files/Text opens the Find Files Dialog Box which
            lets you search for files or text interactively (see
            FFIND on page 287 to search from the command line).

            Once Take Command has created a list of files based on
            your specifications, you can double-click on a file name
            and Take Command will display an information box about
            the file.  From the information box, you can choose to
            list, edit, or run the file.

            Descriptions opens an edit window in which you can view
            and change the descriptions of files in any directory
            available on your system.  See DESCRIBE (page 248) for
            details on file descriptions.

            Aliases opens an edit window in which you can view and
            change the list of current aliases (see page 113 for
            more details on aliases).  You can also use this window
            to import aliases from a file or save all current
            aliases in a file.  Any changes you make will take
            effect as soon as you close the Aliases window.

            Environment opens an edit window in which you can view
            and change the current environment.  Any changes you
            make will be immediately recorded in Take Command's
            environment.

            Editor starts the Windows Notepad editor, the OS/2 "E"
            editor, or any other editor you have specified with the
            Editor directive in the .INI file or on the Commands
            page of the configuration dialogs.

TC16        Recorder starts the Windows Recorder to create keystroke
            macros.


       Help Menu

            Contents displays the Table of Contents for Take Command
            Help.

            How to Use Help displays the standard text that explains
            the Windows or OS/2 help system.

            Search Topics displays the Search dialog for Take
            Command Help.  This is the same dialog you will see if
            you click on the Search button from within the help
            system.
  -43-



            About displays Take Command version, copyright, and
            license information.

            See page 53 for more information about how to use Take
            Command's online help.


  Take Command Dialogs

       The Take Command menus lead to several dialog boxes.  Each is
       described in this section.

       The text below explains the purpose of each dialog, and,
       where appropriate, provides references within this manual for
       more information on the features associated with the dialog.
       For complete details on the fields in each Take Command
       dialog, see the online help under Using the Take Command
       Interface / The Take Command Screen / Dialogs, or use the
       Help button from within the dialog.

       Take Command also uses standard Windows dialogs for tasks
       like printing, selecting a font, or browsing files and
       directories.  These dialogs are provided by Windows, not Take
       Command, and are common to many different Windows programs;
       they are not documented in the Take Command help system.


       Save To File Dialog

            This standard Windows or OS/2 "Save As" dialog box is
            available from the File menu.  From it, you can select
            the drive, directory, and file to use to save the
            contents of the command window and screen buffer.


       Print Dialog

TC16,       This standard Windows Print dialog is available from the
TC32        File menu.  You can select which part of the command
            window and scrollback buffer you want to print.  You can
            choose settings such as the number of copies to print,
            whether you want collated copies, and the print quality.
            If you have already selected some text in the Take
            Command window, the dialog defaults to printing just the
            selected text.  Otherwise, the default is to print the
            entire buffer.

TCOS2       A similar dialog is available from the File menu in Take
            Command for OS/2.  You can select the printer to use,
            the print priority, and the number of copies.  The
            Properties button will take you to the properties dialog
            for the printer you have selected.
  -44-



       Printer Setup Dialog

            The options that appear in this dialog, which is
            available from the File menu and from the File/Print
            menu choice, depend on your printer and printer driver.
            The choices you make in this dialog affect future
            printing from Take Command and from your other
            applications.


       Run Program Dialog

            The Apps / Run menu leads to the Run Program dialog.  In
            the Command Line edit box, you can enter the name of any
            executable program plus command-line parameters.  If you
            click on the arrow to the right of the edit box, the
            dialog displays a list of previous commands you have
            entered during the current Take Command session.

            The Normal, Minimized, and Maximized radio buttons
            determine the type of window that will be used for the
            program.  If you select Minimized, the program will
            start as an icon on the desktop or the Taskbar.
            Maximized starts the program in a full-screen window.
            The Normal button lets the operating system select the
            size and position of the program's window.

            The Browse button leads to standard file browser from
            which you can select any executable program.  Your
            choice will be placed in the Command Line edit box, and
            you can add parameters before selecting OK to run the
            program.


TC16   Tasks List Dialog

            Under Take Command/16, the Windows and Tasks list dialog
            is available from the Apps / Task List menu item.  It
            displays a list of all open windows and all tasks
            currently running.

            The Windows list, on the left side of the dialog, shows
            each open window.  It includes the internal shorthand
            name and current title for the window.  The buttons let
            you switch to an application, or close a window and end
            its associated program.  Most tasks will have a single
            window, but a task may have no window, or more than one
            window.

            The Tasks list, on right side of the dialog, shows the
            tasks that are currently running.  You can obtain
            information about each task and the program that started
            it, and you can choose to end the task.
  -45-



            Often, closing a window will also end the associated
            task and ending a task will close the associated window.
            However, depending on how a program is written, you may
            have to do both in order to completely end a program.


       Configuration Dialogs

            The Options / Configure Take Command menu choice leads
            to seven "pages" of dialogs that let you change the way
            Take Command looks and works.

            The text below explains the purpose of each page and
            section of the dialogs, and provides references within
            this manual for more information on some of the features
            controlled by the dialogs.  For complete details on the
            fields in each dialog, see the online help (look under
            Using the Take Command Interface / The Take Command
            Screen / Dialogs, or use the Help button from within the
            dialogs).

            The information entered in these dialogs is kept in the
            [TakeCommand] section of the .INI file, and can be
            modified manually as well; see Chapter 6 on page 174 for
            complete details.

            In Take Command/16 and Take Command/32 you can move from
            one configuration dialog page to another with the
            selector list in the left-hand pane.  In Take Command
            for OS/2, use the notebook tabs to switch to a different
            dialog page.

            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 current session
            only, or discard the changes you have made by selecting
            the Cancel button.

            Note that if you exit the dialogs 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.

            The Startup page controls how Take Command starts.
            Changes you make on this page of the dialogs will not
            take effect until the next time you start Take Command.
            There are five sections:

                 *  The TCSTART and TCEXIT section sets the path to
                    your TCSTART and TCEXIT automatic batch files
                    (see page 121).
  -46-



                 *  The Buffer Sizes section sets the size of the
                    command history and directory history lists.

                 *  The Cursor section determines whether the cursor
                    appears as an "I-Beam" or an arrow in the text
                    area of the Take Command window.

                 *  The Display section sets the size and location
                    of Take Command's window when it starts up, and
                    configures the Take Command/32 console window.

                 *  The Options section selects local or global
                    command history, aliases, and directory history
                    (in Take Command/32 and Take Command for OS/2),
                    and controls the loading of Windows file
                    associations (in Take Command/16 and Take
                    Command/32).

            The Display page controls the appearance of Take
            Command:

                 *  The Text Dimensions section configures the way
                    that text appears in Take Command's main window.

                 *  The Window Configuration section controls the
                    appearance of the Tool Bar (see page 48) and
                    Status Bar (see page 32).

                 *  The Scrolling section controls Take Command's
                    screen scrollback buffer (see page 34).

                 *  The Colors section sets screen colors used by
                    Take Command for displayed text, and for input
                    text you type.

            The Command Line 1 page controls Take Command's command
            line, editing, and history features:

                 *  The Editing section controls command-line
                    editing (see page 56), including selection of
                    overstrike or insert mode, and the text cursor
                    size.

                 *  The Filename Completion section allows you to
                    customize the behavior of Take Command's
                    filename completion feature (see page 63).

                 *  The Command History section selects the
                    scrolling and history keystrokes (see page 111),
                    and controls how characters are added to the
                    command history (see page 59).

            The Command Line 2 page controls additional command line
            options:
  -47-



                 *  The Popup Windows section controls popup window
                    position and size, including history and
                    filename completion windows, and the extended
                    directory search window.

                 *  The Extended Directory Search section controls
                    extended directory searches (see page 79).

            The Options 1 page controls a number of Take Command
            options:

                 *  The Descriptions section sets the way Take
                    Command handles file descriptions entered with
                    the DESCRIBE command or via the Descriptions
                    option on the Utilities menu.

                 *  The Special Characters section sets the command
                    separator (see page 70), escape character (page
                    110), and parameter character (pages 118 and
                    213), decimal separator (page 183), and
                    thousands separator (page 189).

                 *  Default Beep sets defaults for the BEEP command
                    and for "error" beeps.

                 *  The Options section sets miscellaneous options
                    including upper case conversion, batch file echo
                    (page 117), protection of redirected output
                    files (page 84), time display options, and cut
                    and paste keys in Take Command/16 and Take
                    Command/32; (see page 35).

            The Options 2 page controls an additional group of Take
            Command options:

                 *  The Logging section controls Command and History
                    logging (see the LOG command for details).

TC16,            *  The Program Manager Interface section sets the
TC32                method Take Command uses to obtain group and
                    application names from Program Manager (see
                    ProgManDDE on page 187).

                 *  The EVAL section sets the default number of
                    digits after the decimal point that @EVAL will
                    display (see page 155).

                 *  The External Programs section controls whether
                    Take Command waits for applications to complete
                    before displaying the prompt (see page 74 for
                    details).

TC16             *  The Task List section controls whether Take
                    Command displays its own windows and task lists
  -48-



                    dialog (see page 44) when you press Ctrl-Esc
                    from the Take Command window.



            The Commands page controls the options which relate to
            specific commands:

                 *  The DIR Colors section sets the colors used for
                    filenames in DIR (see page 259).

                 *  The LIST section sets the foreground and
                    background colors for the LIST command.

                 *  The SELECT section sets the foreground and
                    background colors for the SELECT command.

                 *  The Editor Filename sets the path and name of
                    the program used when you use when you select
                    Editor from the Utilities menu.


       Tool Bar Dialog

            This dialog, available from the Options menu, allows you
            to define or modify buttons on the tool bar.

            Select the button you want to define or modify in the
            box on the left.  Use the fields at the bottom of the
            dialog box to enter the button's label, and the
            command(s) to be executed when you select the button.
            You can use the Browse button to find a path and
            filename to be entered at the beginning of the Command
            field.

            You can also control whether the command is executed
            immediately, whether it is echoed before it is executed,
            and the font size used to display the labels on the tool
            bar.

            See the online help for additional details on the
            meaning of each field and button, and for information on
            starting programs in the correct working directory.


       Font Dialog

            The Font dialog (available from the Select Font choice
            on the Options menu) lets you select the font, style,
            and size of text in the Take Command command window.
            You can select any monospaced font that has been
            properly installed in Windows or OS/2.  (A monospaced
            font is one which uses the same fixed width for all
            characters.  A proportional spaced font varies the width
  -49-



            based on each character's shape.  Proportional spaced
            fonts cannot be used because they create serious
            misalignments in Take Command's output).  A sample of
            the font, in the style and size you have selected,
            appears in the bottom pane of the dialog.

         !  Caution:  Some fonts will not display all of the
            characters used by Take Command.  In particular the
            DRAWBOX, DRAWHLINE, and DRAWVLINE commands use line-
            drawing characters which are not included in most
            Windows fonts.  To ensure that these commands work
            properly, use the "Terminal" font in Windows, and the
            "System VIO" font in OS/2, both of which typically do
            include line-drawing characters.

            Also, the appearance of control characters, including
            Ctrl-X (the default escape character in Take Command/16)
            may vary depending on the font you have selected.
            Throughout this manual, we show the control characters
            that appear if you are using the Terminal font.


TC16   Caveman VM Setup Dialog

            This dialog is only available from the Options menu in
            Take Command/16, and only if Caveman is installed and
            enabled (see page 50 for information on the Take
            Command/32 Caveman Apps dialog.).  Use it to set the
            parameters for the Caveman "Virtual Machine," used to
            run DOS applications from Take Command.

            The memory and priority settings are standard values
            similar to those used in a .PIF file, and control the
            resources available to the Caveman virtual machine.  The
            other settings determine whether DOS applications run
            under Caveman by default, and whether the Caveman VM is
            restarted for each new application.

            For complete details on Caveman and the use of this
            dialog see Take Command and DOS Applications in the
            online help (under "Using the Take Command Interface"),
            and its subsidiary topics, which discuss Caveman in
            detail.  We recommend that you review the online help
            before enabling Caveman or modifying the dialog
            settings.


TC16   Caveman Error Dialog

            This dialog appears when an error occurs because you
            tried to run an incompatible DOS program under Caveman.
            For complete details on Caveman see Take Command and DOS
            Applications in the online help (under "Using the Take
            Command Interface").  For details on this specific
  -50-



            dialog see Caveman Error Dialog in the online help (look
            under "Using the Take Command Interface" then "The Take
            Command Screen" then "Dialogs").

            Select Restart to restart the application now in a
            separate window (rather than under Caveman).  Select
            Cancel to return to the Take Command screen without
            restarting the application.

            In either case, if you click the Always use separate
            window button at the bottom of the screen, Take Command
            will remember that this program will not work under
            Caveman and will automatically run it in a separate
            window the next time you start it.


TC32   Caveman Applications Dialog

            This dialog is only available from the Options menu in
            Take Command/32 (see page 49 for information on the Take
            Command/16 Caveman VM Setup dialog).  Use it to enable
            or disable Caveman support, and to select which
            character-mode applications should be run automatically
            under Caveman.

            For complete details on Caveman and the use of this
            dialog see Console Applications and the Console Window
            in the online help (under "Using the Take Command
            Interface"), and its subsidiary topics, which discuss
            Caveman in detail.  We recommend that you review the
            online help before enabling Caveman or modifying the
            dialog settings.

            Use the Enable Caveman checkbox at the top of the dialog
            to enable or disable Caveman globally.  To add an
            application to the list, click the Add button and fill
            in the application name.  You can use a path and/or
            wildcards in the name; see the online help for complete
            details.  When the entry is complete, click Add to add
            another application, or OK when you are finished.  Use
            the Find button to browse through your hard disk, locate
            a file, and add it to the list.  Delete removes an entry
            from the list.  The Enable checkbox enables the
            application to run under Caveman; the TTY App checkbox
            marks it as an application which uses the Take Command
            screen colors, rather than its own colors.

            To change an existing entry, select it and press Enter,
            or double-click the entry.  This will enable the fields
            at the bottom of the screen so that the entry can be
            modified.


TCOS2  TTY Applications Dialog
  -51-



            This dialog is available from the Setup menu in Take
            Command for OS/2.  Use it to select which character-mode
            applications should be run automatically under Take
            Command's TTY application support.

            For complete details on TTY applications and the use of
            this dialog see Starting Character-Mode Applications in
            the online help (under "Using the Take Command
            Interface"), and its subsidiary topics, which discuss
            TTY applications in detail.  We recommend that you
            review the online help before adding to or modifying the
            TTY applications list in this dialog.  TTY application
            support is also discussed in the Introduction and
            Installation Guide.

            To add an application to the list, click the Add button
            and fill in the application name.  The name can be a
            filename, path, or complete path and filename; see the
            online help for complete details.  When the entry is
            complete, click Add to add another application, or OK
            when you are finished.  Use the Find button to browse
            through your hard disk, locate a file, and add it to the
            list.  Delete removes an entry from the list.

            To change an existing entry, select it and press Enter,
            or double-click the entry.  This will enable the fields
            at the bottom of the screen so that the entry can be
            modified.


       Find Files / Text Dialog

            The Find Files/Text dialog box gives you the same
            features as the FFIND command, in dialog form.  It is
            available from the Utilities menu.

            Enter the file name or names you wish to search for in
            the Files field.  You can use wildcards and include
            lists (see page 91 and 100) as part of the file name.
            You can also use the Browse button to find specific
            files to examine for a text search.

            Enter the text (or hexadecimal values) you are searching
            for in the Text field.  You can use extended wildcards
            (see page 91) in the search string to increase the
            flexibility of the search.  Use back-quotes [`] around
            the text if you want to search for characters which
            would otherwise be interpreted as wildcards.

            Enter the drive(s) you want to search in the Disks
            field.  This field is ignored unless Entire Disk is
            selected in the Search portion of the dialog.  If you
            select All Hard Disks, this field is set automatically
  -52-



            to include all hard disk drive letters Take Command
            finds on your system.

            The Match Case box, when it is selected, makes the
            search case-sensitive.  This option is ignored if Hex
            Search is selected.  The Hex Search option signals that
            you are searching for hexadecimal values, not ASCII
            characters; see the online help for additional details.

            If you enable All Lines, every matching line from every
            file will be displayed; otherwise only the first
            matching line from each file will be displayed.  Unless
            you enable the Hidden Files option, files with the
            hidden and system attributes (see page 16) will not be
            included in the search.  The radio buttons in the Search
            area let you specify where you want Take Command to look
            for files.

            To start the search, press the Find button.  Once the
            search has started the Find button changes to a Stop
            button, which you can use to interrupt the search before
            it is finished.

            If you select one of the matching files in the list (by
            double-clicking on it, or selecting it with the cursor
            and pressing Enter), Take Command will display another
            dialog with complete directory information about the
            file.  From this dialog, you can Run the file (if it is
            an executable file, a batch file, or has an executable
            extension), display the file with the LIST command (see
            page 330), or Edit the file.


       Descriptions Dialog

            The Edit Descriptions dialog is available from the
            Descriptions item on the Utilities menu.  Most of this
            dialog looks and works like a standard file browser.
            The pane at the bottom of the dialog lets you view,
            enter, or edit the description for any file.  See
            DESCRIBE on page 248 for more information on file
            descriptions.

            File descriptions can also be entered or changed with
            the DESCRIBE command, and are visible when you use the
            DIR and SELECT commands.


       Alias and Environment Dialogs

            You can use the Aliases and Environment dialogs,
            available from the Utilities menu, to view, edit, add,
            and delete Take Command aliases and environment
            variables (the two dialogs are the same except for the
  -53-



            title and the data which appears within the fields).
            For more information about aliases, see page 113; for
            more information about environment variables, see page
            137.

            The current list of aliases or environment variables is
            shown in the pane on the left.  The current name and
            value are shown in the fields at the bottom, and can be
            edited there.

            To add a new alias or variable to the list, use the Add
            button.  The Delete button deletes the highlighted alias
            or environment variable.

            The Import button reads a list of aliases or environment
            variables from a file; the Export button writes the
            current list to a file.


  Take Command Help

       The online help system for Take Command covers all Take
       Command features and internal commands.  It includes
       reference information to assist you in using Take Command and
       developing batch files, and it includes most -- but not all -
       - of the details which are included in the printed Take
       Command manuals.  You can start the help system by pressing
       F1, by selecting the Help menu, or by using the techniques
       below.

       If you type part or all of a command on the command line and
       then press F1, the help system will provide "context-
       sensitive" help by using the first word on the line as a help
       topic.  If it's a valid topic, you will see help for that
       topic automatically; if not, you will see the Table of
       Contents for the help file, and you can pick the topic you
       want.  You can also display help for any topic by typing HELP
       followed by the topic name.

       You can use this feature to obtain help on any topic -- not
       just on commands.  For example, if you enter the command HELP
       _DISK you will see help for the _DISK internal variable.

       If you type the name of any internal command at the prompt,
       followed by a slash and a question mark [/?] like this:

            copy /?

       then you will also see help for the command.

       The /? option may not work correctly if you have used an
       alias to redefine how an internal command operates.  To view
       the /? help for such a command you must add an asterisk to
  -54-



       the beginning of the command to disable alias processing.
       For example, if you have defined this alias:

            alias copy *copy /r

       then the command COPY /? will be translated to COPY /R /?,
       which will not work properly.  However, if you use *COPY /?,
       the alias will be ignored and the /? will work as you
       intended.

       Take Command uses the Windows or OS/2 help system to display
       help text.  Once you've started the help system with HELP or
       F1, you can use standard keystrokes to navigate through the
       help files.  For more information, click on the Help menu at
       the top of the help window, or select How To Use Help from
       the Take Command/16 or Take Command/32 Help menu.

       Finally, if you use a command incorrectly, omit a required
       parameter, or use an unrecognized option, Take Command will
       display a syntax summary of the command.
