


CMDTOOL(1)                                             CMDTOOL(1)


NNAAMMEE
       ccmmddttooooll - run a shell (or other program) in an OpenWindows
       enhanced terminal window

SSYYNNOOPPSSIISS
       ccmmddttooooll [ --CC ] [ --MM _b_y_t_e_s ] [ --PP _c_o_u_n_t ] [ --BB _b_o_l_d_s_t_y_l_e  ]
       [ --II _c_o_m_m_a_n_d ] [ _g_e_n_e_r_i_c_-_t_o_o_l_-_a_r_g_u_m_e_n_t_s ] [ _p_r_o_g_r_a_m [ _p_r_o_-
       _g_r_a_m_-_a_r_g_u_m_e_n_t_s ] ]

AAVVAAIILLAABBIILLIITTYY
       This command is available with the OpenWindows user  envi-
       ronment.   For  information  about installing OpenWindows,
       refer to the _O_p_e_n_W_i_n_d_o_w_s _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d _S_t_a_r_t_-_U_p  _G_u_i_d_e_.

DDEESSCCRRIIPPTTIIOONN
       ccmmddttooooll  is  the standard _O_p_e_n_W_i_n_d_o_w_s support facility for
       shells and other programs.  When invoked, ccmmddttooooll  runs  a
       program  (usually a shell) in a text-based command window.
       Characters typed on  the  keyboard  are  inserted  at  the
       caret.   If the program is a shell, that shell accepts and
       runs commands in the usual manner.  ccmmddttooooll also  supports
       programs  that  perform  cursor  motions directly, such as
       vvii(1).

       The text of the current command line can be  edited  using
       normal tteexxtteeddiitt(1) functions.  The command window displays
       a log of the session, which can be scrolled through  using
       the  scrollbar  (unless  the  escape  command  mode  is in
       effect).  This log can be edited, and  saved  by  choosing
       the `SSttoorree aass NNeeww FFiillee' item in the text facility's pop-up
       menu.

OOPPTTIIOONNSS
       --CC             Console ccmmddttooooll.  Redirect  system  console
                      output  to this shelltool.  Display console
                      messages in this ccmmddttooooll, which might  oth-
                      erwise  appear  in unexpected places on the
                      workstation screen.  Since a ccmmddttooooll window
                      can be scrolled, console error messages can
                      be recorded for later examination.

       --MM _b_y_t_e_s       Set the log to wrap-around after the  indi-
                      cated number of _b_y_t_e_s.

       --PP _c_o_u_n_t       Checkpoint the log after every set of _c_o_u_n_t
                      editing operations.

       --BB _b_o_l_d_s_t_y_l_e   Set the style for displaying bold  text  to
                      _b_o_l_d_s_t_y_l_e.  _b_o_l_d_s_t_y_l_e can be a string spec-
                      ifying  one  of   the   choices   for   the
                      tteerrmm..bboollddssttyyllee    default,   see   DDeeffaauullttss
                      OOppttiioonnss, below, or it may  be  a  numerical
                      value  for  one of those choices, from 0 to
                      8, corresponding to the  placement  of  the



                           11 June 1990                         1





CMDTOOL(1)                                             CMDTOOL(1)


                      choice in the list.

       --II _c_o_m_m_a_n_d     Pass  _c_o_m_m_a_n_d  to the shell.  SPACE charac-
                      ters within the command must be escaped.

       _g_e_n_e_r_i_c_-_t_o_o_l_-_a_r_g_u_m_e_n_t_s
                      ccmmddttooooll accepts the generic tool  arguments
                      listed in xxvviieeww(1).

       _p_r_o_g_r_a_m [ _p_r_o_g_r_a_m_-_a_r_g_u_m_e_n_t_s ]
                      If  a  _p_r_o_g_r_a_m argument is present, ccmmddttooooll
                      runs it and passes any remaining  arguments
                      to  that  _p_r_o_g_r_a_m.  If no _p_r_o_g_r_a_m is given,
                      ccmmddttooooll runs the program indicated  by  the
                      SSHHEELLLL  environment  variable, or //bbiinn//sshh by
                      default.

UUSSAAGGEE
   ..XXddeeffaauullttss FFiillee OOppttiioonnss
       You can specify a number of defaults using the options  in
       the  ..XXddeeffaauullttss  file that effect the behavior of ccmmddttooooll.
       The ones of interest are those that begin with  tteexxtt,tteerrmm,
       or  kkeeyybbooaarrdd.  See xxvviieeww(1) for more detailed information.

   ccmmddttooooll WWiinnddoowwss
       The window created by ccmmddttooooll is based on the text  facil-
       ity  that is described in the tteexxtteeddiitt man page.  The user
       is given a prompt at which to  type  commands  and  pop-up
       menus from which to select command options.

       ccmmddttooooll   windows   support   cursor   motions,  using  an
       //eettcc//tteerrmmccaapp entry called ssuunn--ccmmdd.  Command windows  auto-
       matically  set  the  TTEERRMM environment variable to ssuunn--ccmmdd.
       So, if you rrllooggiinn(1C) to a machine that does not  have  an
       entry for ssuunn--ccmmdd in its //eettcc//tteerrmmccaapp file, the error mes-
       sage `TTyyppee ssuunn--ccmmdd uunnkknnoowwnn' r  `sseett  TTEERRMM==ssuunn'.   Programs
       written  using  the ccuurrsseess(3X) or ccuurrsseess(3V) library pack-
       ages will work in a command  window,  but  programs  hard-
       coded  for  ssuunn-type terminals may not.  When supporting a
       program that performs cursor motions, the  command  window
       automatically takes on the characteristics of a tty window
       (as with sshheellllttooooll(1)).  When that program  terminates  or
       sleeps, the full command window functionality is restored.

       ccmmddttooooll supports programs that use CBREAK and NO ECHO ter-
       minal  modes.   This  support is normally invisible to the
       user.  However,  programs  that  use  RAW  mode,  such  as
       rrllooggiinn(1C)  and  ssccrriipptt(1),  inhibit  command-line editing
       with the mouse.  In this case, however,  tty-style  ERASE,
       word-kill  and  line-kill  characters can still be used to
       edit the current command line.

   TThhee ccmmddttooooll MMeennuu
       The ccmmddttooooll window menu is called the TTeerrmm PPaannee  menu  and



                           11 June 1990                         2





