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 UKœ25 (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 UKœ65 (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 UKœ125 (US$200) 4 UKœ245 (US$390) 8 UKœ395 (US$630) 16 UKœ595 (US$950) 32 UKœ995 (US$1590) A fully-functional Evaluation Edition, complete with manuals, is available at UKœ25 (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 UKœ65 (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 UKœ3 UKœ5 UKœ9 (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):