home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / multuser.zip / TMEVAL.TXT < prev    next >
Text File  |  1995-05-23  |  43KB  |  1,074 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.           Terminal Manager
  22.  
  23.       Multi-User OS/2 and DOS
  24.  
  25.          Evaluation Edition
  26.  
  27.             Version 3.20
  28.  
  29. The  Terminal  Manager  Evaluation Edition contains certain files which have
  30. been  packaged using  Info-ZIP's compression  utility.  The UNZIP.EXE program
  31. packaged with the software may be used to unzip  the  relevant files.  
  32. Info-ZIP's software (Zip, UnZip and related utilities) is free and can be 
  33. obtained as source code or  executables from various bulletin board services
  34. and anonymous-ftp sites, including CompuServe's IBMPRO  forum and 
  35. ftp.uu.net:/pub/archiving/zip/*.
  36. Terminal Manager is an unpublished work and is the copyright of Qiiq Ltd.
  37. The Terminal Manager software, and data, or documentation related thereto,
  38. and the information disclosed therein, are confidential and proprietary to 
  39. Qiiq Ltd and may be used only under the terms and conditions of a Licence
  40. Agreement from Qiiq Ltd.  Neither the software, regardless of the form in
  41. which it exists, nor such data, nor information,  may  be used or disclosed 
  42. to others for any purpose except as specifically authorised in  writing  by
  43. Qiiq Ltd.   The  recipient, by accepting the documentation or by utilising 
  44. the software, agrees to the  terms  and  conditions  of the Licence Agreement
  45. and agrees that neither the software, nor the documentation, nor the
  46. information disclosed  therein,  nor  any  part  thereof, shall be reproduced
  47. or transferred to  other  documents  nor  used  nor disclosed to others for 
  48. manufacturing or for any other purpose except as specifically authorised in 
  49. writing by  Qiiq Ltd.
  50. (c) Copyright 1990-1995  An unpublished work by Qiiq Ltd.
  51. All rights reserved.
  52. Terminal  Manager,  TermView,  TermPak and Qiiq are trademarks of Qiiq Ltd.
  53. All  other  trademarks  are  acknowledged.
  54. Qiiq Ltd, Elm House, 17-19 Claygate Lane, Thames Ditton, Surrey, KT7 0DL,
  55. United Kingdom
  56. Telephone +44 (0)181 339 0739 - FAX +44 (0)181 398 8443
  57. Email qiiq@cix.compulink.co.uk
  58.  
  59. -------------------------------------------
  60. Contents
  61.  
  62.  
  63. Introduction                         2
  64.  
  65.  
  66. Software Support                      3
  67.  
  68.  
  69. Overview of Terminal Manager              4
  70.  
  71.  
  72. Connecting the Terminal to the Host           5
  73.  
  74.  
  75. Installing the Host Terminal Manager Software      6
  76.  
  77.  
  78. Installing the TERM Software on a DOS PC        7
  79.  
  80.  
  81. Starting Terminal Manager at the Host          9
  82.  
  83.  
  84. Monitoring and Controlling Terminals at the Host    9
  85.  
  86.  
  87. Using TERM on the DOS PC                13
  88.  
  89.  
  90. Starting New Sessions at the Terminal          14
  91.  
  92.  
  93. Running DOS Programs at the Terminal          15
  94.  
  95.  
  96. Pricing and Ordering Information              18
  97.  
  98.  
  99. Order Form
  100.  
  101.  
  102.  
  103.  
  104. Terminal Manager - Evaluation Edition                    Page 1
  105.  
  106. -------------------------------------------
  107. Introduction
  108.  
  109. This  manual summarises the installation and use of the  Terminal  Manager
  110. 3.20 Evaluation Edition.
  111.  
  112. The  Evaluation  Edition  has been produced so that  prospective  users  can
  113. evaluate the features and facilities of Terminal Manager prior to purchasing
  114. the full package.  The software contained in the Evaluation Edition is a  full
  115. working version of Terminal Manager including the Multi-User DOS  facil-
  116. ity.  It is configured for use on a single terminal attached to the host compu-
  117. ter.   The only operational differences between the Evaluation  Edition  and
  118. the  full  Terminal  Manager package are a time  restriction  of  30  minutes
  119. operation  for  each  terminal, and, when the software loads,  a  message  is
  120. displayed  informing you that it is not a fully-licensed version.  There is  no
  121. date  restriction  placed  into the software, so  you  may  evaluate  Terminal
  122. Manager  at your leisure.  The 30 minute timeout restriction means that  all
  123. programs  running  at  a terminal will be terminated after  the  terminal  has
  124. been  active for 30 minutes;  the terminal will then come online again for  a
  125. further  30  minutes,  and  so forth.  You  should  remember  that  this  will
  126. happen  with the Evaluation Edition and you should not consider it to  be  a
  127. bug.
  128.  
  129. When you have completed your evaluation, you may order the full  package
  130. for  the required number of terminals.  If you decide that the software  does
  131. not  fit  your requirements, simply destroy the Evaluation  Edition  together
  132. with  all  copies  of the software you may have installed  on  your  systems.
  133. You  are  permitted to use the Evaluation Edition only for  evaluation  pur-
  134. poses.   You may not use the software supplied with the Evaluation  Edition
  135. for productive use.
  136.  
  137. The  documentation that comes with the full package comprises  190  pages
  138. covering  the  base  Terminal Manager Multi-User OS/2  features,  with  an
  139. additional  48  pages  covering the Multi-User DOS  facility.   Clearly,  we
  140. have  had  to  omit  a great deal of detail from  this  manual,  however,  we
  141. believe  that the information supplied is sufficient to give you a feel for  the
  142. power of Terminal Manager.
  143.  
  144. If  you wish to evaluate the product further, ASCII versions of the  manuals
  145. that are supplied with the full package are supplied as part of the Evaluation
  146. Edition.   If  you  purchased  your copy of the  Evaluation  Edition,  it  will
  147. contain  pre-printed  copies  of the manuals below, so you  do  not  need  to
  148. print  the ASCII versions of the manual.
  149.  
  150.  
  151. Page 2                    Terminal Manager - Evaluation Edition
  152.  
  153.   '` TMREFMAN.TXT is   the  main  reference   manual,   Terminal
  154.                  Manager   -  Multi-User  OS/2  -   Reference
  155.                  Manual,  which  covers the  base  multi-user
  156.                  OS/2 operation.
  157.   '` TMDOSMAN.TXT is  the  manual, Terminal Manager  -  Multi-
  158.                  User  -  DOS Reference Manual,  which  de-
  159.                  scribes the Multi-User DOS facility.
  160.  
  161. The  ASCII  versions of the manuals are compressed into a  Zip  file  called
  162. MANUALS.ZIP.   This file may be unzipped using the  UNZIP.EXE  pro-
  163. gram  supplied.   The following command, used in  the  Evaluation  Edition
  164. directory or the directory into which Terminal Manager has been  installed,
  165. will unzip the files :-
  166.  
  167.   UNZIP MANUALS
  168.  
  169. The  manuals  may  be printed on any standard ASCII printer.   If  you  are
  170. printing  onto  A4  or Quarto sized paper, you should  select  a  font  which
  171. prints  at  12 characters per inch or more to ensure that the entire  width  of
  172. the  page is printed.  Much of the formatting of the manuals is unable to  be
  173. represented  in the ASCII version, however, the manuals supplied  with  the
  174. full  package are attractively formatted and printed, and are much easier  to
  175. use than the ASCII versions.
  176.  
  177. If  you  downloaded this Evaluation Edition from a BBS or  the  Internet  or
  178. obtained  it  from  some  other source,  you  may  purchase  the  Evaluation
  179. Edition,  complete  with  printed  manuals, for  UK£25  (US$40).   See  the
  180. Pricing and Ordering Information section of this manual for further details.
  181.  
  182. -------------------------------------------
  183. Software Support
  184.  
  185. Electronic  support  is provided free-of-charge for the lifetime  of  the  pro-
  186. duct.   If  you  have any problems installing or using  the  software,  simply
  187. send us full details of the problem you are encountering.  We will  acknow-
  188. ledge receipt of your problem report generally within 24 hours and in  most
  189. cases  will  provide the answer at the same time.  More  complex  problems
  190. may take a little longer.
  191.  
  192. Problem reports may be sent in the following ways :-
  193.  
  194.   '` via FAX to +44 (0) 181 398 8443
  195.   '` via Internet Email to qiiq@cix.compulink.co.uk
  196.   '` via our Bulletin Board System (BBS) on +44 (0) 181 398 0266
  197.  
  198. Terminal Manager - Evaluation Edition                    Page 3
  199.  
  200. All  problem reports should include your name and full  address,  telephone
  201. number, FAX number and, where appropriate, your Email address.   Ack-
  202. nowledgements and responses are sent via the same medium as the  original
  203. problem report.
  204.  
  205. The  BBS  is  operational 24 hours a day and supports transfer  rates  up  to
  206. 14,400  baud.   The  BBS supports modems  conforming  to  V22,  V22bis,
  207. V32, V32 bis, with V42 or MNP2-4 error correction, and V42bis or MNP5
  208. data  compression.   To ensure trouble-free connection, you  should  ensure
  209. that  your  communications software is set to operate at the  same  speed  at
  210. which  your  modem  connects to the BBS; if your modem  is  operating  at
  211. 14,400  baud,  you  should  set  your  communications  software  to  run  at
  212. 19,200 baud.  You should set your communications parameters to be 8 data
  213. bits, no parity, 1 stop bit.
  214.  
  215. -------------------------------------------
  216. Overview of Terminal Manager
  217.  
  218. This  section  gives a brief overview of the features of  Terminal  Manager.
  219.  
  220. The  Evaluation Edition contains the files OVERVIEW.TXT  and  OVER-
  221. VIEW.INF which give a more in-depth overview.  OVERVIEW.TXT is an
  222. ASCII  text  file  suitable for printing.  OVERVIEW.INF  may  be  viewed
  223. using  OS/2's  standard VIEW program.  To view the file from  the  Evalua-
  224. tion Edition diskette, type the following command :-
  225.  
  226.   VIEW A:OVERVIEW
  227.  
  228. Terminal Manager runs under OS/2 versions 1.1, 1.2, 1.3, 2.0, 2.1 and 3.0
  229. (Warp).   The Multi-User DOS facility requires OS/2 version 2.0  or  later.
  230. The software will run on Micro Channel Architecture (MCA) bus  systems;
  231. on IBM PC/AT or compatible systems using derivations of the AT bus; and
  232. on  Extended  Industry  Standard  Architecture  (EISA)  bus  systems.   The
  233. processor  may  be the Intel 80286, 80386SX, 80386, 80486SX,  80486  or
  234. Pentium.   The Multi-User DOS facility will not run on the  80286  proces-
  235. sor.
  236.  
  237. The  Evaluation  Edition  is configured to use the  host  computer's  COM1
  238. port. Terminal Manager actually supports COM1 - COM8 and a wide range
  239. of  multi-port  adapters, although the means of configuring them is  not  de-
  240. scribed in this manual.
  241.  
  242. Qiiq  supplies the low-cost S-Link 4-port adapter for AT bus  machines;  up
  243. to  three  S-Link  adapters  may be installed in  a  single  PC.   The  S-Link
  244.  
  245. Page 4                    Terminal Manager - Evaluation Edition
  246.  
  247. adapter is priced at UK£65 (US$105); see the Pricing and Ordering  Infor-
  248. mation section of this manual for further details.
  249.  
  250. Terminal Manager supports a range of terminal types, however, the Evalua-
  251. tion  Edition is pre-configured to use another computer as a  terminal.   The
  252. computer operating as a terminal uses the TERM program supplied with the
  253. software to emulate the operation of a dumb terminal.
  254.  
  255. The  programs which run at the terminals may be OS/2 protect  mode  pro-
  256. grams or DOS real mode programs.
  257.  
  258. In order to be able to run on terminals, both OS/2 and DOS programs  must
  259. be  text-mode programs.  These programs generally use  alphanumeric  text
  260. screens  with a limited graphics capability obtained by using  the  line-draw-
  261. ing  characters  in  the extended screen character set.   Any  OS/2  or  DOS
  262. program  which  uses graphics screen displays is probably  not  suitable  for
  263. terminal  operation.   OS/2 Presentation Manager programs are not  able  to
  264. be accessed from a terminal.
  265.  
  266. We  are unable to guarantee that all off-the-shelf OS/2 and  DOS  programs
  267. will  run  under  Terminal  Manager because  the  OS/2  Operating  System
  268. allows application programs to directly access the computer hardware as  an
  269. alternative to using operating system calls.  Any application program which
  270. accesses  the  screen,  keyboard or mouse hardware  directly  may  not  run
  271. properly under Terminal Manager.
  272.  
  273.  
  274. -------------------------------------------
  275. Connecting the Terminal to the Host
  276.  
  277. The Terminal Manager - Multi-User OS/2 - Reference Manual, details cable
  278. configurations  for  attaching  terminals  to the computer.   In  a  live,  non-
  279. evaluation situation, it is recommended that you use the correct cable confi-
  280. guration so that flow control of data between the computer and the  terminal
  281. can  be  used.  Additionally, the computer is able to detect  terminals  being
  282. switched  on and off if the correct cable is used.  In the Evaluation  Edition,
  283. the  installed  TRMMAN.INI  file sets COM1 to operate with  just  a  basic
  284. cable  with  Signal  Ground, Transmit Data  and  Receive  Data  connected,
  285. however, this cable is not able to detect a terminal being switched on or  off
  286. and  always  assumes  that a terminal is present and ready  to  receive  data.
  287. The following diagram shows how the basic cable should be wired :-
  288.  
  289.  
  290.  
  291.  
  292. Terminal Manager - Evaluation Edition                    Page 5
  293.  
  294.       Computer         Terminal
  295.  
  296.         TD  -----------------------> RD
  297.         RD  <----------------------- TD
  298.         SG  ------------------------ SG
  299.  
  300. The  following  table  gives the pin numbers  corresponding  to  the  RS232
  301. names for 9-way and 25-way connectors :-
  302.  
  303.   Name   25-way Pin   9-way Pin   Function
  304.  
  305.   TD      2           3           Transmit Data
  306.   RD      3           2           Receive Data
  307.   SG      7           5           Signal Ground
  308.  
  309. If  you have a null-modem cable, this may generally be used to connect  the
  310. terminal  for evaluation purposes.  If you are unable to acquire or build  the
  311. required  cable, please contact us and we will be able to supply one  at  cost
  312. price.
  313.  
  314. -------------------------------------------
  315. Installing the Host Terminal Manager Software
  316.  
  317. Terminal  Manager  operation is controlled by statements contained  in  the
  318. TRMMAN.INI  file installed with the software.  The file may be  modified
  319. to  reflect your configuration in respect of communication adapters,  termi-
  320. nals  and  many  other  options.   After  installing  the  Evaluation  Edition,
  321. TRMMAN.INI is set up for a configuration of one terminal attached to  the
  322. COM1  port.  For evaluation purposes, it is recommended that you use  this
  323. preset configuration.
  324.  
  325. I_M_P_O_R_T_A_N_T__N_O_T_E_:_  If you already have Terminal Manager installed on
  326. your  computer, you should make a backup of the Terminal Manager  direc-
  327. tory  TRMMAN  and  its subdirectories since  the  Evaluation  Edition  will
  328. install  over the top of the existing software and you may lose your  existing
  329. TRMMAN.INI, PMS.INI and TRMMAN.OPT files.
  330.  
  331. If  the  Evaluation Edition was downloaded from a BBS or  the  Internet  or
  332. from some other source, it will usually be contained in a zipped file  named
  333. MULTUSER.ZIP.   You should unzip the file onto a diskette before  instal-
  334. ling  the  software.   If you have already unzipped the file into  a  hard  disk
  335. directory, you may perform the installation from that directory.
  336.  
  337. The Terminal Manager installation program must be started from the  OS/2
  338.  
  339. Page 6                    Terminal Manager - Evaluation Edition
  340.  
  341. command prompt in a full-screen session.  Refer to the OS/2 documentation
  342. and the OS/2 online help for details on how to start a full-screen session.
  343.  
  344. If  the  Evaluation Edition is on diskette, the diskette must be  inserted  into
  345. the  diskette  drive,  usually drive A, and the following  command  must  be
  346. entered at the command prompt :-
  347.  
  348.   A:TINSTALL
  349.  
  350. If  the  Evaluation  Edition  was unzipped into a  hard  disk  directory,  you
  351. should  change  to  that directory to make it the default and  then  enter  the
  352. following at the command prompt :-
  353.  
  354.   TINSTALL
  355.  
  356. TINSTALL  copies  the Terminal Manager files from the  diskette  or  hard
  357. disk  directory  into  the  TRMMAN directory of the  boot  drive  and  then
  358. modifies  or  adds  certain statements to the CONFIG.SYS file  in  the  root
  359. directory of the boot drive.
  360.  
  361. The  Evaluation Edition also contains the optional Multi-User  DOS  facility
  362. which  will be installed by the TINSTALL program if you are installing  on
  363. to a system containing OS/2 2.0 or later.
  364.  
  365. When  TINSTALL has successfully completed, t_h_e__c_o_m_p_u_t_e_r__m_u_s_t__b_e___r_e_-_
  366. 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_._
  367.  
  368. The  TINSTALL program does not make any changes to the PATH  state-
  369. ment  in  CONFIG.SYS.  If you wish to access any of the programs  in  the
  370. TRMMAN directory whilst logged into other drives or directories, you will
  371. need to ensure that the TRMMAN directory is included in the PATH state-
  372. ment; this may be achieved either by setting it in CONFIG.SYS or by using
  373. the SET command, possibly in a batch file.
  374.  
  375. -------------------------------------------
  376. Installing the TERM Software on a DOS PC
  377.  
  378. The  Terminal Manager software includes the TERM.EXE program  which
  379. allows a DOS-based personal computer (PC) to be attached to the  Terminal
  380. Manager  host  in place of a standard terminal.  The  TERM  program  will
  381. also run in a DOS session under OS/2 or Windows.
  382.  
  383. On  the DOS PC, the TERM program is used to establish the connection  to
  384. the  Terminal  Manager host allowing the PC to function as a  terminal.   In
  385.  
  386. Terminal Manager - Evaluation Edition                    Page 7
  387.  
  388. the  Evaluation Edition, TERM is pre-configured to use the COM1 port  on
  389. the  DOS PC and, both the host software and the TERM program  are  pre-
  390. configured to run at 9600 baud.  In practice, terminals and DOS PCs would
  391. often be configured to operate at higher speeds.
  392.  
  393. Once  the DOS PC is connected and operating as a terminal, it functions  in
  394. all  respects  the  same as a standard terminal with the  added  capability  of
  395. being  able to display colour output if an application program uses it  and  if
  396. the  PC  has  a colour screen.  In addition, the PC  may  participate  in  file
  397. transfer operations to and from the host Terminal Manager computer.
  398.  
  399. If the Evaluation Edition was unzipped into a hard disk directory, you  must
  400. create a diskette to be used for installing the TERM software onto the  DOS
  401. PC  that  is  to  be used as the terminal.  To  copy  the  files  onto  diskette,
  402. change to the directory where the Evaluation Edition is and type the follow-
  403. ing command at the OS/2 command prompt :-
  404.  
  405.   COPY TERM*.* n:
  406.  
  407. where n: is your diskette drive (normally A:).
  408.  
  409. If  the  Evaluation Edition is on diskette, you need not create  a  diskette  to
  410. install  the TERM software since you may install directly from  the  Evalua-
  411. tion Edition diskette.
  412.  
  413. The  TERM  software is installed on to the DOS PC by running  the  install
  414. batch procedure TERMINST.BAT which copies the required files from the
  415. diskette.   TERMINST.BAT copies the files into the current  default  direc-
  416. tory   from   either   drive   A:   or   drive   B:.    The   command   to   run
  417. TERMINST.BAT is as follows :-
  418.  
  419.   n:TERMINST n:
  420.  
  421. where  n:  is the drive containing the Terminal Manager diskette, that  is  to
  422. say, A: or B:.
  423.  
  424. The following sample commands create a sub-directory called  TRMTERM
  425. on  drive  C: and run the TERMINST.BAT procedure to  copy  the  TERM
  426. files into that sub-directory :-
  427.  
  428.   C:             to make drive C: the default drive
  429.   MD \TRMTERM    to create the directory TRMTERM
  430.   CD \TRMTERM    to make the new directory the default
  431.   A:TERMINST A:  to copy the TERM files
  432.  
  433. Page 8                    Terminal Manager - Evaluation Edition
  434.  
  435. -------------------------------------------
  436. Starting Terminal Manager at the Host
  437.  
  438. Before the terminal is able to be used, the Terminal Manager software must
  439. be started on the host computer.
  440.  
  441. Terminal Manager may be started directly from the command line of a full-
  442. screen  text-mode  session or may be included in a menu  in  a  Presentation
  443. Manager window.  Alternatively, you may start Terminal Manager automa-
  444. tically  when the computer is initially loaded by placing the relevant  state-
  445. ments  in  the OS/2 startup initialisation batch file  STARTUP.CMD.   For
  446. evaluation purposes, the simplest way of starting Terminal Manager is from
  447. a command prompt.  To start Terminal Manager from a command  prompt,
  448. a full-screen session must first be started.  Refer to the OS/2 documentation
  449. and  the  OS/2 online help for information on starting  an  OS/2  full-screen
  450. session.
  451.  
  452. Once  in the full-screen session, Terminal Manager may be started  directly
  453. from  the  TRMMAN  directory created during the installation  of  the  host
  454. software.   The  following commands assume that  Terminal  Manager  was
  455. installed on drive C.  The current default drive is first set to be drive C and
  456. the current directory is changed to the TRMMAN directory before  entering
  457. the START command which starts Terminal Manager :-
  458.  
  459.   START "Terminal Manager" /N TM
  460.  
  461. -------------------------------------------
  462. Monitoring And Controlling Terminals at the Host
  463.  
  464. Shortly  after  loading, Terminal Manager displays the  TermView  control
  465. screen.  TermView provides two screen panels, one for displaying terminal
  466. status, the other for displaying activity log records.  An action bar is provi-
  467. ded with each of the panels for performing control functions.
  468.  
  469. Monitoring Terminal Status
  470.  
  471. The  first  panel  displayed after Terminal Manager  loads  is  the  Terminal
  472. Status screen.
  473.  
  474. Details  of  each terminal configured are displayed on a single  screen  line;
  475. since  only  one  terminal is configured for the Evaluation  Edition,  only  a
  476. single line will be displayed.
  477.  
  478. The following information is provided for each terminal :-
  479.  
  480. Terminal Manager - Evaluation Edition                    Page 9
  481.  
  482.   Term    specifies  the  logical  terminal  number  assigned  to   the
  483.           terminal.
  484.   Port    specifies  the logical port number to which the terminal  is
  485.           connected.
  486.   Location  describes  the  location  or some other  description  of  the
  487.           terminal.
  488.   Fgd    specifies  which session is currently in the  foreground  on
  489.           the terminal, session 0 being the first session.
  490.   Act    specifies the number of active sessions on the terminal.
  491.   Max    specifies the maximum number of sessions configured  for
  492.           the terminal.
  493.   Status   specifies the current status of the terminal and may be one
  494.           of the following :-
  495.  
  496.           Inactive  indicates  that  the  terminal  is  inactive  and
  497.                  will be ignored by Terminal Manager should
  498.                  it come online.
  499.           Failed   indicates  that  the terminal is in  an  inactive
  500.                  state because errors occurred while  attempt-
  501.                  ing to run the shell program for the terminal.
  502.           Offline  indicates  that  the  terminal is  active  but  is
  503.                  currently    offline,   either   because   it    is
  504.                  switched  off  or because no  connection  has
  505.                  been made to a modem attached to the port.
  506.           Bidding  indicates  that  the terminal is  online  and  is
  507.                  bidding  for  access to the computer.   If  the
  508.                  number  of users currently connected  to  the
  509.                  computer  is less than the  number  licensed,
  510.                  the bid will be immediately accepted and the
  511.                  shell  program will be run.  If the  maximum
  512.                  number   of  users  is  currently  active,   the
  513.                  terminal  will  remain  in  the  bidding   state
  514.                  until  one of the users disconnects  from  the
  515.                  computer.
  516.           Online   indicates that the terminal is currently online
  517.                  and   running  either  the  shell  program   or
  518.                  application programs.
  519.  
  520.  
  521. TermView Commands
  522.  
  523. The  F10 key takes the operator onto the action bar and highlights  the  first
  524. of  the  action  bar  choices.  The cursor left  and  cursor  right  keys  move
  525. between  action  bar choices. The cursor down key or the ENTER  may  be
  526.  
  527. Page 10                    Terminal Manager - Evaluation Edition
  528.  
  529. pressed  to display the pull-down menu for the currently  highlighted  action
  530. bar choice.  To move from the action bar back to the panel area, the F10 or
  531. the ESC key may be pressed.
  532.  
  533. As  an alternative to using the cursor keys to select an action bar  item,  the
  534. letter  highlighted  in  the  action bar may be pressed after  the  F10  key  to
  535. immediately pull down the selected action bar menu.
  536.  
  537. When  a pull-down menu is displayed, the cursor up and cursor down  keys
  538. may  be  used  to move between menu choices.  Pressing  the  ENTER  key
  539. selects the currently highlighted option from the pull-down menu.
  540.  
  541. As  an  alternative to using the cursor keys and the ENTER key,  an  option
  542. may be selected from a pull-down menu by entering the letter highlighted in
  543. the menu item.
  544.  
  545. Pressing  the  F10 or the ESC key while the pull-down  menu  is  displayed
  546. moves back onto the action bar choices.  Pressing the cursor right or cursor
  547. left  keys while the pull-down menu is displayed displays the adjacent  pull-
  548. down menu.
  549.  
  550. The Terminal Status Panel - 'Action' Pull-Down Menu
  551.  
  552. The Actions pull-down menu in the Terminal Status panel offers three menu
  553. choices :-
  554.  
  555.   A_ctivate the terminal
  556.         Activates the currently selected terminal allowing  Termi-
  557.           nal  Manager  to  load  the  shell  program  whenever  the
  558.           terminal is detected as being online.
  559.   D_eactivate the terminal
  560.         Deactivates  the terminal.  Terminal Manager will  termi-
  561.           nate all programs and sessions running in the terminal.
  562.   L_og the terminal off
  563.         Terminal  Manager  will terminate all programs  and  ses-
  564.           sions  running  in the terminal.  When all  programs  have
  565.           terminated,   the  RS232  signals  DTR   (Data   Terminal
  566.           Ready) and RTS (Request To Send) are turned off for one
  567.           second  in order to disconnect any modem attached to  the
  568.           port.  When Terminal Manager detects that the terminal is
  569.           online  again, the shell program will be run in  the  termi-
  570.           nal.   This  action has the effect of logging a user  off  the
  571.           system and forcing a new logon.
  572.  
  573.  
  574. Terminal Manager - Evaluation Edition                    Page 11
  575.  
  576. The Terminal Status Panel - 'Display' Pull-Down Menu
  577.  
  578. The  Display pull-down menu in the Terminal Status panel offers two  menu
  579. choices :-
  580.  
  581.   Display All L_og Records
  582.         Switches  to  the Log Records panel and  displays  the  log
  583.           records  for all terminals and all  non-terminal-related  log
  584.           records.
  585.   Display T_erminal Log Records
  586.         Switches  to the Log Records panel and displays  only  the
  587.           log records for the currently selected terminal.
  588.  
  589. The Terminal Status Panel - 'Exit' Pull-Down Menu
  590.  
  591. The Exit pull-down menu in the Terminal Status panel offers two choices :-
  592.  
  593.   Ex_it the program
  594.         Causes Terminal Manager to terminate and return  control
  595.           to the point in OS/2 from where it was started;  this might
  596.           be the command prompt or a Presentation Manager  menu
  597.           window.   Terminal  Manager  will not  perform  the  exit
  598.           command unless all terminals are currently in the inactive
  599.           state.
  600.   D_eactivate All Terminals
  601.         This  option deactivates all terminals as though  individual
  602.           Deactivate  commands had been issued for each  terminal.
  603.           The  command  is intended for use as a means  of  closing
  604.           down the system prior to exiting.
  605.  
  606. Closing Down Terminal Manager
  607.  
  608. Before exiting from Terminal Manager, you should ensure that all terminals
  609. have  exited  from any application programs and are back in the  shell  pro-
  610. gram.  For the Evaluation Edition, the shell program is the OS/2  command
  611. prompt.
  612.  
  613. Terminal  Manager  will not allow the operator to exit unless  all  terminals
  614. have been deactivated and are in the inactive state.  Terminals can be  deac-
  615. tivated  individually  using  the  Actions pull-down  menu  of  the  Terminal
  616. Status panel.  Alternatively, the Exit pull-down menu of the Terminal Status
  617. and  Log  Records  panels  allows a deactivate command  to  be  sent  to  all
  618. terminals.
  619.  
  620.  
  621. Page 12                    Terminal Manager - Evaluation Edition
  622.  
  623. Once  all terminals are in the inactive state, the Exit the program  option  of
  624. the Exit pull-down will terminate Terminal Manager operation.
  625.  
  626.  
  627. -------------------------------------------
  628. Using TERM on the DOS PC
  629.  
  630. TERM  is  started by typing the command 'TERM' while  in  the  directory
  631. into which the TERM files were installed.
  632.  
  633. TERM  then connects to the host Terminal Manager computer and is  ready
  634. for use.  The terminal should show an OS/2 command prompt.  Because  of
  635. the simplified setup we are using for evaluation purposes, it may be  neces-
  636. sary to press a key on the keyboard to wake up the host.
  637.  
  638. All  keystrokes entered at the DOS PC are sent to the host  Terminal  Man-
  639. ager  computer with the exception of the key combinations used for  exiting
  640. back to DOS :-
  641.  
  642.   CTRL+ALT+END
  643.   CTRL+ALT+ENTER
  644.   CTRL+ALT+BS
  645.  
  646. CTRL+ALT+END  and CTRL+ALT+ENTER are treated by  TERM  as
  647. the  command  to  drop  the RS232 signals and exit  back  to  DOS.   If  the
  648. correct  cable  type  were being used, the effect  of  dropping  these  signals
  649. would  cause  Terminal Manager to terminate any processes running  at  the
  650. terminal.  For the sake of simplicity in the Evaluation Edition, the  software
  651. is  configured  to  use a very simple cable set-up that does  not  provide  the
  652. host  with  the  signals it requires to indicate that  the  TERM  program  has
  653. ended.
  654.  
  655. In  view  of  this, CTRL+ALT+BS should be used  to  exit  from  TERM.
  656. This  keystroke  first  sends a special control sequence to the host  to  tell  it
  657. that  TERM is exiting.  Exiting using this key sequence ensures that the  all
  658. processes are properly closed.
  659.  
  660. I_M_P_O_R_T_A_N_T___N_O_T_E_:_   For the reasons described in the  Terminal  Man-
  661. ager  -  Multi-User  OS/2 - Reference Manual, if TERM  does  not  connect
  662. with the host computer, the CTRL+END key combination must be used  to
  663. exit  from  the program instead of the CTRL+ALT  key  combinations  de-
  664. scribed above.  As a general rule, try using the CTRL+ALT key  combina-
  665. tions and if this fails, use the CTRL+END combination.
  666.  
  667.  
  668. Terminal Manager - Evaluation Edition                    Page 13
  669.  
  670. Running TERM again after exiting will normally cause the OS/2  command
  671. prompt  to reappear at the DOS PC.  However, in the  configuration  preset
  672. in the Evaluation Edition and because you are probably using a simple cable
  673. type  for  evaluation purposes, Terminal Manager will not  have  terminated
  674. the  programs previously running on your terminal (unless you exited  using
  675. CTRL+ALT+BS).   In this situation, TERM will connect directly into  the
  676. previously active session.  To force a redisplay of the screen data  immedia-
  677. tely after coming back into TERM, the following key combination must  be
  678. pressed :-
  679.  
  680.   CTRL+HOME
  681.  
  682. This key sequence will normally force a redisplay of session 0 of your pre-
  683. viously-active  group  of  sessions and you may  then  switch  to  whichever
  684. session you wish to interact with.
  685.  
  686. As described later, the terminal operator is able to switch between  sessions
  687. by pressing the CTRL+ESC and ALT+ESC key combinations.  If  TERM
  688. is  running  in  an  OS/2 or Windows DOS Session,  the  alternate  key  se-
  689. quences  below may be used to switch between sessions on the host  compu-
  690. ter :-
  691.  
  692.   CTRL+ALT+LEFTSHIFT instead of CTRL+ESC
  693.   CTRL+ALT+RIGHTSHIFT instead of ALT+ESC
  694.  
  695. The  alternate key sequences leave the original key sequences  available  for
  696. switching between sessions on the PC on which the TERM program itself is
  697. running.
  698.  
  699.  
  700. -------------------------------------------
  701. Starting New Sessions at the Terminal
  702.  
  703. Each terminal running under Terminal Manager is able to use multiple ses-
  704. sions  in  much the same way as multiple sessions may be used on  the  host
  705. computer itself.  The Evaluation Edition is configured to allow a  maximum
  706. of eight concurrent sessions on the terminal attached to COM1.
  707.  
  708. The  first  session for each terminal, session 0, is  started  automatically  by
  709. Terminal  Manager  when the terminal comes online;   session  0  normally
  710. runs the shell program for the terminal.  Further sessions may be started by
  711. using  the TSTART command at the OS/2 command prompt on the  termi-
  712. nal.
  713.  
  714.  
  715. Page 14                    Terminal Manager - Evaluation Edition
  716.  
  717. The  ALT+ESC key combination on the left of the terminal keyboard  ad-
  718. vances from one session to the next.  The CTRL+ESC key combination on
  719. the left of the terminal keyboard always selects session 0, normally the shell
  720. program.   When  using the ALT+ESC or  CTRL+ESC  combination,  the
  721. ALT  or CTRL key must be held down while the ESC key is pressed.   The
  722. session switch occurs when the ESC key is released.  The key sequence  for
  723. switching between session is :-
  724.  
  725.   1) press the left ALT (or left CTRL) key
  726.   2) press the ESC key
  727.   3) release the ESC key
  728.   4) release the left ALT (or left CTRL) key
  729.  
  730. When  a  session terminates, session 0 is brought to the foreground  if  it  is
  731. still  active,  otherwise  the  next highest  session  becomes  the  foreground
  732. session.   When  the last session terminates, the terminal is put  offline,  ef-
  733. fectively logging off the terminal.
  734.  
  735. The TSTART command may be used at the terminal to start a new terminal
  736. session.   The TSTART command is similar to the standard  OS/2  START
  737. command and has the following syntaxes :-
  738.  
  739.   TSTART ["session"] [/K | /C | /N]  [drive:][path]command[.ext] [options]
  740.  
  741.   TSTART ["session"] [/K | /C] "[drive:][path]command[.ext] [options]"
  742.  
  743. where  the  elements  within  '[...]'  are optional.   Only  one  of  the  three
  744. switches  /K  /C  /N  may be specified in a  command;   if  no  switches  are
  745. specified, the /K switch is assumed.
  746.  
  747. The following command starts an OS/2 session, running CMD.EXE, on the
  748. terminal :-
  749.  
  750.   TSTART
  751.  
  752. The session will terminate when EXIT is typed.
  753.  
  754. -------------------------------------------
  755. Running DOS Programs at the Terminal
  756.  
  757. Multi-User  DOS extends the capabilities of Terminal Manager  enabling  it
  758. to  run DOS software on attached terminals.  The facility is  available  only
  759. on computers able to run OS/2 version 2.0 or later.
  760.  
  761.  
  762. Terminal Manager - Evaluation Edition                    Page 15
  763.  
  764. On a stand-alone OS/2 system, a DOS session may be started directly  from
  765. an icon object in the Workplace Shell without the need to first start an OS/2
  766. session.   Alternatively,  a  DOS  session may be  started  directly  from  an
  767. already open parent OS/2 session.
  768.  
  769. On terminals, DOS sessions are a_l_w_a_y_s_ started from a parent OS/2  session.
  770. When  the  program running in the DOS session terminates,  control  is  re-
  771. turned to the OS/2 session.  The switch between DOS and OS/2 sessions  is
  772. transparent  to the operator who need not be aware that anything  special  is
  773. taking place.
  774.  
  775. Terminal  Manager's  ability  to  support multiple  OS/2  sessions  within  a
  776. single  terminal  means that multiple DOS sessions may  therefore  be  con-
  777. currently active at a terminal.
  778.  
  779. On a stand-alone OS/2 system, DOS sessions are started implicitly from  an
  780. OS/2 session whenever the user types a DOS command.  Under Multi-User
  781. DOS, more control is needed over the characteristics of the DOS  program,
  782. thus  necessitating  a different approach.  The Terminal  Manager  -  Multi-
  783. User DOS - Reference Manual discusses why this extra control is necessary
  784. in a multi-user environment.
  785.  
  786. In  order  to provide a mechanism to exercise the  necessary  control,  DOS
  787. programs  are not executed directly from an OS/2 command  line.   Instead,
  788. the OS/2 program RUNDOS is first executed.  RUNDOS allows the user to
  789. specify the DOS command on the RUNDOS command line, for example :-
  790.  
  791.   RUNDOS C:\WP\WP.EXE DOCS
  792.  
  793. where  C:\WP\WP.EXE  DOCS  is the command line that  would  normally  have
  794. been typed to run the DOS program.
  795.  
  796. Although  the  DOS  program must be started in this way,  it  can  be  made
  797. transparent  to  the  user since, using the above example,  a  WP.CMD  file
  798. could be created which would simulate the DOS command but would  ulti-
  799. mately  call  RUNDOS with the relevant parameters.  Alternatively,  if  the
  800. system  is  driven by menus, a menu choice could  execute  the  appropriate
  801. RUNDOS command transparently to the operator.
  802.  
  803. The  example  above would execute the DOS program with  no  more  addi-
  804. tional control than would have been available without the use of  RUNDOS.
  805. The  additional power of RUNDOS is invoked by specifying a Settings  File
  806. as the first parameter of the RUNDOS command, for example :-
  807.  
  808.  
  809. Page 16                    Terminal Manager - Evaluation Edition
  810.  
  811.   RUNDOS /S WPSETNGS C:\WP\WP.EXE DOCS
  812.  
  813. where /S tells RUNDOS that a Settings File with the name WPSETNGS is to be
  814. associated  with the WP.EXE program.  Again, the actual command  would
  815. normally be invoked by a .CMD file or from a menu choice.
  816.  
  817. The  Terminal Manager - Multi-User DOS - Reference Manual describes  in
  818. detail the options available in the Settings File.
  819.  
  820. If no DOS command line is specified for RUNDOS, a DOS session is  star-
  821. ted with a DOS command prompt from which other DOS programs may  be
  822. run;  the  EXIT  command  must then be used to return  back  to  the  OS/2
  823. session.
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856. Terminal Manager - Evaluation Edition                    Page 17
  857.  
  858. -------------------------------------------
  859. Pricing and Ordering Information
  860.  
  861. Terminal  Manager  licence  pricing is based on the  number  of  concurrent
  862. users,  not on the number of communication adapter ports configured.   The
  863. number  of  users is in addition to the operator of the host PC's  screen  and
  864. keyboard.  As an example, a 4-user system might be configured to handle 8
  865. terminals,  only  4  of  which are able to log on at any  one  time;  if  a  5th
  866. terminal  attempts  to  log  on, it will be suspended until  one  of  the  other
  867. terminals logs off.
  868.  
  869. The number of users may be upgraded at any time by replacing a single file
  870. for  one supporting the required number of users.  The upgrade price is  the
  871. difference between the two original package prices.
  872.  
  873. The  following  table details the package prices.  The Users  column  is  the
  874. licensed number of concurrent users. Price is the total package price.
  875.  
  876.       Users  Price
  877.  
  878.       1      UK£125 (US$200)
  879.       4      UK£245 (US$390)
  880.       8      UK£395 (US$630)
  881.       16     UK£595 (US$950)
  882.       32     UK£995 (US$1590)
  883.  
  884. A  fully-functional Evaluation Edition, complete with manuals, is  available
  885. at  UK£25 (US$40) and can be upgraded later for the just the  price  differ-
  886. ence.
  887.  
  888. The  Multi-User  DOS  facility  is included in the  prices  listed  above  and
  889. allows MSDOS programs to run on any of the terminals.
  890.  
  891. The  Qiiq  S-Link 4-port adapter for AT-bus (ISA) computers  may  be  or-
  892. dered at a price of UK£65 (US$105).
  893.  
  894. All  prices  quoted  are  exclusive of carriage  and  any  Value  Added  Tax
  895. payable  (United  Kingdom only).  Purchasers within the  European  Union,
  896. who are registered in their own country for Value Added Tax, should quote
  897. their VAT registration number with the order.
  898.  
  899. Carriage is charged on a per-item basis where the Terminal Manager  soft-
  900. ware is one item and the S-Link adapter is another item.  The item  carriage
  901. price is as follows :-
  902.  
  903. Page 18                    Terminal Manager - Evaluation Edition
  904.  
  905.     UK      Europe    Outside Europe
  906.  
  907.     UK£3    UK£5      UK£9 (US$15)
  908.  
  909. Any local taxes or import duties are the responsibility of the purchaser.
  910.  
  911. You may order the software, and any associated hardware, as follows: -
  912.  
  913.   '` by mail to -
  914.  
  915.       Qiiq Ltd
  916.       Elm House
  917.       17-19 Claygate Lane
  918.       Thames Ditton
  919.       Surrey
  920.       KT7 0DL
  921.       United Kingdom
  922.  
  923.   '` by voice telephone to +44 (0)181 339 0739
  924.  
  925.   '` by FAX to +44 (0)181 398 8443
  926.  
  927. We  accept  Visa and MasterCard credit cards in payment for  the  software
  928. and any hardware ordered.
  929.  
  930. If you are paying by credit card, please quote the following -
  931.  
  932.   '` the name as shown on the card
  933.   '` the card number
  934.   '` the expiry date
  935.   '` the address at which the cardholder is registered
  936.  
  937. Credit card payments will be billed in sterling and will be converted to your
  938. own  currency  by your credit card company. The US dollar  prices  quoted
  939. are  an approximate price, however, the sterling price will always be  adjus-
  940. ted   to   maintain   the   approximate   US   dollar   price   at   the   current
  941. sterling/dollar exchange rate.
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950. Terminal Manager - Evaluation Edition                    Page 19
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997. Page 20                    Terminal Manager - Evaluation Edition
  998.  
  999. -------------------------------------------
  1000. Order Form
  1001.  
  1002. Purchase  Order  to Qiiq Ltd.   Please  supply  the
  1003. following to the shipment address overleaf :-
  1004.  
  1005. Qty  Product                 Unit Price       Price
  1006.                                 UK£     (Unit Price
  1007.                                              x Qty)
  1008. ===  =======================  ========  ===========
  1009.      1-user Terminal Manager   125.00
  1010.      4-user Terminal Manager   245.00
  1011.      8-user Terminal Manager   395.00
  1012.      16-user Terminal Manager  595.00
  1013.      32-user Terminal Manager  995.00
  1014.      4-user Evaluation Edition  25.00
  1015.      S-Link 4-port adapter      65.00
  1016.      ==============================================
  1017.                           Total Goods
  1018.      Carriage x no. of items -
  1019.                      within UK   3.00
  1020.                         Europe   5.00
  1021.                 outside Europe   9.00
  1022.                                       =============
  1023.                             Sub Total
  1024.    VAT @ 17.5% of sub-total (UK only)
  1025.                                       =============
  1026.                             TOTAL UK£
  1027.                                       =============
  1028.  
  1029. I authorise you to charge the above total amount to
  1030. my VISA / MASTERCARD account as follows :-
  1031.  
  1032. Card number:
  1033.  
  1034. Cardholder name:
  1035.  
  1036. Cardholder address:
  1037.  
  1038.  
  1039.  
  1040. Expiry date:
  1041.  
  1042. Cardholder's signature:
  1043.  
  1044. Shipment Address
  1045. ================
  1046.  
  1047. Name:
  1048.  
  1049. Organisation:
  1050.  
  1051. Address:
  1052.  
  1053. Address:
  1054.  
  1055. Address:
  1056.  
  1057. Address:
  1058.  
  1059. Town/City:
  1060.  
  1061. State/County/Province:
  1062.  
  1063. Zip/Post Code:
  1064.  
  1065. Country:
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071. European Union Value Added Tax Registration  number
  1072. (if applicable):
  1073.  
  1074.