



















          Terminal Manager

      Multi-User OS/2 and DOS

         Evaluation Edition

            Version 3.20

The  Terminal  Manager  Evaluation Edition contains certain files which have
been  packaged using  Info-ZIP's compression  utility.  The UNZIP.EXE program
packaged with the software may be used to unzip  the  relevant files.  
Info-ZIP's software (Zip, UnZip and related utilities) is free and can be 
obtained as source code or  executables from various bulletin board services
and anonymous-ftp sites, including CompuServe's IBMPRO  forum and 
ftp.uu.net:/pub/archiving/zip/*.
Terminal Manager is an unpublished work and is the copyright of Qiiq Ltd.
The Terminal Manager software, and data, or documentation related thereto,
and the information disclosed therein, are confidential and proprietary to 
Qiiq Ltd and may be used only under the terms and conditions of a Licence
Agreement from Qiiq Ltd.  Neither the software, regardless of the form in
which it exists, nor such data, nor information,  may  be used or disclosed 
to others for any purpose except as specifically authorised in  writing  by
Qiiq Ltd.   The  recipient, by accepting the documentation or by utilising 
the software, agrees to the  terms  and  conditions  of the Licence Agreement
and agrees that neither the software, nor the documentation, nor the
information disclosed  therein,  nor  any  part  thereof, shall be reproduced
or transferred to  other  documents  nor  used  nor disclosed to others for 
manufacturing or for any other purpose except as specifically authorised in 
writing by  Qiiq Ltd.
(c) Copyright 1990-1995  An unpublished work by Qiiq Ltd.
All rights reserved.
Terminal  Manager,  TermView,  TermPak and Qiiq are trademarks of Qiiq Ltd.
All  other  trademarks  are  acknowledged.
Qiiq Ltd, Elm House, 17-19 Claygate Lane, Thames Ditton, Surrey, KT7 0DL,
United Kingdom
Telephone +44 (0)181 339 0739 - FAX +44 (0)181 398 8443
Email qiiq@cix.compulink.co.uk

-------------------------------------------
Contents


Introduction                         2


Software Support                      3


Overview of Terminal Manager              4


Connecting the Terminal to the Host           5


Installing the Host Terminal Manager Software      6


Installing the TERM Software on a DOS PC        7


Starting Terminal Manager at the Host          9


Monitoring and Controlling Terminals at the Host    9


Using TERM on the DOS PC                13


Starting New Sessions at the Terminal          14


Running DOS Programs at the Terminal          15


Pricing and Ordering Information              18


Order Form




Terminal Manager - Evaluation Edition                    Page 1


-------------------------------------------
Introduction

This  manual summarises the installation and use of the  Terminal  Manager
3.20 Evaluation Edition.

The  Evaluation  Edition  has been produced so that  prospective  users  can
evaluate the features and facilities of Terminal Manager prior to purchasing
the full package.  The software contained in the Evaluation Edition is a  full
working version of Terminal Manager including the Multi-User DOS  facil-
ity.  It is configured for use on a single terminal attached to the host compu-
ter.   The only operational differences between the Evaluation  Edition  and
the  full  Terminal  Manager package are a time  restriction  of  30  minutes
operation  for  each  terminal, and, when the software loads,  a  message  is
displayed  informing you that it is not a fully-licensed version.  There is  no
date  restriction  placed  into the software, so  you  may  evaluate  Terminal
Manager  at your leisure.  The 30 minute timeout restriction means that  all
programs  running  at  a terminal will be terminated after  the  terminal  has
been  active for 30 minutes;  the terminal will then come online again for  a
further  30  minutes,  and  so forth.  You  should  remember  that  this  will
happen  with the Evaluation Edition and you should not consider it to  be  a
bug.

When you have completed your evaluation, you may order the full  package
for  the required number of terminals.  If you decide that the software  does
not  fit  your requirements, simply destroy the Evaluation  Edition  together
with  all  copies  of the software you may have installed  on  your  systems.
You  are  permitted to use the Evaluation Edition only for  evaluation  pur-
poses.   You may not use the software supplied with the Evaluation  Edition
for productive use.

The  documentation that comes with the full package comprises  190  pages
covering  the  base  Terminal Manager Multi-User OS/2  features,  with  an
additional  48  pages  covering the Multi-User DOS  facility.   Clearly,  we
have  had  to  omit  a great deal of detail from  this  manual,  however,  we
believe  that the information supplied is sufficient to give you a feel for  the
power of Terminal Manager.

If  you wish to evaluate the product further, ASCII versions of the  manuals
that are supplied with the full package are supplied as part of the Evaluation
Edition.   If  you  purchased  your copy of the  Evaluation  Edition,  it  will
contain  pre-printed  copies  of the manuals below, so you  do  not  need  to
print  the ASCII versions of the manual.


Page 2                    Terminal Manager - Evaluation Edition


  '` TMREFMAN.TXT is   the  main  reference   manual,   Terminal
                 Manager   -  Multi-User  OS/2  -   Reference
                 Manual,  which  covers the  base  multi-user
                 OS/2 operation.
  '` TMDOSMAN.TXT is  the  manual, Terminal Manager  -  Multi-
                 User  -  DOS Reference Manual,  which  de-
                 scribes the Multi-User DOS facility.

The  ASCII  versions of the manuals are compressed into a  Zip  file  called
MANUALS.ZIP.   This file may be unzipped using the  UNZIP.EXE  pro-
gram  supplied.   The following command, used in  the  Evaluation  Edition
directory or the directory into which Terminal Manager has been  installed,
will unzip the files :-

  UNZIP MANUALS

The  manuals  may  be printed on any standard ASCII printer.   If  you  are
printing  onto  A4  or Quarto sized paper, you should  select  a  font  which
prints  at  12 characters per inch or more to ensure that the entire  width  of
the  page is printed.  Much of the formatting of the manuals is unable to  be
represented  in the ASCII version, however, the manuals supplied  with  the
full  package are attractively formatted and printed, and are much easier  to
use than the ASCII versions.

If  you  downloaded this Evaluation Edition from a BBS or  the  Internet  or
obtained  it  from  some  other source,  you  may  purchase  the  Evaluation
Edition,  complete  with  printed  manuals, for  UK25  (US$40).   See  the
Pricing and Ordering Information section of this manual for further details.

-------------------------------------------
Software Support

Electronic  support  is provided free-of-charge for the lifetime  of  the  pro-
duct.   If  you  have any problems installing or using  the  software,  simply
send us full details of the problem you are encountering.  We will  acknow-
ledge receipt of your problem report generally within 24 hours and in  most
cases  will  provide the answer at the same time.  More  complex  problems
may take a little longer.

Problem reports may be sent in the following ways :-

  '` via FAX to +44 (0) 181 398 8443
  '` via Internet Email to qiiq@cix.compulink.co.uk
  '` via our Bulletin Board System (BBS) on +44 (0) 181 398 0266

Terminal Manager - Evaluation Edition                    Page 3


All  problem reports should include your name and full  address,  telephone
number, FAX number and, where appropriate, your Email address.   Ack-
nowledgements and responses are sent via the same medium as the  original
problem report.

The  BBS  is  operational 24 hours a day and supports transfer  rates  up  to
14,400  baud.   The  BBS supports modems  conforming  to  V22,  V22bis,
V32, V32 bis, with V42 or MNP2-4 error correction, and V42bis or MNP5
data  compression.   To ensure trouble-free connection, you  should  ensure
that  your  communications software is set to operate at the  same  speed  at
which  your  modem  connects to the BBS; if your modem  is  operating  at
14,400  baud,  you  should  set  your  communications  software  to  run  at
19,200 baud.  You should set your communications parameters to be 8 data
bits, no parity, 1 stop bit.

-------------------------------------------
Overview of Terminal Manager

This  section  gives a brief overview of the features of  Terminal  Manager.

The  Evaluation Edition contains the files OVERVIEW.TXT  and  OVER-
VIEW.INF which give a more in-depth overview.  OVERVIEW.TXT is an
ASCII  text  file  suitable for printing.  OVERVIEW.INF  may  be  viewed
using  OS/2's  standard VIEW program.  To view the file from  the  Evalua-
tion Edition diskette, type the following command :-

  VIEW A:OVERVIEW

Terminal Manager runs under OS/2 versions 1.1, 1.2, 1.3, 2.0, 2.1 and 3.0
(Warp).   The Multi-User DOS facility requires OS/2 version 2.0  or  later.
The software will run on Micro Channel Architecture (MCA) bus  systems;
on IBM PC/AT or compatible systems using derivations of the AT bus; and
on  Extended  Industry  Standard  Architecture  (EISA)  bus  systems.   The
processor  may  be the Intel 80286, 80386SX, 80386, 80486SX,  80486  or
Pentium.   The Multi-User DOS facility will not run on the  80286  proces-
sor.

The  Evaluation  Edition  is configured to use the  host  computer's  COM1
port. Terminal Manager actually supports COM1 - COM8 and a wide range
of  multi-port  adapters, although the means of configuring them is  not  de-
scribed in this manual.

Qiiq  supplies the low-cost S-Link 4-port adapter for AT bus  machines;  up
to  three  S-Link  adapters  may be installed in  a  single  PC.   The  S-Link

Page 4                    Terminal Manager - Evaluation Edition


adapter is priced at UK65 (US$105); see the Pricing and Ordering  Infor-
mation section of this manual for further details.

Terminal Manager supports a range of terminal types, however, the Evalua-
tion  Edition is pre-configured to use another computer as a  terminal.   The
computer operating as a terminal uses the TERM program supplied with the
software to emulate the operation of a dumb terminal.

The  programs which run at the terminals may be OS/2 protect  mode  pro-
grams or DOS real mode programs.

In order to be able to run on terminals, both OS/2 and DOS programs  must
be  text-mode programs.  These programs generally use  alphanumeric  text
screens  with a limited graphics capability obtained by using  the  line-draw-
ing  characters  in  the extended screen character set.   Any  OS/2  or  DOS
program  which  uses graphics screen displays is probably  not  suitable  for
terminal  operation.   OS/2 Presentation Manager programs are not  able  to
be accessed from a terminal.

We  are unable to guarantee that all off-the-shelf OS/2 and  DOS  programs
will  run  under  Terminal  Manager because  the  OS/2  Operating  System
allows application programs to directly access the computer hardware as  an
alternative to using operating system calls.  Any application program which
accesses  the  screen,  keyboard or mouse hardware  directly  may  not  run
properly under Terminal Manager.


-------------------------------------------
Connecting the Terminal to the Host

The Terminal Manager - Multi-User OS/2 - Reference Manual, details cable
configurations  for  attaching  terminals  to the computer.   In  a  live,  non-
evaluation situation, it is recommended that you use the correct cable confi-
guration so that flow control of data between the computer and the  terminal
can  be  used.  Additionally, the computer is able to detect  terminals  being
switched  on and off if the correct cable is used.  In the Evaluation  Edition,
the  installed  TRMMAN.INI  file sets COM1 to operate with  just  a  basic
cable  with  Signal  Ground, Transmit Data  and  Receive  Data  connected,
however, this cable is not able to detect a terminal being switched on or  off
and  always  assumes  that a terminal is present and ready  to  receive  data.
The following diagram shows how the basic cable should be wired :-




Terminal Manager - Evaluation Edition                    Page 5


      Computer         Terminal

        TD  -----------------------> RD
        RD  <----------------------- TD
        SG  ------------------------ SG

The  following  table  gives the pin numbers  corresponding  to  the  RS232
names for 9-way and 25-way connectors :-

  Name   25-way Pin   9-way Pin   Function

  TD      2           3           Transmit Data
  RD      3           2           Receive Data
  SG      7           5           Signal Ground

If  you have a null-modem cable, this may generally be used to connect  the
terminal  for evaluation purposes.  If you are unable to acquire or build  the
required  cable, please contact us and we will be able to supply one  at  cost
price.

-------------------------------------------
Installing the Host Terminal Manager Software

Terminal  Manager  operation is controlled by statements contained  in  the
TRMMAN.INI  file installed with the software.  The file may be  modified
to  reflect your configuration in respect of communication adapters,  termi-
nals  and  many  other  options.   After  installing  the  Evaluation  Edition,
TRMMAN.INI is set up for a configuration of one terminal attached to  the
COM1  port.  For evaluation purposes, it is recommended that you use  this
preset configuration.

I_M_P_O_R_T_A_N_T__N_O_T_E_:_  If you already have Terminal Manager installed on
your  computer, you should make a backup of the Terminal Manager  direc-
tory  TRMMAN  and  its subdirectories since  the  Evaluation  Edition  will
install  over the top of the existing software and you may lose your  existing
TRMMAN.INI, PMS.INI and TRMMAN.OPT files.

If  the  Evaluation Edition was downloaded from a BBS or  the  Internet  or
from some other source, it will usually be contained in a zipped file  named
MULTUSER.ZIP.   You should unzip the file onto a diskette before  instal-
ling  the  software.   If you have already unzipped the file into  a  hard  disk
directory, you may perform the installation from that directory.

The Terminal Manager installation program must be started from the  OS/2

Page 6                    Terminal Manager - Evaluation Edition


command prompt in a full-screen session.  Refer to the OS/2 documentation
and the OS/2 online help for details on how to start a full-screen session.

If  the  Evaluation Edition is on diskette, the diskette must be  inserted  into
the  diskette  drive,  usually drive A, and the following  command  must  be
entered at the command prompt :-

  A:TINSTALL

If  the  Evaluation  Edition  was unzipped into a  hard  disk  directory,  you
should  change  to  that directory to make it the default and  then  enter  the
following at the command prompt :-

  TINSTALL

TINSTALL  copies  the Terminal Manager files from the  diskette  or  hard
disk  directory  into  the  TRMMAN directory of the  boot  drive  and  then
modifies  or  adds  certain statements to the CONFIG.SYS file  in  the  root
directory of the boot drive.

The  Evaluation Edition also contains the optional Multi-User  DOS  facility
which  will be installed by the TINSTALL program if you are installing  on
to a system containing OS/2 2.0 or later.

When  TINSTALL has successfully completed, t_h_e__c_o_m_p_u_t_e_r__m_u_s_t__b_e___r_e_-_
b_o_o_t_e_d__b_e_f_o_r_e__t_h_e__c_h_a_n_g_e_s__m_a_d_e__t_o__C_O_N_F_I_G_._S_Y_S__b_e_c_o_m_e__e_f_f_e_c_t_i_v_e_._

The  TINSTALL program does not make any changes to the PATH  state-
ment  in  CONFIG.SYS.  If you wish to access any of the programs  in  the
TRMMAN directory whilst logged into other drives or directories, you will
need to ensure that the TRMMAN directory is included in the PATH state-
ment; this may be achieved either by setting it in CONFIG.SYS or by using
the SET command, possibly in a batch file.

-------------------------------------------
Installing the TERM Software on a DOS PC

The  Terminal Manager software includes the TERM.EXE program  which
allows a DOS-based personal computer (PC) to be attached to the  Terminal
Manager  host  in place of a standard terminal.  The  TERM  program  will
also run in a DOS session under OS/2 or Windows.

On  the DOS PC, the TERM program is used to establish the connection  to
the  Terminal  Manager host allowing the PC to function as a  terminal.   In

Terminal Manager - Evaluation Edition                    Page 7


the  Evaluation Edition, TERM is pre-configured to use the COM1 port  on
the  DOS PC and, both the host software and the TERM program  are  pre-
configured to run at 9600 baud.  In practice, terminals and DOS PCs would
often be configured to operate at higher speeds.

Once  the DOS PC is connected and operating as a terminal, it functions  in
all  respects  the  same as a standard terminal with the  added  capability  of
being  able to display colour output if an application program uses it  and  if
the  PC  has  a colour screen.  In addition, the PC  may  participate  in  file
transfer operations to and from the host Terminal Manager computer.

If the Evaluation Edition was unzipped into a hard disk directory, you  must
create a diskette to be used for installing the TERM software onto the  DOS
PC  that  is  to  be used as the terminal.  To  copy  the  files  onto  diskette,
change to the directory where the Evaluation Edition is and type the follow-
ing command at the OS/2 command prompt :-

  COPY TERM*.* n:

where n: is your diskette drive (normally A:).

If  the  Evaluation Edition is on diskette, you need not create  a  diskette  to
install  the TERM software since you may install directly from  the  Evalua-
tion Edition diskette.

The  TERM  software is installed on to the DOS PC by running  the  install
batch procedure TERMINST.BAT which copies the required files from the
diskette.   TERMINST.BAT copies the files into the current  default  direc-
tory   from   either   drive   A:   or   drive   B:.    The   command   to   run
TERMINST.BAT is as follows :-

  n:TERMINST n:

where  n:  is the drive containing the Terminal Manager diskette, that  is  to
say, A: or B:.

The following sample commands create a sub-directory called  TRMTERM
on  drive  C: and run the TERMINST.BAT procedure to  copy  the  TERM
files into that sub-directory :-

  C:             to make drive C: the default drive
  MD \TRMTERM    to create the directory TRMTERM
  CD \TRMTERM    to make the new directory the default
  A:TERMINST A:  to copy the TERM files

Page 8                    Terminal Manager - Evaluation Edition


-------------------------------------------
Starting Terminal Manager at the Host

Before the terminal is able to be used, the Terminal Manager software must
be started on the host computer.

Terminal Manager may be started directly from the command line of a full-
screen  text-mode  session or may be included in a menu  in  a  Presentation
Manager window.  Alternatively, you may start Terminal Manager automa-
tically  when the computer is initially loaded by placing the relevant  state-
ments  in  the OS/2 startup initialisation batch file  STARTUP.CMD.   For
evaluation purposes, the simplest way of starting Terminal Manager is from
a command prompt.  To start Terminal Manager from a command  prompt,
a full-screen session must first be started.  Refer to the OS/2 documentation
and  the  OS/2 online help for information on starting  an  OS/2  full-screen
session.

Once  in the full-screen session, Terminal Manager may be started  directly
from  the  TRMMAN  directory created during the installation  of  the  host
software.   The  following commands assume that  Terminal  Manager  was
installed on drive C.  The current default drive is first set to be drive C and
the current directory is changed to the TRMMAN directory before  entering
the START command which starts Terminal Manager :-

  START "Terminal Manager" /N TM

-------------------------------------------
Monitoring And Controlling Terminals at the Host

Shortly  after  loading, Terminal Manager displays the  TermView  control
screen.  TermView provides two screen panels, one for displaying terminal
status, the other for displaying activity log records.  An action bar is provi-
ded with each of the panels for performing control functions.

Monitoring Terminal Status

The  first  panel  displayed after Terminal Manager  loads  is  the  Terminal
Status screen.

Details  of  each terminal configured are displayed on a single  screen  line;
since  only  one  terminal is configured for the Evaluation  Edition,  only  a
single line will be displayed.

The following information is provided for each terminal :-

Terminal Manager - Evaluation Edition                    Page 9


  Term    specifies  the  logical  terminal  number  assigned  to   the
          terminal.
  Port    specifies  the logical port number to which the terminal  is
          connected.
  Location  describes  the  location  or some other  description  of  the
          terminal.
  Fgd    specifies  which session is currently in the  foreground  on
          the terminal, session 0 being the first session.
  Act    specifies the number of active sessions on the terminal.
  Max    specifies the maximum number of sessions configured  for
          the terminal.
  Status   specifies the current status of the terminal and may be one
          of the following :-

          Inactive  indicates  that  the  terminal  is  inactive  and
                 will be ignored by Terminal Manager should
                 it come online.
          Failed   indicates  that  the terminal is in  an  inactive
                 state because errors occurred while  attempt-
                 ing to run the shell program for the terminal.
          Offline  indicates  that  the  terminal is  active  but  is
                 currently    offline,   either   because   it    is
                 switched  off  or because no  connection  has
                 been made to a modem attached to the port.
          Bidding  indicates  that  the terminal is  online  and  is
                 bidding  for  access to the computer.   If  the
                 number  of users currently connected  to  the
                 computer  is less than the  number  licensed,
                 the bid will be immediately accepted and the
                 shell  program will be run.  If the  maximum
                 number   of  users  is  currently  active,   the
                 terminal  will  remain  in  the  bidding   state
                 until  one of the users disconnects  from  the
                 computer.
          Online   indicates that the terminal is currently online
                 and   running  either  the  shell  program   or
                 application programs.


TermView Commands

The  F10 key takes the operator onto the action bar and highlights  the  first
of  the  action  bar  choices.  The cursor left  and  cursor  right  keys  move
between  action  bar choices. The cursor down key or the ENTER  may  be

Page 10                    Terminal Manager - Evaluation Edition


pressed  to display the pull-down menu for the currently  highlighted  action
bar choice.  To move from the action bar back to the panel area, the F10 or
the ESC key may be pressed.

As  an alternative to using the cursor keys to select an action bar  item,  the
letter  highlighted  in  the  action bar may be pressed after  the  F10  key  to
immediately pull down the selected action bar menu.

When  a pull-down menu is displayed, the cursor up and cursor down  keys
may  be  used  to move between menu choices.  Pressing  the  ENTER  key
selects the currently highlighted option from the pull-down menu.

As  an  alternative to using the cursor keys and the ENTER key,  an  option
may be selected from a pull-down menu by entering the letter highlighted in
the menu item.

Pressing  the  F10 or the ESC key while the pull-down  menu  is  displayed
moves back onto the action bar choices.  Pressing the cursor right or cursor
left  keys while the pull-down menu is displayed displays the adjacent  pull-
down menu.

The Terminal Status Panel - 'Action' Pull-Down Menu

The Actions pull-down menu in the Terminal Status panel offers three menu
choices :-

  A_ctivate the terminal
        Activates the currently selected terminal allowing  Termi-
          nal  Manager  to  load  the  shell  program  whenever  the
          terminal is detected as being online.
  D_eactivate the terminal
        Deactivates  the terminal.  Terminal Manager will  termi-
          nate all programs and sessions running in the terminal.
  L_og the terminal off
        Terminal  Manager  will terminate all programs  and  ses-
          sions  running  in the terminal.  When all  programs  have
          terminated,   the  RS232  signals  DTR   (Data   Terminal
          Ready) and RTS (Request To Send) are turned off for one
          second  in order to disconnect any modem attached to  the
          port.  When Terminal Manager detects that the terminal is
          online  again, the shell program will be run in  the  termi-
          nal.   This  action has the effect of logging a user  off  the
          system and forcing a new logon.


Terminal Manager - Evaluation Edition                    Page 11


The Terminal Status Panel - 'Display' Pull-Down Menu

The  Display pull-down menu in the Terminal Status panel offers two  menu
choices :-

  Display All L_og Records
        Switches  to  the Log Records panel and  displays  the  log
          records  for all terminals and all  non-terminal-related  log
          records.
  Display T_erminal Log Records
        Switches  to the Log Records panel and displays  only  the
          log records for the currently selected terminal.

The Terminal Status Panel - 'Exit' Pull-Down Menu

The Exit pull-down menu in the Terminal Status panel offers two choices :-

  Ex_it the program
        Causes Terminal Manager to terminate and return  control
          to the point in OS/2 from where it was started;  this might
          be the command prompt or a Presentation Manager  menu
          window.   Terminal  Manager  will not  perform  the  exit
          command unless all terminals are currently in the inactive
          state.
  D_eactivate All Terminals
        This  option deactivates all terminals as though  individual
          Deactivate  commands had been issued for each  terminal.
          The  command  is intended for use as a means  of  closing
          down the system prior to exiting.

Closing Down Terminal Manager

Before exiting from Terminal Manager, you should ensure that all terminals
have  exited  from any application programs and are back in the  shell  pro-
gram.  For the Evaluation Edition, the shell program is the OS/2  command
prompt.

Terminal  Manager  will not allow the operator to exit unless  all  terminals
have been deactivated and are in the inactive state.  Terminals can be  deac-
tivated  individually  using  the  Actions pull-down  menu  of  the  Terminal
Status panel.  Alternatively, the Exit pull-down menu of the Terminal Status
and  Log  Records  panels  allows a deactivate command  to  be  sent  to  all
terminals.


Page 12                    Terminal Manager - Evaluation Edition


Once  all terminals are in the inactive state, the Exit the program  option  of
the Exit pull-down will terminate Terminal Manager operation.


-------------------------------------------
Using TERM on the DOS PC

TERM  is  started by typing the command 'TERM' while  in  the  directory
into which the TERM files were installed.

TERM  then connects to the host Terminal Manager computer and is  ready
for use.  The terminal should show an OS/2 command prompt.  Because  of
the simplified setup we are using for evaluation purposes, it may be  neces-
sary to press a key on the keyboard to wake up the host.

All  keystrokes entered at the DOS PC are sent to the host  Terminal  Man-
ager  computer with the exception of the key combinations used for  exiting
back to DOS :-

  CTRL+ALT+END
  CTRL+ALT+ENTER
  CTRL+ALT+BS

CTRL+ALT+END  and CTRL+ALT+ENTER are treated by  TERM  as
the  command  to  drop  the RS232 signals and exit  back  to  DOS.   If  the
correct  cable  type  were being used, the effect  of  dropping  these  signals
would  cause  Terminal Manager to terminate any processes running  at  the
terminal.  For the sake of simplicity in the Evaluation Edition, the  software
is  configured  to  use a very simple cable set-up that does  not  provide  the
host  with  the  signals it requires to indicate that  the  TERM  program  has
ended.

In  view  of  this, CTRL+ALT+BS should be used  to  exit  from  TERM.
This  keystroke  first  sends a special control sequence to the host  to  tell  it
that  TERM is exiting.  Exiting using this key sequence ensures that the  all
processes are properly closed.

I_M_P_O_R_T_A_N_T___N_O_T_E_:_   For the reasons described in the  Terminal  Man-
ager  -  Multi-User  OS/2 - Reference Manual, if TERM  does  not  connect
with the host computer, the CTRL+END key combination must be used  to
exit  from  the program instead of the CTRL+ALT  key  combinations  de-
scribed above.  As a general rule, try using the CTRL+ALT key  combina-
tions and if this fails, use the CTRL+END combination.


Terminal Manager - Evaluation Edition                    Page 13


Running TERM again after exiting will normally cause the OS/2  command
prompt  to reappear at the DOS PC.  However, in the  configuration  preset
in the Evaluation Edition and because you are probably using a simple cable
type  for  evaluation purposes, Terminal Manager will not  have  terminated
the  programs previously running on your terminal (unless you exited  using
CTRL+ALT+BS).   In this situation, TERM will connect directly into  the
previously active session.  To force a redisplay of the screen data  immedia-
tely after coming back into TERM, the following key combination must  be
pressed :-

  CTRL+HOME

This key sequence will normally force a redisplay of session 0 of your pre-
viously-active  group  of  sessions and you may  then  switch  to  whichever
session you wish to interact with.

As described later, the terminal operator is able to switch between  sessions
by pressing the CTRL+ESC and ALT+ESC key combinations.  If  TERM
is  running  in  an  OS/2 or Windows DOS Session,  the  alternate  key  se-
quences  below may be used to switch between sessions on the host  compu-
ter :-

  CTRL+ALT+LEFTSHIFT instead of CTRL+ESC
  CTRL+ALT+RIGHTSHIFT instead of ALT+ESC

The  alternate key sequences leave the original key sequences  available  for
switching between sessions on the PC on which the TERM program itself is
running.


-------------------------------------------
Starting New Sessions at the Terminal

Each terminal running under Terminal Manager is able to use multiple ses-
sions  in  much the same way as multiple sessions may be used on  the  host
computer itself.  The Evaluation Edition is configured to allow a  maximum
of eight concurrent sessions on the terminal attached to COM1.

The  first  session for each terminal, session 0, is  started  automatically  by
Terminal  Manager  when the terminal comes online;   session  0  normally
runs the shell program for the terminal.  Further sessions may be started by
using  the TSTART command at the OS/2 command prompt on the  termi-
nal.


Page 14                    Terminal Manager - Evaluation Edition


The  ALT+ESC key combination on the left of the terminal keyboard  ad-
vances from one session to the next.  The CTRL+ESC key combination on
the left of the terminal keyboard always selects session 0, normally the shell
program.   When  using the ALT+ESC or  CTRL+ESC  combination,  the
ALT  or CTRL key must be held down while the ESC key is pressed.   The
session switch occurs when the ESC key is released.  The key sequence  for
switching between session is :-

  1) press the left ALT (or left CTRL) key
  2) press the ESC key
  3) release the ESC key
  4) release the left ALT (or left CTRL) key

When  a  session terminates, session 0 is brought to the foreground  if  it  is
still  active,  otherwise  the  next highest  session  becomes  the  foreground
session.   When  the last session terminates, the terminal is put  offline,  ef-
fectively logging off the terminal.

The TSTART command may be used at the terminal to start a new terminal
session.   The TSTART command is similar to the standard  OS/2  START
command and has the following syntaxes :-

  TSTART ["session"] [/K | /C | /N]  [drive:][path]command[.ext] [options]

  TSTART ["session"] [/K | /C] "[drive:][path]command[.ext] [options]"

where  the  elements  within  '[...]'  are optional.   Only  one  of  the  three
switches  /K  /C  /N  may be specified in a  command;   if  no  switches  are
specified, the /K switch is assumed.

The following command starts an OS/2 session, running CMD.EXE, on the
terminal :-

  TSTART

The session will terminate when EXIT is typed.

-------------------------------------------
Running DOS Programs at the Terminal

Multi-User  DOS extends the capabilities of Terminal Manager  enabling  it
to  run DOS software on attached terminals.  The facility is  available  only
on computers able to run OS/2 version 2.0 or later.


Terminal Manager - Evaluation Edition                    Page 15


On a stand-alone OS/2 system, a DOS session may be started directly  from
an icon object in the Workplace Shell without the need to first start an OS/2
session.   Alternatively,  a  DOS  session may be  started  directly  from  an
already open parent OS/2 session.

On terminals, DOS sessions are a_l_w_a_y_s_ started from a parent OS/2  session.
When  the  program running in the DOS session terminates,  control  is  re-
turned to the OS/2 session.  The switch between DOS and OS/2 sessions  is
transparent  to the operator who need not be aware that anything  special  is
taking place.

Terminal  Manager's  ability  to  support multiple  OS/2  sessions  within  a
single  terminal  means that multiple DOS sessions may  therefore  be  con-
currently active at a terminal.

On a stand-alone OS/2 system, DOS sessions are started implicitly from  an
OS/2 session whenever the user types a DOS command.  Under Multi-User
DOS, more control is needed over the characteristics of the DOS  program,
thus  necessitating  a different approach.  The Terminal  Manager  -  Multi-
User DOS - Reference Manual discusses why this extra control is necessary
in a multi-user environment.

In  order  to provide a mechanism to exercise the  necessary  control,  DOS
programs  are not executed directly from an OS/2 command  line.   Instead,
the OS/2 program RUNDOS is first executed.  RUNDOS allows the user to
specify the DOS command on the RUNDOS command line, for example :-

  RUNDOS C:\WP\WP.EXE DOCS

where  C:\WP\WP.EXE  DOCS  is the command line that  would  normally  have
been typed to run the DOS program.

Although  the  DOS  program must be started in this way,  it  can  be  made
transparent  to  the  user since, using the above example,  a  WP.CMD  file
could be created which would simulate the DOS command but would  ulti-
mately  call  RUNDOS with the relevant parameters.  Alternatively,  if  the
system  is  driven by menus, a menu choice could  execute  the  appropriate
RUNDOS command transparently to the operator.

The  example  above would execute the DOS program with  no  more  addi-
tional control than would have been available without the use of  RUNDOS.
The  additional power of RUNDOS is invoked by specifying a Settings  File
as the first parameter of the RUNDOS command, for example :-


Page 16                    Terminal Manager - Evaluation Edition


  RUNDOS /S WPSETNGS C:\WP\WP.EXE DOCS

where /S tells RUNDOS that a Settings File with the name WPSETNGS is to be
associated  with the WP.EXE program.  Again, the actual command  would
normally be invoked by a .CMD file or from a menu choice.

The  Terminal Manager - Multi-User DOS - Reference Manual describes  in
detail the options available in the Settings File.

If no DOS command line is specified for RUNDOS, a DOS session is  star-
ted with a DOS command prompt from which other DOS programs may  be
run;  the  EXIT  command  must then be used to return  back  to  the  OS/2
session.
































Terminal Manager - Evaluation Edition                    Page 17


-------------------------------------------
Pricing and Ordering Information

Terminal  Manager  licence  pricing is based on the  number  of  concurrent
users,  not on the number of communication adapter ports configured.   The
number  of  users is in addition to the operator of the host PC's  screen  and
keyboard.  As an example, a 4-user system might be configured to handle 8
terminals,  only  4  of  which are able to log on at any  one  time;  if  a  5th
terminal  attempts  to  log  on, it will be suspended until  one  of  the  other
terminals logs off.

The number of users may be upgraded at any time by replacing a single file
for  one supporting the required number of users.  The upgrade price is  the
difference between the two original package prices.

The  following  table details the package prices.  The Users  column  is  the
licensed number of concurrent users. Price is the total package price.

      Users  Price

      1      UK125 (US$200)
      4      UK245 (US$390)
      8      UK395 (US$630)
      16     UK595 (US$950)
      32     UK995 (US$1590)

A  fully-functional Evaluation Edition, complete with manuals, is  available
at  UK25 (US$40) and can be upgraded later for the just the  price  differ-
ence.

The  Multi-User  DOS  facility  is included in the  prices  listed  above  and
allows MSDOS programs to run on any of the terminals.

The  Qiiq  S-Link 4-port adapter for AT-bus (ISA) computers  may  be  or-
dered at a price of UK65 (US$105).

All  prices  quoted  are  exclusive of carriage  and  any  Value  Added  Tax
payable  (United  Kingdom only).  Purchasers within the  European  Union,
who are registered in their own country for Value Added Tax, should quote
their VAT registration number with the order.

Carriage is charged on a per-item basis where the Terminal Manager  soft-
ware is one item and the S-Link adapter is another item.  The item  carriage
price is as follows :-

Page 18                    Terminal Manager - Evaluation Edition


    UK      Europe    Outside Europe

    UK3    UK5      UK9 (US$15)

Any local taxes or import duties are the responsibility of the purchaser.

You may order the software, and any associated hardware, as follows: -

  '` by mail to -

      Qiiq Ltd
      Elm House
      17-19 Claygate Lane
      Thames Ditton
      Surrey
      KT7 0DL
      United Kingdom

  '` by voice telephone to +44 (0)181 339 0739

  '` by FAX to +44 (0)181 398 8443

We  accept  Visa and MasterCard credit cards in payment for  the  software
and any hardware ordered.

If you are paying by credit card, please quote the following -

  '` the name as shown on the card
  '` the card number
  '` the expiry date
  '` the address at which the cardholder is registered

Credit card payments will be billed in sterling and will be converted to your
own  currency  by your credit card company. The US dollar  prices  quoted
are  an approximate price, however, the sterling price will always be  adjus-
ted   to   maintain   the   approximate   US   dollar   price   at   the   current
sterling/dollar exchange rate.








Terminal Manager - Evaluation Edition                    Page 19















































Page 20                    Terminal Manager - Evaluation Edition


-------------------------------------------
Order Form

Purchase  Order  to Qiiq Ltd.   Please  supply  the
following to the shipment address overleaf :-

Qty  Product                 Unit Price       Price
                                UK     (Unit Price
                                             x Qty)
===  =======================  ========  ===========
     1-user Terminal Manager   125.00
     4-user Terminal Manager   245.00
     8-user Terminal Manager   395.00
     16-user Terminal Manager  595.00
     32-user Terminal Manager  995.00
     4-user Evaluation Edition  25.00
     S-Link 4-port adapter      65.00
     ==============================================
                          Total Goods
     Carriage x no. of items -
                     within UK   3.00
                        Europe   5.00
                outside Europe   9.00
                                      =============
                            Sub Total
   VAT @ 17.5% of sub-total (UK only)
                                      =============
                            TOTAL UK
                                      =============

I authorise you to charge the above total amount to
my VISA / MASTERCARD account as follows :-

Card number:

Cardholder name:

Cardholder address:



Expiry date:

Cardholder's signature:


Shipment Address
================

Name:

Organisation:

Address:

Address:

Address:

Address:

Town/City:

State/County/Province:

Zip/Post Code:

Country:





European Union Value Added Tax Registration  number
(if applicable):


