tsm(1)                                                               tsm(1)




 NAME    [Toc]    [Back]
      tsm - Terminal Session Manager

 SYNOPSIS    [Toc]    [Back]
      tsm

 DESCRIPTION    [Toc]    [Back]
      tsm allows a user to interact with more than one shell or application
      (session) from a single terminal.  Each session is bound to a virtual
      device emulating the physical terminal.  The emulation includes
      maintaining display state, softkeys, and terminal modes for each
      session.  The virtual device can be manipulated like the actual
      terminal by using stty and ioctl (see stty(1) and ioctl(2)).
      Additionally tsm supports cut and paste between sessions, and provides
      an interface for a local lp device.  Each session has its own process
      group ID.

    Definitions    [Toc]    [Back]
      A session is current if it is being displayed and is the recipient of
      keyboard input.

      The standard search path is:

           ./
           $HOME
           $TSMPATH
           /usr/tsm/

      Configuration files and such are searched for in the order indicated
      and defined by these paths.

    Commands    [Toc]    [Back]
      There are two methods of interacting with tsm: a pull-down menu, and a
      command line interface.  The pull-down menu (when configured) can be
      activated from a session by pressing the tsm menu hot key (default is
      ^T) and should be self explanatory.  The command line interface can be
      activated by pressing the tsm hot key (default is ^W) in a session.
      Pressing a ``hot key'' twice passes the ``hot key'' character to the
      session instead of activating tsm command or menu mode.

      Commands to tsm generally have single character invocation, in some
      cases the user is prompted for more input.  The following commands can
      be issued from the tsm prompt level:

           0-9     Pressing a number at the command prompt selects the
                   session of the same number to become the current session.

           +       Select the next higher numbered session.

           -       Select the next lower numbered session.




 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 tsm(1)                                                               tsm(1)




           l       Select the last session.

           ?       Display a help screen describing tsm commands.

           c       Copy (cut): Three types:

                        +  Text (Lines including new-lines).  This is the
                           default.  Select with T when cut prompt is
                           displayed.

                        +  String (Lines strung together with white space in
                           place of new-lines).  Select with T when cut
                           prompt is displayed.

                        +  Block (A rectangle).  Select with T when cut
                           prompt is displayed.

                   The user is prompted for the "cut extents".  The extents
                   are defined by using arrow keys or the keys u, d, l, and
                   r to move the cursor as desired.  Pressing the space bar
                   aborts the cut operation.  The selected text is placed in
                   the cut buffer.  Trailing whitespace and character
                   attribute information are ignored.

           p       Paste: the contents of the cut buffer is echoed to the
                   current session as if it were typed from the keyboard.

           r       Run a program as a new session.  The user is prompted for
                   the program name.

           s       Start a new session containing a shell.

           o       Output the current display to a printer (screen dump).
                   The print mechanism is specified in a file named
                   .tsmprint searched for in the standard way.  Character
                   attribute information is ignored.

           k       Load the softkeys of the current session from a file.  To
                   load tsm defaults, specify ``file'' +.  To load terminal
                   defaults, specify ``file'' -.

           g       Same as k above but softkeys are loaded ``globally'' into
                   all sessions.

           x       Access extended tsm commands as described in the tsm
                   reference manual or on the tsm help screen.

           q       Quit tsm: SIGHUP is sent to all processes started under
                   tsm, and tsm exits.





 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 tsm(1)                                                               tsm(1)




 EXTERNAL INFLUENCES    [Toc]    [Back]
      In general tsm environment variables must be set prior to tsm
      invocation.  TSMLP is the lp(1) name of a printer that gets its output
      redirected to the printer port of the terminal.

      TSMTPATH specifies an alternate search path for tsm files.

      TSMTERM specifies an alternate terminal information file to be used by
      tsm instead of that specified by TERM.  TSMHOTKEY specifies an
      alternate tsm hotkey for invocation ot the tsm command line.

 WARNINGS    [Toc]    [Back]
      Some operations are not supported on certain terminals.

 AUTHOR    [Toc]    [Back]
      tsm was developed by Structured Software Solutions, Inc.

 FILES    [Toc]    [Back]
      /usr/tsm/.tsm                 tsm main configuration file (default).
                                    Copy to $HOME for user customization.

      /usr/tsm/.tsmkeys             tsm softkey configuration file
                                    (default).  Copy to $HOME for user
                                    customization.

      /usr/tsm/term/*               terminal description files

 SEE ALSO    [Toc]    [Back]
      tsm.info(1), tsm.command(1), tsm.lpadmin(1M), shl(1).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003