CMDTOOL(1)                                             CMDTOOL(1)


       contains the following options and their submenus:

       HHiissttoorryy   Creates  a  a  list  of commands used during the
                 cmdtool session.
                 MMooddee
                           EEddiittaabbllee  You can edit the contents of
                                     the window.
                           RReeaadd OOnnllyy You  can  only read from the
                                     window.
                 SSttoorree LLoogg aass nneeww ffiillee
                           Create a new file  that  contains  the
                           contents of the log.
                 CClleeaarr lloogg Clears all entries from the log.
       EEddiitt      Provides  a  set  of  editing functions for this
                 window.
                 AAggaaiinn     Repeats the last action.
                 UUnnddoo
                           UUnnddoo LLaasstt EEddiitt
                                     Undoes the last edit made in
                                     ccmmddttooooll ..
                           UUnnddoo AAllll EEddiittss
                                     Undoes all edits made during
                                     this session of ccmmddttooooll ..
                 CCooppyy      Makes a copy of the selected text  and
                           places it on the clipboard.
                 PPaassttee     Pastes  a  copy  of the text stored on
                           the clipboard at the cursor  location.
                 CCuutt       Deletes the selected text.RE

                 Provides a set of find and replace functions.
                           FFiinndd aanndd RReeppllaaccee
                                     Brings up a pop-up menu con-
                                     taining text fields and com-
                                     mand  buttons that allow you
                                     to search forward and  back-
                                     ward  through the file being
                                     edited  for  specific   text
                                     strings.    Allows   you  to
                                     specify  options   for   the
                                     replacement of text.
                           FFiinndd SSeelleeccttiioonn
                                     FFoorrwwaarrdd   Searches   forward
                                               to find a selected
                                               text string.
                                     BBaacckkwwaarrdd  Searches  backward
                                               to find a selected
                                               text string.
                           FFiinndd MMaarrkkeedd TTeexxtt
                                     Brings up a pop-up menu that
                                     allows you to find text that
                                     is  included  between speci-
                                     fied  bracket  pairs.   Also
                                     allows   you  to  insert  or
                                     remove bracket pairs  around



                           11 June 1990                         3





