NetOp for OS/2 Version 5.0 UK User's Guide Please send any comments to: Danware Data A/S Herlev Hovedgade 195 DK-2730 Herlev Denmark Fax: int + 45 44 53 15 51 Internet: dadajoli@inet.uni-c.dk WARRANTY Danware Data A/S makes no guarantees with respect to the evaluation copy. DISCLAIMER Danware Data A/S denies any and all responsibility for damages caused directly or indirectly as a result of any faults with the enclosed programs and/or documentation. LICENSE Danware Data A/S retains the copyright to the user manual and the programs on the enclosed diskettes. Your evaluation copy gives you the right to copy and use the programs for a limited period only. Furthermore, you may not use the programs in production, but only for test purposes to verify that the software will work in your environment. At the end of the evaluation period, you must either purchase the software, or destroy all copies you might have made. TRADEMARKS NetOp is a registered trademarks of Danware Data A/S. All other products mentioned in this manual are trademarks of their respective manufacturers. THE NETOP FAMILY NetOp is a family of remote control products which support multiple operating systems and various communication interfaces. NetOp for OS/2 version 5 The new generation of Danware OS/2 to OS/2 remote control. Supports multiple protocols in one package - IPX, NetBIOS, Serial (Modem), APPC and TCP/IP. Utilizes a new advanced Danware communication engine. Includes advanced features such as integrated file transfer, bi-directional file transfer, non-polling communication architecture, and support for high resolution graphics. NetOp for OS/2 version 5 is backwards compatible with RemPCs version 4.30, protecting your previous investment in NetOp technology, and providing support for remote control of DOS and Windows PCs. NetOp Dial Modem remote control of DOS. Supports up to VGA + many SVGA (DOS). Tiny TSR, fast screen transfer and file transfer feature. NetOp Dial/2 Modem remote control of OS/2 from DOS. Supports graphics up to standard VGA. Remote control OS/2 from a less powerful DOS/Windows based portable or home computer. File transfer feature. NetOp ISDN Remote control of DOS/Windows over ISDN. NetOp ISDN supports any ISDN adapter with a CAPI 1.1 interface. Advanced file transfer feature. NetOp DOS/Win Network remote control of DOS and Windows from DOS/Windows. Supports NetBIOS and Novell/IPX network protocols. Incredible low memory requirement, only 3 to 6 KB of RAM. Peer to peer file transfer feature. NetOp DOS/Win/OS2 Network remote control of DOS, Windows and OS/2 from DOS/Windows. Supports NetBIOS and Novell/IPX network protocols. Incredible low memory requirement, only 3 to 6 KB of RAM. Supports standard VGA graphics for OS/2. Very fast screen updates of OS/2. Peer to peer file transfer feature. Other Should our current line of standard products not satisfy your needs, please let us have a word from you. If what you miss is not already planned for upcoming versions, the Danware expertise can be made available to do a customized solution for you. CONTENTS 1. INTRODUCTION 1.1 SUMMARY 1.2 WELCOME TO NETOP FOR OS/2 1.3 ABOUT THIS MANUAL 1.4 EXAMPLES OF USE 1.5 THE NETOP SYSTEM 1.6 USING THE NETOP PROGRAMS 1.6.1 The On-line Help System 2. INSTALLATION 2.1 SUMMARY 2.2 PREREQUISITE TASKS 2.2.1 Technical Requirements 2.2.2 Checking Your Package 2.3 INSTALLATION 2.3.1 Installing the Guest 2.3.2 Installing the Host 2.4 MANUAL INSTALLATION 2.4.1 Installing the Guest 2.4.2 Installing the Host 3. QUICK START 3.1 SUMMARY 3.2 THE HOST 3.3 THE GUEST 4. THE GUEST 4.1 SUMMARY 4.2 INTRODUCTION 4.2.1 Starting the Guest 4.2.2 The Guest Screen 4.3 CONFIGURATION 4.3.1 Communication Settings 4.3.2 Display Settings 4.3.3 Default Host Settings 4.3.4 Modem database 4.3.5 Modem dialog 4.3.6 Hotkey Assignments 4.3.7 Font Assignments 4.4 ESTABLISHING A SESSION 4.4.1 Host IDs 4.4.2 Calling a Host 4.4.3 Hang-up 4.5 HOST TABLES 4.5.1 Add Host 4.5.2 Build Host Table 4.5.3 Edit Host 4.5.4 Remove Host 4.5.5 Multiple Host Tables 4.5.6 Finding an Entry in the Host table 4.5.7 Miscellaneous 4.6 REMOTE CONTROL 4.6.1 Getting Started 4.6.2 Keyboard control 4.6.3 Mouse control 4.6.4 Lock Host Keyboard and Mouse 4.6.5 Boot Host 4.6.6 Chat with Host 4.6.7 Screen resolution 4.6.8 Zoom 4.6.9 Window manipulation 4.6.10 Hotkeys 4.6.11 File Transfer 4.7 COMMAND LINE OPTIONS 5. THE HOST 5.1 SUMMARY 5.2 STARTING THE HOST 5.2.1 From the desktop 5.2.2 From an OS/2 prompt 5.2.3 Automatically at Startup 5.2.4 Initialization 5.3 SETTING UP THE HOST 5.4 SECURITY 5.4.1 Maintenance Password 5.4.2 Guest Rights 5.4.3 Password 5.4.4 Confirm access 5.4.5 Call-back 5.5 ON-LINE CHOICES 5.5.1 Request Chat 5.5.2 Hangup 5.5.3 File Transfer 5.6 COMMAND LINE OPTIONS 6. PROTOCOLS 6.1 SERIAL/MODEM 6.1.1 Description 6.1.2 Configuration 6.1.3 Protocol Specific Settings 6.1.4 How to Define New Modems 6.1.5 Host ID format 6.2 NETBIOS 6.2.1 Description 6.2.2 Configuration 6.2.3 Protocol Specific Settings 6.2.4 Host ID format 6.2.5 NetOp resource needs 6.3 IPX 6.3.1 Description 6.3.2 Configuration 6.3.3 Protocol Specific Settings 6.3.4 Host ID format 6.3.5 NetOp ressource needs 6.4 TCP/IP 6.4.1 Description 6.4.2 Protocol Specific Settings 6.4.3 Host ID format 6.4.4 NetOp ressource needs 6.5 APPC 6.5.1 Description 6.5.2 Configuration 6.5.3 Host ID format 7. TROUBLESHOOTING 7.1 ANSWER TO COMMON PROBLEMS 7.2 NETOP ERROR MESSAGES 1. INTRODUCTION --------------- 1.1 SUMMARY ----------- This chapter gives a brief introduction to remote control, the NetOp products, examples of NetOp applications and an introduction to this manual. 1.2 WELCOME TO NETOP FOR OS/2 ----------------------------- Welcome to NetOp for OS/2, a Danware product for remote control of OS/2 over a wide variety of communication standards. NetOp for OS/2 will allow you to remote control any OS/2 PC. Over modems, LAN or WAN. By installing the guest software on a PC, that PC will be able to connect to, and remotely control, a PC which has the host software installed. The controlling PC, which is termed the guest, will show the screen of the controlled PC - the host. Keystrokes and mouse action will be transferred from the guest and executed on the host, screen updates will be transferred from the host to the guest. It is as if you were sitting in front of the controlled PC, even though it may be placed anywhere on the globe. NetOp for OS/2 contains advanced features, such as communication via multiple standards, non-polling communication architecture, integrated bi-directional file transfer and support for hi-resolution graphics. 1.3 ABOUT THIS MANUAL --------------------- This manual contains documentation for the NetOp Guest and the NetOp Host. You do not necessarily have both these modules, please ignore sections referring to programs you do not have. Read chapter 2 for information on installing NetOp, this chapter also contains information about technical requirement and registration. Chapter 3 contains a quick start guide. You should be able to get up and running by reading chapters 2 and 3. Chapter 4 contains information about configuring and running the NetOp Guest. Chapter 5 contains information about configuring and running the NetOp Host. Chapter 6 presents detailed information about the various communication protocols supported by NetOp. Chapter 7 is about troubleshooting the NetOp programs. It is important that you read the file README.TXT, which is supplied on your NetOp distribution disks, this file contains important last minute information. 1.4 EXAMPLES OF USE ------------------- This section shows you a few examples of how you can benefit from using NetOp. Support Use NetOp to provide qualified help to users anywhere. Take over the user's screen and on-line demonstrate the solution to a problem. Transfer updated files with NetOp's file transfer utility. Remote configuration Use NetOp to remotely configure servers and workstations. Transfer configuration files and change the setup of PCs everywhere. Using Your Office Computer From Your Home NetOp will let you access your office PC from anywhere. You can execute programs, and exchange data, read your E-mail, and access all your network resources from your portable computer. 1.5 THE NETOP SYSTEM -------------------- NetOp consists of one or two of the following: Guest (NetOp for OS/2 Guest): An OS/2 Presentation Manager application that allows a PC to remotely control any PC which is running the NetOp host software. Host (NetOp for OS/2 Host): An OS/2 Presentation Manager application that allows an OS/2 PC to be controlled from a NetOp Guest. 1.6 USING THE NETOP PROGRAMS ---------------------------- If you are familiar with the OS/2 Presentation manager interface, we trust you will find NetOp's interface fairly easy. You can click with the mouse on elements on the screen to activate them. If an element has a highlighted letter, that element can also be activated, by pressing ALT combined with the highlighted letter on your keyboard. 1.6.1 The On-line Help System ----------------------------- The NetOp for OS/2 Guest contains an on-line, context-sensitive help system. You can get context-sensitive help on any action you are attempting, by pressing F1. This brings up a window, which contains help for the current action. 2. INSTALLATION --------------- 2.1 SUMMARY ----------- This chapter describes the necessary steps for installing the NetOp evaluation software on your computers. It is very important that you read through the file README.TXT which is on your evaluation disk. This file contains important information, which is not in this manual. 2.2 PREREQUISITE TASKS ---------------------- 2.2.1 Technical Requirements ---------------------------- Your system must meet certain technical requirements to use the NetOp system. HARDWARE Computer IBM PS, IBM PC, or 100% compatible Modem Null modem, or modem with support for the AT command set. Video Guest: Any graphics adapter supported by OS/2. Host: Any graphics adapter supported by OS/2, running one of the following modes: 640x350x16, 640x400x16, 640x400x256, 640x480x16, 640x480x256, 800x600x16, 800x600x256, 1024x768x16, 1024x768x256, 1280x1024x16, 1280x1024x256 Disk space Host and guest less than 1 Mb each SOFTWARE OS/2 Version 1.3 or higher (including Warp). Please notice, that the Setup program require version 2.x or higher to run. TCP/IP IBM's TCP/2 and FTP PC/TCP for OS/2 or compatible. APPC IBM Communication Manager/2 or compatible NetBIOS IBM, Microsoft, Novell or compatible IPX Netware Requester for OS/2 or compatible. 2.2.2 Checking Your Package --------------------------- Your evaluation copy includes a SETUP program you should run in order to install both the Guest and Host. The SETUP program will decompress the necessary files and copy those. It will also allow you to create a folder with the Guest and Host modules on your desktop. Finally, the SETUP program can modify your config.sys, if you choose so. A purchased package will contain a manual, a registration card, and 3.5" disk(s). If you need 5.25" disk(s), this can be accomodated. Please contact your supplier or Danware. A purchased package consist of one or more of the two NetOp modules: The guest and the host. NetOp files: FILE NAME DESCRIPTION USED BY MODULE(S) NGUEST2.EXE The guest program Guest NGUEST2.SYS Guest device driver Guest NGUEST2.HLP Guest help file Guest DTLOS2.DLL Library module Guest & Host MODEMS.DAT The modem definitions Guest & Host SETUP.EXE Installation program Guest & Host SETUP.PKG Data file used by SETUP.EXE Guest & Host SETUP.INS Data file used by SETUP.EXE Guest & Host ~INS0762.LIB Library used by SETUP.EXE Guest & Host README.TXT Important last-minute info Guest & Host NHOST2.EXE The host program Host NHOST2.DLL Library module Host NHOST2.SYS Host device driver Host MANUAL.TXT This file GUEST.Z Compressed files Guest HOST.Z Compressed files Host In addition to these files, NetOp generates files with the extension .CFG in which configuration information is saved. 2.3 INSTALLATION ---------------- The installation program requires OS/2 version 2.0 or newer. To install NetOp on a PC running OS/2 version 1.3, you must first install on a version 2.0 PC and then copy the programs manually. Please refer to section 2.4, "Manual Installation". 2.3.1 Installing the Guest -------------------------- To install the NetOp guest simply run the setup program: 1. Insert the diskette into a floppy drive. 2. At an OS/2 prompt type a:setup and press ENTER. If the floppy drive is not labelled A:, please substitute a: with the appropriate letter. 3. Follow the on-screen instructions. 2.3.2 Installing the Host ------------------------- To install the NetOp host simply run the setup program: 1. Insert the diskette into a floppy drive 2. At an OS/2 prompt type a:setup and press ENTER. If the floppy drive is not labelled A:, please substitute a: with the appropriate letter. 3. Follow the on-screen instructions 2.4 MANUAL INSTALLATION ----------------------- This section explains how to manually install the NetOp programs. 2.4.1 Installing the Guest -------------------------- To manually install the guest, you must use files copied from a directory created by using the SETUP program. Then please do the following: 1. Insert the diskette with those files into the floppy drive (here assumed to be the A: drive). 2. Open an OS/2 command prompt. 3. Make a NetOp directory. E.g. by issuing the command md netop ENTER. 4. Log onto the NetOp directory by issuing the command cd netop ENTER. 5. Copy all the files from the NetOp Guest diskette, e.g. by issuing the command copy a:\*.* ENTER. 6. Add the device driver NGUEST2.SYS to the CONFIG.SYS. To do this load the CONFIG.SYS with an editor, and add the line: DEVICE=C:\NETOP\NGUEST2.SYS 8. If desired the NetOp Guest can be installed as an icon on the OS/2 desktop or in a folder on the desktop, please refer to OS/2's documentation for a description of how to do this. 9. Re-boot the PC. 2.4.2 Installing the Host ------------------------- To manually install the host, you must use files copied from a directory created by using the SETUP program. Then please do the following: 1. Insert the diskette into the floppy drive (here assumed to be the A: drive). 2. Open an OS/2 command prompt. 3. Make a NetOp directory. E.g. by issuing the command md netop ENTER. 4. Log onto the NetOp directory by issuing the command cd netop ENTER. 5. Copy all the files from the NetOp Host diskette, e.g. by issuing the command copy a:\*.* ENTER. 6. Add the device driver NHOST2.SYS to the CONFIG.SYS. To do this load the CONFIG.SYS with an editor, and add the line: DEVICE=C:\NETOP\NHOST2.SYS 7. If desired the NetOp Host can be installed as an icon on the OS/2 desktop or in a folder on the desktop, please refer to OS/2's documentation for a description of how to do this. 8. Re-boot the PC. 3. QUICK START -------------- 3.1 SUMMARY ----------- This chapter presents a brief guide to getting started with NetOp. After reading this chapter you should be able to set up the guest and host, and start a remote control session. 3.2 THE HOST ------------ To start the host, double click on the host icon in the NetOp folder on the OS/2 desktop, or start the program NHOST2.EXE from an OS/2 command line. The first time the host is run, the program prompts for various configuration information. First select the protocol to use for communication between the guest and the host. This is done by clicking the appropriate radio button in the Select protocol section of the setup dialog. After selecting a protocol, it might be necessary to fill in additional protocol specific information. Network remote control For remote control via network, one should choose NetBIOS, IPX, TCP/IP or APPC, if you are in doubt, please ask your network administrator. After selecting a protocol, enter a name in the Host ID field. This is used by the guest to identify this PC. For some network protocols (APPC and TCP/IP), the Host ID field is grayed out, these protocols do not need the name, since a name is already inherent in the protocol. Modem remote control For remote control via modem choose Serial/modem in the protocol section of the setup. For serial communication a modem and a port must be specified. If the host PC is using a modem which is not available in the list choose Hayes compatible (2400 bps or slower modems) or Hayes compatible fast (other). If the host PC is using an external modem, the COM port is the port the modem is connected to, the COM port number can be read on the back of the PC. If the host PC is using an internal modem, the COM port number is specified in the modem card, refer to your modem documentation for further information. After having filled in the appropriate information, the host is started by clicking the OK button. The host minimizes and awaits an incoming call from a guest. The host remembers the setup information for future use. The next time the host is run simply click OK to initialize it. To bypass the setup screen completely use the -L command line switch. This loads the host directly, using the settings which were specified the last time the host was run. 3.3 THE GUEST ------------- To start the guest, either double click the guest icon in the NetOp folder on the OS/2 desktop, or start the program NGUEST2.EXE from an OS/2 command line. The guest needs to know which communication protocols to initialize. The first time the program is run it prompts the user for this protocol information. The information entered in this dialog can be changed at a later time. Normally the section in this dialog, which has to do with RemPC (ver. 4.30) can be ignored. This is only relevant for backward compatibility (if you want to remote control previous versions of the NetOp host software). For remote control using a modem (or a null modem cable) Serial/Modem should be chosen. For network remote control choose one of the network protocols (please refer to the network administrator if in doubt about protocols). The various properties sections of this dialog should be ignored, unless the guest is going to communicate using FTP Software's implementation of TCP/IP, in this case the local IP address should be entered in dot decimal notation (e.g. 208.0.0.1) in the IP Address field. When the information is complete, click the OK button, this starts the main NetOp Guest program. Network remote control ---------------------- To remote control via network do the following: 1. Click the combo box in the tool bar 2. Enter the name of the host PC in the Host ID field (for NetBIOS and IPX, the name is specified by the host user. For APPC use the LU name or alias. For TCP/IP use the IP address in dotted decimal notation or the TCP host name). 3. Click the call button in the tool bar. Modem remote control -------------------- To specify the modem setup on the guest PC choose Default Host settings... from the Options menu. Make sure that Serial/Modem is selected in the Select Protocol section. In the Serial/Modem Properties section, the Phone number field should contain an `*', Modem Type should be the modem attached to the PC (if the modem is not in the list choose Hayes compatible for 2400bps or slower modems, otherwise Hayes compatible fast). If the host PC is using an external modem, the COM port is the port the modem is connected to, the COM port number can be read on the back of the PC. If the host PC is using an internal modem, the COM port number is specified in the modem card, refer to your modem documentation for further information. After the dialog box is completed click the OK button. To call a host PC via modem do the following: 1. Click the combo box in the tool bar 2. Enter the phone number of the host PC in the Host ID field 3. Click the call button in the tool bar. 4. THE GUEST ------------ 4.1 SUMMARY ----------- This chapter describes how to use the NetOp Guest software. This is the NetOp module that is used to remotely control a host PC. Areas covered in the chapter include: How to start the guest, how to configure the guest, and operation during remote control sessions. For a description of how to install the guest please refer to chapter 2, "Installation". 4.2 INTRODUCTION ---------------- 4.2.1 Starting the Guest ------------------------ If the guest is available from the OS/2 desktop the guest can be started by double clicking the guest icon. It is also possible to start the guest from an OS/2 command prompt: Open an OS/2 command prompt, use the CD command to change to the NetOp directory, and start the guest by typing nguest2 ENTER. It is also possible to supply the guest with command line parameters, see section 4.7, "Command line options" for a description of this. 4.2.2 The Guest Screen ---------------------- The guest program contains a menu bar where all NetOp commands are available. There is also a tool bar with shortcuts to the most common commands. The status line at the bottom of the NetOp Guest window contains information about (from left to right): 1. The name of the current host table 2. Number of seconds connected to the active host PC 3. Keyboard mode (local or remote) 4. Current protocol (red if protocol not initialized) 4.3 CONFIGURATION ----------------- 4.3.1 Communication Settings ---------------------------- The communication settings dialog box is activated by choosing Communication Settings from the Options menu. This dialog controls which protocols are initialized at startup, and properties for those protocols. To remote control via a specific protocol this protocol must have been initialized during startup. A consequence of this is that remote control via a currently uninitialized protocol, involves first enabling the protocol in the communication settings dialog and then restarting the guest program. The protocols are divided into two groups, namely Host (ver 5) and RemPC (ver. 4.3). Host protocols are used to communicate with NetOp version 5 hosts, whereas the RemPC protocols are used to communicate with older version (4.3) NetOp hosts, this allows for a mixed environment, where the hosts are gradually upgraded to version 5. Please note that it is not possible to enable Host and RemPC protocols simultaneously. One can, however, enable multiple Host or RemPC protocols. For NetBIOS, IPX and TCP/IP some additional properties are needed. Protocol properties: PROTOCOL PROPERTY DESCRIPTION -------- -------- ----------- NetBIOS Max Host sessions This is the maximum number of NetBIOS hosts (ver. 5) the guest should be able to remote control simultaneously. Max RemPC sessions This is the maximum number of NetBIOS hosts (ver. 5) the guest should be able to remote control simultaneously. Adapter Specify primary or alternate. Refer to your network documentation for further information IPX Auto Bridge Support This option is only valid for RemPC IPX. When Auto bridge support is enabled NetOp will automatically build a list of all IPX networks. List Lets the user maintain a list of IPX networks. The guest will be able to find hosts on any of the IPX networks in the list. TCP/IP IP Address For FTP's implementation of TCP/IP it is necessary to specify the IP address of the guest. The address should be in dotted-decimal notation (e.g. 208.0.0.1). 4.3.2 Display Settings ---------------------- The Display Settings dialog box is activated by choosing Display Set- tings... from the Options menu. Palette change: --------------- This section of the dialog box tells NetOp how to handle the situation where the host and the guest have different palettes (color schemes). PALETTE OPTION DESCRIPTION -------------- ----------- Always The palette on the guest PC is set to the same as the host PC currently in focus (the active window). Zoomed The palette on the guest PC is set to the same as the host PC whenever the remote control session is zoomed to full screen. Never The guest's color palette is never changed. If the palette option section is grayed out, this is probably because the guest device driver was not loaded, or because the display device driver on the guest is not capable of palette switching. Display: -------- In this section of the dialog various options with relevance to the guest display can be set. DISPLAY OPTION DESCRIPTION -------------- ----------- Status line If this option is enabled the guest will display a status line in the lower part of the main window. The status line contains such information as time connected, current protocol, keyboard status, name of current host table, help for the current action. Large buttons If this option is enabled NetOp will use large buttons in the tool bar. NetOp logo If this option is enabled the NetOp logo will be displayed in the background of the guest window. Time connected If this option is enabled total connection time to the active host PC will be displayed in the status line. Sound ----- If this option is enabled NetOp will beep whenever an error situation occurs. Press the OK button to accept changes, click Cancel to reject changes or click Default to return all settings to Danware's default settings. 4.3.3 Default Host Settings --------------------------- From this dialog box the user defines the default settings which apply when new hosts are added to the host tables. FIELD DESCRIPTION ----- ----------- Protocol First select a protocol, after this specify the properties for the chosen protocol. A detailed description of the protocols and their properties is given in section 6, "Protocols". Advanced keyboard Advanced keyboard should always be on when controlling OS/2 PCs. Remote controlling some DOS applications (running RemPC 4.30) might require Advanced keyboard to be off. Compression The level of compression decides how much processing NetOp uses for reducing the amount of data to be transmitted between guest and host. For slow communication links choose High for faster links choose Low. Normally this value should not be changed, since NetOp automatically suggests a compression level based on protocol selection. For Serial/Modem and APPC it is possible to specify a default phone number/LU Name, this should normally have the reserved value *. This means that the value used as host ID is the host's phone number/LU name. Click OK to accept changes or Cancel to reject. Default restores all values in the dialog box to the Danware default values. Default applies to all hosts added to the host table. To change the settings for one specific host choose edit after adding it to the host table. 4.3.4 Modem database -------------------- To activate the modem database dialog choose Modem database... from the Options menu. From this dialog NetOp's modem database can be maintained. Modem definitions can be added, changed or deleted. Section 6.1, "Serial/modem" contains a detailed description of the use of modems with NetOp. The modem name field contains the name of the current modem. To change to another modem in the database activate the drop down icon next to the modem field, and choose a modem from the list. For some modems the string Fixed will be displayed in the lower left part of the dialog. This means that the current modem has been defined by Danware, and cannot be changed. To alter the settings for a fixed modem make a copy of the modem definition and make the desired changes on the copy: 1. Make the modem which is to be changed the current modem (select from the Modem name drop down list). 2. Press the New... button. 3. Enter a name for the copy of the modem. This new modem will not be fixed, and any desired changes can be made to it. To add a modem to the database, press the New... button, this will add a modem similar to the current modem. Only the name, which the user is prompted for, is different. To change the name of the current modem press the Edit name... button. To delete the current modem press the Delete... button. It is not possible to change the name of, or delete, fixed modems. Therefore the Edit name... and the Delete... buttons will be disabled when the current modem is fixed. Each modem definition consists of a number of settings and a collection of modem strings. The settings are changed from the main modem database dialog, the strings are changed from a sub-dialog, which is activated by pressing the Modem strings... button. The below table contains a description of settings and strings. The modem definitions are saved in the file MODEMS.DAT. If the guest and host are installed in the same directory, this file is shared among the two programs. Because of this changes made to the database in one of the programs will be reflected in the other. SETTING/STRING DESCRIPTION -------------- ----------- Null modem Should only be enabled for direct connections. RTS/CTS Often referred to as Hardware flow control. Should be enabled if supported by the modem. Ignore DCD Should usually be disabled. Some older modems are too slow in establishing the carrier signal, causing NetOp to wrongly report the connection to be lost. If your modem is old, and unprovoked loses the connection, try enabling this option. Baud Rate Choose the maximum speed supported by the modem. Note that this should typically be higher than the modem's line speed. Typically, for a 9,600 bps modem, the baudrate should be set to 38,400. Refer to the modem manual to check the maximum speed supported by the modem. Dial This string is transmitted to the modem together with the phone number whenever a dial attempt is made. This string should normally be ATD?D (also see section 6.1, "Serial/modem"). Hangup This string is transmitted to the modem when a hangup is performed. This string should usually be ATH0S0=0. Setup 1/Setup 2 These are the initialization strings that are transmitted to the modem before a connection is attempted, and before incoming calls will be accepted. There is no difference between Setup1 and Setup2, they can be considered two lines of the same initialization string. Send This string is transmitted to the modem after the setup strings from the guest, when a call is attempted. This field should usually be left blank. Answer This string is transmitted to the modem from the host to ready the computer for incoming calls. This string should usually be ATS0=, where should be substituted with a number. For example ATS0=1, if the modem should go off hook after 1 ring. 4.3.5 Modem dialog ------------------ Choose Modem dialog... from the Options menu to display a window, which lists all the commands the guest transmits to the modem, and the modems responses. Useful for debugging purposes. 4.3.6 Hotkey Assignments ------------------------ Certain key combinations have special functions when pressed on the guest. These combinations are referred to as hotkeys. NetOp provides special hotkeys used to execute specific NetOp tasks or used to substitute hotkeys reserved by the OS/2 operating System. Initially most of these special hotkeys are not active. To change/activate the hotkey assignments choose Hotkey assignment from the Option menu. Use the mouse or TAB to select the hotkey for which the definition should be changed. Then simply change the key combination you want to use. Press SPACE to turn a hotkey off. If the Default button is pressed, all hotkeys will be set to the default value defined by Danware. Save changes by pressing the OK button. Changes are saved in the file NGUEST2.CFG. See section 4.6.10, "Hotkeys" for a description of the hotkey actions. 4.3.7 Font Assignments ---------------------- The font size used by NetOp during remote control of text mode applications can be defined by the NetOp user NetOp supports 4 different character modes, and for each mode it is possible to assign the font resolution. To activate the font assignment dialog choose Font assignment from the Option menu. Choose the character mode and select the font resolution to be used with that mode. Press the OK button to save changes. The font assignments are stored in the file NGUEST2.CFG. Press the Default button to use the default font assignments defined by Danware. 4.4 ESTABLISHING A SESSION -------------------------- 4.4.1 Host IDs -------------- A host PC is prepared for remote control by loading the NetOp host program. If NetBIOS or IPX is selected as the protocol the host user has typically supplied a name. For Serial, TCP/IP and APPC a host id is inherent to the protocol (phone number, IP address/TCP name, LU name). The table below gives an overview of host ids for the various protocols. PROTOCOL HOST ID FORMAT -------- ------- ------ Serial/Modem The host is identified with its Any phone number telephone number. NetBIOS The host is identified with a A string with a name which is specified in the maximum length of NetOp host program 32 characters. IPX The host is identified with a A string with a name which is specified in the maximum length of NetOp host program 32 characters. TCP/IP The IP address or the TCP host name. IP Address: Dotted- decimal notation (a.b.c.d, e.g. 208. 0.0.1). TCP host name: e.g. petere. sales.danware.com APPC The LU name The fully qualified LU name or alias. e.g. DANWARE.PETERE or PETER If no name is entered when using NetBIOS or IPX, the host will automatically use the burnt-in network adapter address (typically the MAC address) as a host ID. This is especially useful in large installations where manually specifying a name for each host might not be feasible. These hosts can be reached by using a special syntax when entering the host ID on the guest: 0xnnnnnnnnnnnn where nnnnnnnnnnnn is the 12-digit hexadecimal burnt-in address. For instance 0x08005AABD3EF. 4.4.2 Calling a Host -------------------- To call a host enter the host ID in the combo box in the tool bar. The guest is now ready to connect to the host, provided the host can be reached, using the default protocol (see section 4.3.3, "Default Host Settings"). Press the call button on the tool bar to connect to the host. A connection can also be established by double clicking the name in the combo box, or by pressing the ENTER key. It is also possible to connect via the menu bar, choose Connect to selected Host PC from the Host menu. If the host has been called before, or has been manually added to the host table, it can be called by selecting it from the combo box drop down list (see section 4.5) and pressing the call button. To call a host using another protocol than the default protocol, enter the host name in the combo box and then activate the Edit button in the tool bar. This activates a dialog box. Below table describes the various fields of this dialog box. FIELD DESCRIPTION ----- ----------- Host ID The string which identifies the host PC. Select Protocol Specify the protocol used to communicate with the host PC. A detailed description of the protocols and their properties is given in section 7 "Protocols". Advanced keyboard Advanced keyboard should always be on when controlling OS/2 PCs. Remote controlling some DOS applications (running RemPC 4.30) might require Advanced keyboard to be off. Compression The level of compression decides how much processing NetOp uses for reducing the amount of data to be transmitted between guest and host. For slow communication links choose High for faster links choose Low. Normally this value should not be changed, since NetOp automatically suggests a compression level based on protocol selection. When the call is initiated the guest might be asked to enter a password and/or a call back number (serial/modem only) or wait for the host to confirm the access. After this the host screen will appear as a window. It is possible to connect to multiple PCs simultaneously. It is even possible to connect to multiple PCs using different communication protocols. When connected to multiple PCs use the mouse to switch between the PCs. Click on the window to activate a PC. This can also be done from the menu bar, make sure the host name is shown in the combo box. Then select Make selected Host PC active from the Connection menu. Serial/modem and APPC Host IDs ------------------------------- For the serial/modem and APPC protocols a special host ID convention is used. Normally the host ID entered should be the phone num- ber (serial) or the LU name/alias (APPC). Sometimes it is useful to use another ID, for instance "Johns Work PC" might be a better name than 44532525. To address this NetOp includes a special phone number field for serial, and LU Name field for APPC. This lets the user enter any ID in the Host ID field, and then the phone number/LU name in a separate field. Use the reserved value * in the phone number/LU name field to indi- cate that the host ID should be used as phone number/LU name. 4.4.3 Hang-up ------------- To stop controlling a PC, make sure the name of the host PC is shown in the combo box. Then do one of the following: Activate the hangup button on the tool bar. Select Disconnect from selected Host PC from the Connection menu. Close the window displaying the host screen. 4.5 HOST TABLES --------------- NetOp stores information about hosts in host tables. The list displayed in the combo box in the tool bar, is the active host table. One host table can contain up to 150 host definitions. NetOp includes support for multiple host tables allowing the guest user to switch between an unlimited number of host tables. All host table information is stored in the file NGUEST2.CFG. 4.5.1 Add Host -------------- Whenever the guest connects to a host PC not already listed in the host table, this PC will be automatically added to the active host table. It is also possible to add a PC to the host table without connecting to it. This is done by choosing Add Host... from the Host menu, enter the name of the host. This adds a host with the settings, specified in the Default Host Settings dialog. To change the settings press the Settings... button. 4.5.2 Build Host Table ---------------------- NetOp includes a facility which automatically scans the network and collect host PC names. Activate this facility by pressing the Build button on the tool bar, or by selecting Build Host Table from the Host menu. The build feature works on the NetBIOS and the IPX protocol. Furthermore only initialized protocols (see section 4.3.1, "Communication Settings") are scanned. Please note that RemPCs (version 4.30) must be declared public. If not the NetOp guest will not list the name. 4.5.3 Edit Host --------------- When a host name is manually added to the host table NetOp will use the default host settings (see section 4.3.3, "Default Host Settings"). The current settings for a host name can easily be changed. Select the host name in the combo box and press the Edit button on the tool bar, or select Edit Host... from the Host menu. Hosts which are added to the table using the build feature will automatically have the correct settings. 4.5.4 Remove Host ----------------- Hosts can be removed from the host table one at the time. Select the host name in the combo box, then choose Remove host... from the Host menu. Please note that a host name cannot be removed while the host is being controlled. To remove a PC which is being controlled, first press the Hangup button in the tool bar, then remove the name as described above. It is also possible to delete an entire host table. Select Delete Host ta- ble... from the Host menu. It is not possible to delete a host table if one or more PCs are being controlled. 4.5.5 Multiple Host Tables -------------------------- NetOp includes the possibility of maintaining multiple host tables. Use this feature to group the PCs for instance into departmental or geographical units, or to break the 150 PC per table barrier. Only one host table can be active at any given time. The active host table's name is displayed in the status line. The contents of the active table is displayed in the combo box in the tool bar. To manage multiple host tables choose Management Host tables... from the Host menu. From this dialog it is possible to add, delete, rename and activate host tables. Select a host table from the list with the mouse and choose an action by pressing the appropriate button. The below table describes the available actions. ACTION DESCRIPTION New... Creates a new empty host table. Delete... Deletes the selected host table. Please note that the active host table cannot be deleted. To delete the active host table, first activate another table. Edit... Renames the selected host table. Activate Activates the selected host table. Shortcuts The Manage Host tables dialog box can be activated by double-clicking the combo box in the tool bar with the mouse. A name can be activated from the Manage Host tables dialog by double-clicking the name with the mouse. 4.5.6 Finding an Entry in the Host table ---------------------------------------- NetOp's host tables are alphabetically sorted (case insensitively). To find a specific entry in the active host table do the following: 1. Activate the host table, by choosing List all Hosts from the Host menu. 2. Now the entry field in the combo box is the active element, entering a string in this field will select the first element in the table which starts with this string. 3. Select the specific entry by clicking it with the mouse, or by using the UP ARROW or DOWN ARROW keys. 4.5.7 Miscellaneous ------------------- Combo box --------- The combo box is used to enter names quickly. Click the combo box with the mouse to activate it. The combo box can also be activated by choosing Activate combo box from the Host menu. View Host table --------------- The host table can be viewed by clicking on the icon to the right of the entry field. This can also be done by pressing ALT+DOWN ARROW when the combo box is active, or by selecting List all Hosts from the Host menu. View connected Hosts -------------------- NetOp provides a feature for listing all PCs it currently is connected to. Choose List connected Hosts from the Host menu. From this list it is possible to switch the active window by selecting a host from the list and clicking Select or by double-clicking the host name with the mouse. 4.6 REMOTE CONTROL ------------------ 4.6.1 Getting Started --------------------- When connected to a host PC, the host screen will be shown on the guest display and the keyboard and mouse can be used to remote control the host's keyboard and mouse. The host screen is shown in a maximized NetOp Guest child window. This window can be zoomed to full screen, restored to a smaller win- dow, or otherwise manipulated. 4.6.2 Keyboard control ---------------------- NetOp provides two ways of controlling the host keyboard, local mode and remote mode. Local keyboard When remote controlling most keys will be transferred to and executed on the host PC, just as if the guest keyboard was physically connected to the host PC. However a number of keys and key combinations are reserved for local use by NetOp and are therefore not transferred when NetOp is running in Local keyboard mode. Examples of such keys are the arrow keys, which are used for scrolling the host window and are therefore not transferred to the host. Remote keyboard In order to get the most complete control of the host keyboard NetOp should run in Remote keyboard mode. If this mode is selected all keys are transferred to the host, except for a few combinations which are used locally by OS/2 and NetOp (see section 4.6.10, "Hotkeys"). Remote keyboard is the default mode. When running in full screen mode (see section 4.6.8, "Zoom") the keyboard is always in remote mode. Switch between local and remote keyboard by activating the keyboard mode button in the tool bar, this is the button with at keyboard on it, the caption on the button is either Remote or Local. Please note that the caption on the keyboard button is not the current mode, but rather the mode which pushing the button will activate. It is also possible to toggle the keyboard mode from the menu bar: Choose Local keyboard from the Options menu. This will toggle the mode, if the mode is local this will be indicated next to the menu item. The current mode is displayed in the status bar in the bottom of the NetOp Guest window, which contains either the word Remote or Local, indicating the current status. 4.6.3 Mouse control ------------------- NetOp provides mouse support for applications running OS/2 Presentation Manager, and windowed Win-OS2 applications. Using NetOp's 4.30 compatibility mode it is also possible to remote control the mouse in Windows and DOS applications. There are two different ways to remote control the mouse in NetOp, local mouse and remote mouse Local mouse When the guest mouse pointer is moved (the local mouse) this action will not be transmitted to the host. As soon as a mouse button is activated, the host's mouse position will be updated to the local mouse position, and the click will be executed. This method yields high performance, since mouse activity generates a minimum of communication traffic. The default mouse mode when initiating a remote control session is local. Remote mouse In remote mouse mode, the host's mouse will always follow the guest mouse. This is a slower method, but in some cases this is the best choice: If the guest user is instructing a host user on how to accomplish a specific task, which involves the mouse, in this case remote mouse is best since this mode lets the host user follow every guest mouse movement. The mouse mode is toggled by choosing Local mouse from the Options menu. The mode is indicated on the menu. 4.6.4 Lock Host Keyboard and Mouse ---------------------------------- NetOp allows the guest user to lock the keyboard and mouse on the host PC. Choose Lock keyboard and mouse on Host from the Options menu. It will not be possible to use host keyboard and mouse until the guest unlocks them. Use this feature to prevent a user to interfere while working on a host, e.g. when re-configuring a server. The host keyboard and mouse are unlocked by choosing Lock keyboard and mouse on Host from the Options menu. The lock status is indicated on the menu. Please note that the host program must have been configured to allow lock of keyboard and mouse, otherwise the menu item will be disabled on the guest. Refer to section 5.4.2, "Guest Rights" for a description on how to configure guest rights on the host. 4.6.5 Boot Host --------------- NetOp includes a feature which lets the guest boot the host PC. Choose Boot Host PC from the Options menu. A confirmation dialog box will be displayed to ensure that the host PC is not booted by mistake. Please note that the host program must have been configured to allow boot from the guest, otherwise the menu item will be disabled on the guest. Refer to section 5.4.2, "Guest Rights" for a description on how to configure guest rights on the host. 4.6.6 Chat with Host -------------------- The chat function brings up a window on the host and guest which allows the users to communicate. Press the chat button on the tool bar or choose Chat with Host PC from the Options menu to initiate a chat. A dialog will appear. A similar dialog will be displayed on the host. Everything typed on the host and guest will be communicated between the users, and displayed in the dialog boxes. Please note that chat has to be enabled in the host security settings (see section 5.4, "Security"), otherwise the chat button and the chat menu item will be disabled. Host Chat Request NetOp allows a host user to request chat. When a host user requests chat, the guest PC will beep shortly to notify the guest user. When not running in full screen mode the guest user will be notified by a message flashing on the windows bar of the remote PC requesting chat. Chat can be initiated as described above. 4.6.7 Screen resolution ----------------------- Depending on the screen resolution of the guest and host PCs, the complete host screen or only part of it will be visible. For example it is possible to control an XGA PC from a PC running VGA resolution. If the host is running a higher video resolution than the guest, the guest will display as much of the host screen as possible, by using scroll bars, the guest user can view all parts of the host screen. If the guest is running a higher video resolution than the host, the host might not take up the entire window on the guest, the remaining part of the window will be black. 4.6.8 Zoom ---------- Instead of viewing the host screen in a window, it is possible to zoom to a full screen view. In full screen view the host takes up the entire guest screen, this gives the guest the most realistic view of the host. The host screen can be zoomed by activating the Zoom key on the tool bar, by choosing Zoom window from the Window menu, or by pressing the hotkey defined for this action (default CTRL+Z). Switch back from zoom mode by pressing the zoom hotkey (default CTRL+Z). If the host is running a higher resolution than the guest, the guest will display scroll bars. If the guest is running a higher resolution than the host, the remaining area on the guest screen will be black. 4.6.9 Window manipulation ------------------------- When controlling multiple PCs simultaneously, NetOp provides a button in the tool bar that will toggle between 3 modes. One mode will cascade the windows, one will position the windows vertically and one will position the windows horizontally. It is also possible to directly select a mode. This is done from the Window menu. 4.6.10 Hotkeys -------------- NetOp provides special hotkeys used to execute specific NetOp Guest tasks or used to substitute key combinations reserved by the OS/2 operating system. Initially most of these hotkeys are not active. Please refer to section 4.3.5 for instructions on how to define or redefine the hotkeys. The table below describes the different hot-keys. HOTKEY DESCRIPTION ------ ----------- Zoom In/Out Zoom the active host window to full screen or go back to normal mode. This hotkey cannot be switched OFF, but it can be redefined. The default value of this hotkey is CTRL+Z. List Conn hosts List all host PCs currently being controlled. Next Window Activate the window of the next host PC. Ctrl+ESC When CTRL+ESC is pressed on the guest, the key combination is intercepted by the guest OS, the result is the guest task list. To obtain the host task list define this hotkey (or use the Ctrl+Esc button on the tool bar). Alt+ESC When ALT+ESC is pressed on the guest, the key combination is intercepted by the guest OS. To execute the combination on the host, define this hotkey. Alt+Tab When ALT+TAB is pressed on the guest, the key combination is intercepted by the guest OS. To execute the combination on the host, define this hotkey. 4.6.11 File Transfer -------------------- NetOp includes an advanced file transfer tool which lets the user transfer files between the guest and the host during a remote control session. To activate the file transfer tool, choose Transfer files to/from Host... from the Options menu. This brings up a dialog. The various fields of this dialog box are described in below table. FIELD DESCRIPTION ----- ----------- Send files Check this radio button to send files from the guest to the host. This button is disabled if Receive files from guest is disabled in the host security settings. Receive files Check this radio button to send files from the host to the guest. This button is disabled if Send files to guest is disabled in the host security settings. Overwrite if file exists If this check box is enabled existing files with the same name as the transferred file will be overwritten. Use this option with care since data might be lost. If this option is disabled files with names which already exist will not be transferred. Include subdirectories Use this in combination with wildcards to transfer entire or partial directory structures. Example: Entering c:\*.* in the Source field and enabling Include subdirectories will transfer the entire C-drive. Source Enter the file name(s) to transfer from, note that the usual OS/2 wildcards (?, *) are valid. Destination Enter a path or file name to transfer the files to. To specify a path rather than a file name end the field with a backslash. Example: Destination is non-existing directory C:\DATA, entering c:\data in the destination field will create the file C:\DATA and transfer the data to this file, entering c:\data\ in the destination field will create the directory C:\DATA and transfer the files to this directory. The dialog box also contains a list of transferred files, and the progress of the file currently being transferred. Press the Start Transfer button to start the file transfer, when a file transfer is started the Start Transfer button changes to Cancel Transfer. Press Close to close the dialog box. Please note that closing the dialog box when a file transfer is in progress will not cancel the file transfer, which will be continued in a background thread, choose Transfer files to/from Host... from the Options menu again to bring back the file transfer dialog. Please note that the host might have disabled receiving, sending or both (see section 5.4, "Security"), according to these settings the file transfer menu item or one of the send/receive radio buttons might be disabled. 4.7 COMMAND LINE OPTIONS ------------------------ A wide range of the NetOp Guest's features can be controlled from the command line. The syntax for starting the guest is: NGUEST2 [group] [-switch1 [-switch2 _ ] ] group ----- is a group name, which is only used when communicating with version 4.30 RemPCs. RemPCs can be defined as belonging to a group, in this case only guests started with the same group name will be able to control those RemPCs. Options are set by using one or more command line switches. Command line switches should be preceded with the character -. The switches accepted by the NetOp Guest are described in the table below. By using the -N switch it is possible to connect to any NetOp Host. The -N switch should be followed by a host specification (described in a table later). If the host to be called from the command line already exists in the guest's host table, the host specification is just the name: NGUEST2 -N:NAME=PETER If the host is not defined in the host table one or more settings can be specified directly from the command line. For the settings which are not defined on the command line default values are used. Example: NGUEST2 -N:NAME=PETER;PROT=HN This will start the guest, which will attempt a connection to a host with the host ID PETER, using the NetBIOS protocol, other settings will have the default value (e.g. compression low). Guest command line switches --------------------------- OPTION DESCRIPTION ------ ----------- Hp+, Hp- Controls initialization of host (ver. 5) protocols. Substitute p with a character to specify the protocol: N=NetBIOS, I=IPX, T=TCP/IP, A=APPC, S=Serial/modem. Use + to enable a protocol, -to disable. Examples: -HN+ : Initialize NetBIOS -HA- : Do not initialize APPC Rp+, Rp- Controls initialization of RemPC (ver. 4.30) protocols. Substitute p with a character to specify the protocol: N=NetBIOS, I=IPX. Use + to enable a protocol, - to disable. PD Disable all currently enabled protocols IC Instant close. The NetOp Guest program will exit when the last host window is closed. IL:nnnnnnnn Add network nnnnnnnn to the IPX network list (see section 6.3, "IPX" for a description of the IPX network list) L+, L- Controls automatic build of IPX network list (feature only available for ver 4.30 RemPCs). L+: Enable build, L-: Disable build. N:host specification Connect to the host described with host specification. A host specification has the following form: field1=val1 [; field2=val2 _ ] See below table for a description of host specification field and values. FIELD VAL DESCRIPTION NAME string Host PC name KBD ADV Advanced keyboard routine NOR Normal keyboard routine COMP LO Low compression HI High compression PROT HN Communicate with host using NetBIOS HI Communicate with host using IPX HT Communicate with host using TCP/IP HA Communicate with host using APPC HS Communicate with host using Serial/modem RN Communicate with RemPC using NetBIOS RI Communicate with RemPC using IPX HA_NAME string Host APPC name or alias HA_MODE string APPC mode HS_PHONE string Host phone number HS_MODEM string Modem name. Modem must exist in the modem data- base, otherwise null-modem is used. Blanks should be substituted with _. Example: HAYES_COMPATIBLE HS_PORT string Port name. Example: COM1 HS_BAUD string Data speed for serial communication. Example: 38400 HS_PULSE TRUE Use pulse dial for serial connection FALSE Use tone dial for serial connection Following settings only for communication with ver 4.30 RemPCs RI_BRIDGE string IPX bridge address. Must be a 12 digit hexadecimal number RI_NET string IPX network number. Must be an 8 digit hexadecimal number RI_NODE string IPX node number. Must be a 12 digit hexadecimal number MAX number Max calls, number must be an integer in the range -10 to 2000 Examples Initialize the IPX protocol, and add 000BABE1 to the list of IPX network number, where the guest should look for hosts: NGUEST2 -HI+ -IL:000BABE1 Initialize the serial protocol, and call a host, using a modem, with the phone number 112. Use the modem definition Hayes compatible: NGUEST2 -HS+ -N:NAME=112;PROT=HS;HS_MODEM=HAYES_COMPATIBLE Call the host named PETER (for which settings already are defined in the default host table). Exit the NetOp Guest when the connection to PETER is terminated: NGUEST2 -N:NAME=PETER -IC 5. THE HOST ----------- 5.1 SUMMARY ----------- This chapter describes how to use the NetOp Host software. This is the NetOp module that prepares a PC to be remotely controlled. Areas covered in the chapter include: How to start the host, how to set up the host, security configuration, operation during remote con- trol sessions. For a description of how to install the host please refer to chapter 2, "Installation". 5.2 STARTING THE HOST --------------------- 5.2.1 From the desktop ---------------------- If the host has been installed as an icon on the desktop, or in a desk- top folder, it is started by double clicking the host icon. 5.2.2 From an OS/2 prompt ------------------------- To start the host from a command prompt do the following: 1. Open an OS/2 command prompt. 2. Use the CD command to change to the NetOp directory. 3. Start the guest by typing nhost2 ENTER. It is also possible to supply the host with command line parameters, see section 5.6, for a description of this. 5.2.3 Automatically at Startup ------------------------------ The host can be started automatically in two different ways: 1. Install the host in the OS/2 Startup folder. In the settings of the NetOp host program object -L should be specified as command line parameter. 2. Include the lines (provided that NetOp is installed in C:\NETOP, otherwise substitute the appropriate directory): CD \NETOP START NHOST2 -L CD \ in the file STARTUP.CMD, placed in the root of the boot drive 5.2.4 Initialization -------------------- If the host is started without command line parameters, the host setup dialog is displayed. The default settings in this dialog are the settings specified the last time the host was run, these settings are read from the file NHOST2.CFG. After the setup dialog has been completed the host will minimize and initialize. After this it is ready to accept incoming calls from a NetOp Guest. If the host is started with the -L command line parameter it initialized directly after startup and minimizes. The host will use the same settings as the last time it was run. From the host's minimized state it is possible to follow its status in two ways: 1. The icon title will display the status, e.g. NetOp Host - Waiting for call or NetOp Host - Connected. 2. When connected to a host, an open eye will be displayed in the icon. Use the OS/2 settings notebook for the NetOp Host to specify that the program should minimize to the desktop by doing this the host user will always know if he is being controlled. To bring out the host window after initialization activate the OS/2 task list by pressing CTRL+ESC and double click the line "NetOp Host" with the mouse. 5.3 SETTING UP THE HOST ----------------------- If the host is started without command line parameters, the setup dialog is displayed at startup. The setup dialog can also be activated by choosing Setup... from the host's configuration menu. In this dialog box the communication protocol and host ID are specified. NetOp includes support for serial communication (typically modem or a null-modem cable) and various LAN and WAN protocols (NetBIOS, IPX, TCP/IP and APPC). If in doubt about which communication protocol to use, please ask the network administrator. Select a protocol from the Select Protocol section of this dialog box. For some of the protocols additional protocol specific settings need to be specified, these settings are described in detail in section 6, "Protocols". For the NetBIOS and the IPX protocol it is possible to specify a host ID, this is a character string with a maximum length of 32. If no ID is specified, the MAC address will automatically be chosen. Press OK to accept the host settings. The settings are stored in the file NHOST2.CFG Please note that when communication settings have been changed, the host must be closed down and restarted before the changes take effect. Modem database Choose modem database from the Configuration menu to access NetOp's modem database. See section 4.3.4, "Modem database" for a description of how to use the modem database. Modem dialog Choose Modem dialog... from the Configuration menu to display a window, which lists all the commands the host transmits to the modem, and the modems responses. Useful for debugging purposes. 5.4 SECURITY ------------ The NetOp host include a number of security features. Use these to prevent unauthorized access to the host PC, and to limit the number of actions possible for the guest PC. The security settings can all be accessed from the dialog box Security Configuration, this dialog is activated by choosing Setup... from the host's Configuration menu, activate the Security... button from the resulting dialog box. 5.4.1 Maintenance Password -------------------------- The host's security settings can be protected by a maintenance password. This password has to be entered every time the security configuration dialog is activated. This ensures the host user against un-authorized changes to security settings (e.g. by a guest). To define (or change) the maintenance password press the Mainte- nance Password... button on the security configuration dialog box. Toggle the Use maintenance password check box to enable or disable the maintenance password. If the password is enabled enter the password in the New password field, re-enter the password in the Confirm password field. Activate the OK button when done. 5.4.2 Guest Rights ------------------ The section of the Security Configuration which is labelled Allow Guest to contains the settings which describe how much a guest is allowed to do on this host. The various options are described in the table below. GUEST RIGHT DESCRIPTION ----------- ----------- Use keyboard and mouse If this option is disabled the guest will not be able to remote control the host's keyboard and mouse, but only view the screen. Sometimes referred to as View only. Chat Specifies whether the guest is allowed to start a chat (see 5.5.1, "Request Chat" for a description of chat). Send files to host Specifies whether the guest is allowed to transfer files from the guest to the host. Receive files from host Specifies whether the guest is allowed to transfer files from the host to the guest. Lock keyboard and mouse Specifies whether the guest is allowed to lock the host keyboard and mouse. Boot the PC Specifies whether the guest is allowed to boot the host PC. 5.4.3 Password -------------- The host can be protected by a password, which a guest must enter correctly in order to control the host. To use a password enable the Password check box in the security configuration dialog. Enter the password in the field to the right of the check box, the password will not be displayed when entered. Password policy It is possible to define a password policy on the host, this specifies how many password attempts a guest has, and what will happen if the limit is exceeded. Press the Guest password policy... button to define a password policy. In the resulting dialog choose the maximum number of wrong passwords a guest can enter, and what to do if the limit is exceeded: Hangup, Disable (do not take further calls from any guest), or boot host. 5.4.4 Confirm access -------------------- If this option is enabled, the host will be presented with a dialog box, every time a guest attempts a connection. From this dialog the host user can accept or deny the remote control attempt. Enabling confirm access makes sure the host is not accessed while unattended. Enable or disable confirm access by toggling the Confirm access check box in the security configuration dialog box. 5.4.5 Call-back This setting is only used if the host is using the serial/modem protocol. If call-back is enabled, the host will answer incoming calls from a guest and then hangup and call the guest back. The call-back facility serves two purposes: 1. Security: By specifying a call-back number it can be ensured that the host is only controlled from one specific telephone number. 2. Phone charges: Call-back can be used to reverse the phone charges from guest to host. There are three different settings for call-back, all found in the Call-back section of the security configuration dialog box: 1. No call-back: No call-back will be performed. 2. Call back to: A call back is attempted to the specified number. 3. Roving call back: The guest is prompted for the number to call back to, especially useful for reversing phone charges. Furthermore it is possible to enter a number of seconds the host should wait after the guest calls before the call-back is attempted. Use this to make sure the guest is initialized and ready to be called back. Enter the number of seconds to wait in the Wait before call-back field. The Call-back timeout field is the number of seconds the host should wait (assuming the guest is not reached) before the call-back times out and is considered failed. 5.5 ON-LINE CHOICES ------------------- This section describes the choices which are only available on the host during a remote control session. 5.5.1 Request Chat ------------------ To request a chat session (see section 4.6.6, "Chat with Host") with the guest, choose Request chat from the Configuration menu. The host will beep and display a message in the title bar of the host window. The guest then has to initiate the chat, e.g. by pressing the chat button on the guest tool bar. Please note that the guest cannot see the message when controlling the host in zoomed full screen mode. In this case only the beep will be heard by the host. 5.5.2 Hangup ------------ The host can choose to disconnect the host at any time during a remote control session. Choose Hangup from the Configuration menu to disconnect the guest. A confirmation dialog will be displayed. 5.5.3 File Transfer When the guest is performing a file transfer (see section 4.6.11, "File Transfer"), the host can see the status by choosing File Transfer... from the Configuration menu. From the resulting dialog box it is possible to see which files have been transferred and the progress with the current file. The file transfer can also be interrupted from this dialog box by choosing Cancel. Click close to close the dialog box without interrupting the file transfer. 5.6 COMMAND LINE OPTIONS ------------------------ A wide range of the NetOp Host's features can be controlled from the command line. The syntax for starting the host is: NHOST2 [-switch1 [-switch2 _ ] ] Options are set by using one or more command line switches. Command line switches should be preceded with the character -. The switches accepted by the NetOp Host are described in the table below. OPTION DESCRIPTION L [:n ] Load the host directly without prompting for setup infor- mation. The settings used the last time the host was run will be used. Optionally a delay in seconds can be specified e.g. -L:10, this will delay the initialization for the specified number of seconds, use this feature if the host must wait for some communication device to be ready before initializing. N:host specification Use this parameter to override one or more of the settings used the last time the host was started. A host specification has the following form: field1=val1 [; field2=val2 _ ] See the table below for a description of host specification field and values. By using the -N switch it is possible to completely specify the host settings from the command line. It is not necessary to enter all the settings. For settings which are not entered the values from the last time the host was run are used. Host specification ------------------ FIELD VAL DESCRIPTION NAME string Host PC name PROT HN Communicate with guest using NetBIOS HI Communicate with guest using IPX HT Communicate with guest using TCP/IP HA Communicate with guest using APPC HS Communicate with guest using Serial/modem HA_MODE string APPC mode HS_MODEM string Modem name. Modem must exist in the modem database, otherwise null-modem is used. Blanks should be substituted with _. Example: HAYES_COMPATIBLE HS_PORT string Port name. Example: COM1 HS_BAUD string Data speed for serial communication. Example: 38400 HS_PULSE TRUE Use pulse dial for serial connection FALSE Use tone dial for serial connection SEC_MAINT_PASS string Current maintenance password. If the host has defined a maintenance password, this field must match that password. SEC_MAINT_NEW string Use this parameter to change the mainte- nance password, leave blank to disable main- tenance password SEC_PASS string Sets the password the guest must enter to access this host. Leave blank for no password. SEC_PASS_MAX number Maximum password retries SEC_PASS_POLICY BOOT Boot if too many wrong passwords DISABLE Disable host if too many wrong passwords HANGUP Hangup if too many wrong passwords SEC_CONFIRM TRUE Enable confirm access FALSE Disable confirm access SEC_KBD_MOU TRUE Allow guest to control keyboard/mouse FALSE Guest not allowed to control keyboard/mouse SEC_CHAT TRUE Allow chat FALSE Do not allow chat SEC_UPLOAD TRUE Allow guest to send files to host FALSE Do not allow guest to send files to host SEC_DOWNLOAD TRUE Allow guest to receive files from host FALSE Do not allow guest to receive files from host SEC_LOCK TRUE Allow guest to lock host keyboard/mouse FALSE Do not allow guest to lock host keyboard/mouse SEC_BOOT TRUE Allow guest to boot host FALSE Do not allow guest to boot host SEC_CALL FALSE Disable call-back ROVING Perform roving call-back number Call back to number SEC_CALL_WAIT number Seconds to wait before call-back SEC_CALL_TIMO number Call-back time out Examples Initialize the host directly from the command line (use same settings as last time): NHOST2 -L Initialize the host with the NetBIOS protocol. Use JOHN as host Id, and PASS as password: NHOST2 -L -N:NAME=JOHN;PROT=HN;SEC_PASS=PASS 6. PROTOCOLS ------------ 6.1 SERIAL/MODEM ---------------- 6.1.1 Description ----------------- Use the serial/modem protocol to communicate using the RS-232c interface. Typically with a modem over telephone lines or with a null-modem cable. 6.1.2 Configuration ------------------- No special configuration is needed as long as OS/2's standard serial device driver is loaded. In OS/2 1.3 the serial device driver is not loaded in the default setup. To do this add the device driver COM0n.SYS (COM01.SYS for PCs with ISA bus, COM02.SYS for PCs with MCS bus) to the CONFIG.SYS. 6.1.3 Protocol Specific Settings -------------------------------- Below is a description of the settings specific to the serial/modem protocol. Modem Choose a modem from the list. If your modem is not in the list choose Hayes compatible (2400 bps or slower) or Hayes compatible fast (9600 or faster). It is also possible to define new modems. See section 4.3.4, "Modem database" for a description of this. Dial Choose Tone if this is supported by the phone system, other- wise choose pulse. Port Typically COM1 or COM2. Use the Custom field to enter other COM ports (e.g. COM4 or any other valid OS/2 serial device) Baud rate Should normally be Default which means that NetOp will use the speed defined for the chosen modem in the modem database. If connection is often lost try lowering the baud rate. Phone number Enter `*' to use the host ID as the phone number. Use this field to enter the phone number if the host ID is e.g. the name of the host user. 6.1.4 How to Define New Modems ------------------------------ The most important part of defining a modem for NetOp is the setup strings (SETUP1 and SETUP2). NetOp does not distinguish between these two strings. You can just consider them as two lines for your setup string. You should use the following general approach when constructing the setup string: 1. Load the modem's factory settings (usually AT&F1). 2. Specify that if the DTR signal is lowered the modem should disconnect and return to command mode (usually AT&D2). 3. Specify that the CD signal should track the state of the carrier (usually AT&C1). 4. If the modem is capable of RTS/CTS flow control, this should be enabled using the appropriate AT command. Also enable RTS/CTS flow control in the settings section of the modem dialog box. 5. Specify that the DTE/DCE rate should be fixed at the DTE speed. 6. If your modem is equipped with error correction and/or data compression, these should be enabled. 7. Instruct the modem to hangup after loss of carrier (usually by setting the modem's S10 register. E.g. ATS10=20, causing the mo- dem to hangup if carrier is lost for a duration of 2 seconds). The Dial string should usually be ATD?D. This instructs NetOp to use ATDT if tone dial is chosen by the user, and ATDP if pulse dial is chosen. The Hangup string is usually ATH0S0=0. H0 tells the modem to go on hook, S0=0 tells the modem not to answer incoming calls. The Send field is send to the modem after setup1 and setup2, but only by the guest. Usually this field should be left empty. The answer field should usually contain the string ATS0=, e.g. ATS0=1, this instructs the modem to answer incoming calls after rings. Set Max Baud Rate to the maximum DTE supported by your modem. Please note that you should be careful with high baud rates on slow computers. You might get better performance by setting the baud rate to 19200 rather than 57600 on a slow PC. Please note that you can override the baud rate defined for the mo- dem in protocol specific settings for serial/modem. 6.1.5 Host ID format -------------------- The guest user can enter the phone number directly as the host ID (e.g. in the combo box). To get a pause in a phone number (e.g. to access an external line), most modems will accept an comma (`,'). Example: To get an external line the guest user must dial 0 and then wait for new ready signal, he want to dial the number 112, in this case he would enter "0,112" as the host ID. It is also possible to enter another host ID than the phone number (e.g. the name of the host user), in this case use the protocol specific field Phone number to enter the phone number. 6.2 NETBIOS ----------- 6.2.1 Description ----------------- NetBIOS is one the most popular protocols for LAN communication. NetBIOS is typically used in LAN Server, LAN Manager and LAN-Tastic, and Windows NT environments. 6.2.2 Configuration ------------------- NetBIOS is installed when the network client software is installed on the PC. If there are any problems with accessing NetBIOS, please contact a network administrator 6.2.3 Protocol Specific Settings -------------------------------- The only protocol specific setting for NetBIOS is Primary or Alternate adapter. This is defined in the NetBIOS setup, the setting should normally be Primary. 6.2.4 Host ID format -------------------- When configuring the host a Host ID can be entered. The host ID should be a string with a maximum length of 32 characters. If no Host ID is entered NetOp will use the burnt-in network adapter address (typically the MAC address). To call a host which uses the burnt-in address as a host ID enter 0xnnnnnnnnnnnn. Where nnnnnnnnnnnn is a 12 digit hexadecimal number (e.g. 0x080005AF341A). 6.2.5 NetOp resource needs -------------------------- Guest Host Sessions n 1 NCBs n+4 5 Names 2 2 n is the number specified in the Max host sessions field in the guest's Communication settings... dialog. 6.3 IPX ------- 6.3.1 Description ----------------- IPX (Internetwork Packet Exchange) is Novell's network protocol. This protocol is typically used in Novell Netware environments. 6.3.2 Configuration ------------------- IPX is installed when the network client software is installed on the PC. If there are any problems with accessing IPX, please contact a network administrator. 6.3.3 Protocol Specific Settings -------------------------------- In the Communication settings... dialog, which is accessed from the Options menu in the NetOp guest, there are some IPX specific settings. There is a check button labelled Auto bridge support this is only for use with version 4.30 RemPCs - please refer to the RemPC documentation for instructions on the use of this option. There is also a List button. This button lets the guest user define a list of IPX network numbers. Normally the NetOp Guest will look for hosts on the same network as itself. However some Novell networks consist of a number of subnetworks, each identified with an 8 digit hexadecimal number. To reach a host on another subnetwork than the guest, the host's network number has to be defined in the guest's list of IPX networks. To find the network number for a given PC, use Novell's NLIST utility by issuing the following command at an OS/2 prompt: nlist user=NetwareLoginName /a ENTER Where NetwareLoginName should be substituted with the user's Netware login name. The Address field of the resulting listing contains the network number. The network numbers in the NetOp guest's list must be 8 digits. if a network number has less than 8 digits is should be padded with 0s. Example: network number 1F23 should be entered as 00001F23 in NetOp's network list. 6.3.4 Host ID format -------------------- When configuring the host a Host ID can be entered. The host ID should be a string with a maximum length of 32 characters. If no Host ID is entered NetOp will use the burnt-in network adapter address (typically the MAC address). To call a host which uses the burnt-in address as a host ID enter 0xnnnnnnnnnnnn. Where nnnnnnnnnnnn is a 12 digit hexadecimal number (e.g. 0x080005AF341A). 6.3.5 NetOp ressource needs --------------------------- NetOp uses IPX socket 8641 (hex). Allocated to Danware by Novell. 6.4 TCP/IP ---------- 6.4.1 Description ----------------- TCP/IP is a networking protocol increasingly popular in LAN/WAN environments. NetOp supports IBM's and FTP's implementation of the TCP/IP protocol for OS/2. 6.4.2 Protocol Specific Settings -------------------------------- If FTP's TCP/IP implementation is used it is necessary to enter the local IP address on the guest and host. On the guest this is done in the Communication settings dialog, on the host in the Host configuration dialog. Enter the IP address in dotted-decimal notation (e.g. 208.0.0.1). 6.4.3 Host ID format -------------------- From the guest a host can be called by entering the IP address in dotted-decimal notation (e.g. 208.0.0.1). If a name is entered, this will be passed on to TCP/IP. If the name can be resolved to an IP address where a host is loaded then the connection will be successful. Thus a host ID could be e.g. `peter' or `peter.sales.danware.com'. 6.4.4 NetOp ressource needs --------------------------- NetOp use one port. The default port used is 6502. To use another port instead of 6502 (e.g. to avoid a conflict with another TCP/IP application) include a line in TCP/IP SERVICES file on all guests and hosts. Example: To use port 6503 instead of 6502 enter the following line in the SERVICES file: netop 6503/udp netop and udp must be in the line. The port number can be changed. However all NetOp PCs must use the same port number. 6.5 APPC -------- 6.5.1 Description ----------------- APPC (Advanced Program to Program Communication) is a com- munication protocol, which is typically used to communicate in IBM WAN environments (SNA networks). 6.5.2 Configuration ------------------- APPC is installed and configured by using the Communication Manager/2 setup utility. In order to use NetOp over APPC two Transaction Programs (TPs) must be defined in the CM/2 setup. The TPs must have the following names: DWDTL1 DWDTL2 In the setup of these TPs Service TP must be disabled, Operation Type should be defined as `Queued operator preloaded'. 6.5.3 Host ID format -------------------- When calling an APPC host, the guest should use either the fully qualified LU name, or an LU alias as the host ID. Both of these are defined in the APPC setup. For further information please refer to your CM/2 documentation. 7. TROUBLE-SHOOTING ------------------- 7.1 ANSWER TO COMMON PROBLEMS ----------------------------- ? Cannot connect to a host via IPX ! If the host is on another IPX network than the guest, the host's network number should be defined in the guest's IPX network list. Refer to section 6.3.3, "Protocol Specific Settings" for a descrip- tion of how to do this. ? I get the error "DTLOS2.DLL already used. Guest to Host communication not possible". ! You are probably trying to run the host and the guest simultane- ously, only one of the programs should run on the same PC simul- taneously ? The host window only displays "Unsupported video mode" when controlling Windows (RemPC 4.30) ! When controlling 4.30 Windows RemPCs NetOp supports up to 800x600x16. If the host is only running this resolution and the message still appears, try to use the Microsoft's "Super VGA" dis- play device driver. ? I cannot get a connection between my modems. ! For some modems the error correction and data compression are not compatible. Try disabling these two features of the modems (by changing your modem setup strings). 7.2 NETOP ERROR MESSAGES ------------------------ NetOp error messages include a brief description of the error and a More... button. When reporting an error to a NetOp support person, make sure to give all information contained in the error dialog and also all information in the More... dialog. Also have the following information ready: 1. Your NetOp serial number 2. OS/2 version information (for guest and host) 3. Relevant information about your communication hardware and software (modems, network client software version, etc. END