unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 tsm(1)								      tsm(1)




 NAME
      tsm - Terminal Session Manager

 SYNOPSIS
      tsm

 DESCRIPTION
      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
      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
      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 Release 11i: November 2000






 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 Release 11i: November 2000






 tsm(1)								      tsm(1)




 EXTERNAL INFLUENCES
      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
      Some operations are not supported on certain terminals.

 AUTHOR
      tsm was developed by Structured Software Solutions, Inc.

 FILES
      /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
      tsm.info(1), tsm.command(1), tsm.lpadmin(3M), shl(1).

























 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000