CMDTOOL(1)                                             CMDTOOL(1)


                                     selected text.
                           RReeppllaaccee ||>>ffiieelldd<<|| >>
                                     Allows    you   to   replace
                                     selected  text  forward  and
                                     backward    throughout   the
                                     file.
       EExxttrraass    A user-definable pull-right menu  controlled  by
                 the  //uussrr//lliibb//..tteexxtt__eexxttrraass__mmeennuu  file.  This can
                 be overridden in two ways:
                 1) Change the value of the .Xdefaults  parameter
                 tteexxtt..eexxttrraassMMeennuuFFiilleennaammee   to  the  correct  file
                 path.
                 2) Set the environment  variable  EEXXTTRRAASSMMEENNUU  to
                 the file desired.
                 Note  that  option  1 overrides option 2 if both
                 are used.  For more information see the  _D_e_s_k_S_e_t
                 _E_n_v_i_r_o_n_m_e_n_t _R_e_f_e_r_e_n_c_e _G_u_i_d_e _.
       FFiillee EEddiittoorr
                 EEnnaabbllee    Allows  you  to edit files from within
                           ccmmddttooooll..
                 DDiissaabbllee   Turns off the ability  to  edit  files
                           from within ccmmddttooooll..
       SSccrroolllliinngg
                 EEnnaabblleess SSccrroolllliinngg
                           Enables scrolling within ccmmddttooooll..
                 DDiissaabbllee SSccrroolllliinngg
                           Turns off the ability to scroll within
                           ccmmddttooooll..  Once scrolling in ccmmddttooooll iiss
                           ddiissaabblleedd,,  iitt''ss ffuunnccttiioonnaalliittyy iiss iden-
                           tical  to   sshheellllttooooll   and   a   more
                           restricted menu appears. Selecting the
                           EEnnaabbllee  SSccrroolllliinngg  option   from   the
                           restricted menu restores the full menu
                           and functionality of ccmmddttooooll..
   UUsseerr DDeeffiinneedd KKeeyybbooaarrdd RReemmaappppiinngg
       The file ~~//..tteexxttsswwrrcc specifies filter  programs  that  are
       assigned  to (available) function keys.  These filters are
       applied to the contents of the primary  selection.   Their
       output is entered at the caret.
   AAcccceelleerraattoorrss
       Text  facility  accelerators that are especially useful in
       command windows are described here.  See
       tteexxtteeddiitt(1) for more information.
       CTRL-RETURN       Position the caret at  the  bottom,  and
                         scroll  it  into  view  as determined by
                         TTeexxtt..LLoowweerrCCoonntteexxtt.
       CAPS-lock
       Toggle between all-upper-case keyboard input, and mixed-
                         case.

FFIILLEESS
       //ttmmpp//ttttyy..ttxxtt.._p_i_d    log file
       ~~//..tteexxttsswwrrcc
       ~~//..ttttyysswwrrcc



                           11 June 1990                         4





CMDTOOL(1)                                             CMDTOOL(1)


       uussrr//lliibb//..tteexxtt__eexxttrraass__mmeennuu
       $$HHOOMMEE//..TTeexxttEExxttrraaMMeennuu
       //eettcc//tteerrmmccaapp
       //uussrr//bbiinn//sshh

SSEEEE AALLSSOO
       rrllooggiinn(1C),  ssccrriipptt(1),  sshheellllttooooll(1), tteexxtteeddiitt(1), vvii(1),
       xxvviieeww(1), ccuurrsseess(3V), ccuurrsseess(3X)

       _O_p_e_n_W_i_n_d_o_w_s _U_s_e_r_'_s _G_u_i_d_e

BBUUGGSS
       Typing ahead while ccmmddttooooll changes between its  scrollable
       and cursor motion modes will sometimes freeze ccmmddttooooll ..

       Full  terminal emulation is not complete.  Some manifesta-
       tions of this deficiency are:

       +o  File completion in the C shell does not work.

       +o  Enhanced display of text is not supported.




































                           11 June 1990                         5


