SCO® Vision2K Reference Document Number AU35602P004 January 2000. Copyright ©1995-2000 The Santa Cruz Operation, Inc. All rights reserved. Software License Notice Any copyrighted software that accompanies this publication is licensed to the End User only for use in strict accordance with the End User License Agreement, which should be read carefully before commencing use of the software. This SCO software includes software that is protected by these copyrights: ©1995-2000 The Santa Cruz Operation, Inc.; ©1993-1998 Microsoft Corporation; ©1990-1998 Network Computing Devices, Inc. All rights reserved. Disclaimer The SCO documents are provided as is and may include technical inaccuracies or typographical errors. The Santa Cruz Operation, Inc. reserves the right to add, delete, change or modify the SCO documents at any time without notice. The SCO documents are for information only. SCO makes no express or implied representations or warranties of any kind. Restricted Rights Legend Any software that accompanies this publication is commercial computer software and, together with any related documentation, is subject to the restrictions on US Government use as set forth below. If this procurement is for a DOD agency, the following DFAR Restricted Rights Legend applies: RESTRICTED RIGHTS LEGEND: Use, duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of Rights in Technical Data and Computer Software Clause at DFARS 252.227-7013. Contractor/Manufacturer is The Santa Cruz Operation, Inc., 400 Encinal Street, Santa Cruz, CA 95060. If this procurement is for a civilian government agency, the following FAR Restricted Rights Legend applies: RESTRICTED RIGHTS LEGEND: This computer software is submitted with restricted rights under Government Contract No. _____ (and Subcontract No. ____, if appropriate). It may not be used, reproduced or disclosed by the Government except as provided in paragraph (g)(3)(i) of FAR Clause 52.227-14 alt III or as otherwise expressly stated in the contract. Contractor/Manufacturer is The Santa Cruz Operation, Inc., 400 Encinal Street, Santa Cruz, CA 95060. Trademarks SCO, The Santa Cruz Operation, the SCO logo and SCO VisionFS are trademarks or registered trademarks of The Santa Cruz Operation, Inc. in the USA and other countries. XVision , SuperVision, TermVision and SQL-Retriever are trademarks or registered trademarks of Visionware Limited, a subsidiary of The Santa Cruz Operation, Inc. UNIX is a registered trademark of The Open Group in the US and other countries. XRemote is a registered trademark of Network Computing Devices, Inc. All other brand or product names are or may be trademarks of, and are used to identify products or services of, their respective owners. Document History First published, March 1997. Second edition, August 1997. Third edition, December 1997. Fourth edition, October 1998. Fifth edition, January 2000. Corporate Headquarters & US Canada, Latin America and Europe, Middle East, India and Asia Pacific Regional Sales Regional Sales Office Australia Regional Sales Office Africa Regional Sales Office Office SCO SCO SCO United Kingdom SCO Singapore 425 Encinal Street 425 Encinal Street Croxley Business Park 171 Chin Swee Road Santa Cruz, California Santa Cruz, California Hatters Lane #03-05/06 San Centre 95061-1900 95061-1900 Watford WD1 8YN Singapore 169877 United States of America United States of America United Kingdom Tel: +65 536 6606 Tel: +1 831 425 7222 Tel: +1 831 427 7811 Tel: +44 (0)1923 816344 Fax: +65 536 6619 Fax: +1 831 458 4227 Fax: +1 831 427 5418 Fax: +44 (0)1923 813808 Sales and Information: Tel: (800) 726-8649 Email:[email protected] http://www.sco.com Contents Welcome to SCO Vision2K v License Management 65 About Vision2K vi License management overview 66 About this book vi License Manager 67 About the documentation vii licadmin UNIX utility 67 Conventions used in the documentation viii Organizing users into domains 67 License Numbers 68 Installation 1 Products and components 68 License Server 68 Installing Vision2K 3 Client authorization 69 Vision2K installation overview 4 Soft licensing 70 Hardware and software requirements 4 Managing license request failure events 70 Setting up Vision2K on a UNIX host 5 Managing licenses across subnetworks 70 Setting up Vision2K on a PC 6 Server-Based Setup 7 X Window System 73 Automated installations 8 Adding more options 11 Using the X Server 75 Removing Vision2K from a UNIX host 11 X Server overview 76 Removing Vision2K from a PC 11 Configuring the server 79 Server profiles 80 Vision Communications Architecture 13 Choosing a display mode 81 Window management 82 Vision Communications Architecture 15 Selecting the active transport 83 Communications overview 16 Optimizing performance 83 Vision Communications Architecture model 17 Security 86 Changing system settings 19 Keyboard input in X 90 Configuring transports 20 Using the mouse 93 Configuring hosts 27 Fonts in X 94 Using a network connection 33 Color in X 106 Using a serial or modem connection 33 Copying and pasting 110 Connection Manager 45 Working with sound 112 Using Connection Monitor 46 Helpful Interactive Support 114 Vision Communications database 47 Logging X errors 114 Vision USP services 49 Getting information about the X Server 114 Locating Resources 52 Web browser helper program 115 Authentication 59 Logging events and errors 62 X Window Management 117 Window management overview 118 ii Contents Vision Window Manager 118 ANSI Emulator 197 Using Motif 127 VT420 Emulator 198 Using OPEN LOOK 130 Wyse 60 Emulator 200 Starting X Programs 135 Emulator Scripting 201 Starting X programs overview 136 Emulator scripting overview 202 Using the Unix Application Wizard 136 Working with scripts 202 Using Remote Program Starter 139 Emulator objects 203 Using a terminal emulator to start X clients141 Type libraries 204 Using X Display Manager 143 Functions 205 Using NCD XRemote 150 Event handlers 233 Tvdemo example script 248 Suspending and Resuming a Session 159 Using Tvdemo.bas 248 Vision Resume overview 160 The Tvdemo.bas source code 251 How Vision Resume works 160 Configuring Resume in XVision Eclipse 161 ODBC 257 Configuring Vision Resume on UNIX 162 Controlling a Vision Resume session 163 Vision ODBC Driver 255 Starting or resuming a Resume session 165 Vision ODBC driver overview 256 Starting clients in a Vision Resume session 166 Open Database Connectivity 256 Suspending a Vision Resume session 167 Adding, modifying, deleting data sources 258 Relocating a Vision Resume session 167 Connecting to an ODBC data source 264 Quitting a Vision Resume session 168 Creating the demonstration database 266 Using Resume with a serial line or modem 168 Connection string 268 Error messages 272 Terminal Emulation 171 ODBC API functions 274 Implementation issues 275 Terminal Emulation 173 Using debug mode 276 Terminal emulation overview 174 Log files 277 Opening a terminal connection 175 Security Manager 277 VCA Terminal service 176 Informix server module 280 Terminal emulator documents 179 Ingres server module 285 Changing the window size and position 181 Oracle server module 290 Displaying the History view 181 Fonts 182 ODBC Applications 295 Colors 183 ODBC applications overview 296 Toolbars 183 Microsoft Access 296 Keyboard input 183 Microsoft Excel 303 Copying and pasting 185 Microsoft Word 312 Events 186 Microsoft Visual Basic 318 Styles 186 Borland Delphi 328 Recording and playback 187 Powersoft PowerBuilder 340 Scripts 188 Starting Windows applications from UNIX 188 Printing from a terminal emulator 189 Using OLE 190 Using an emulator as an ActiveX document 195 Contents iii Accessories 353 Administration 411 Browsing Remote Hosts 355 Administration Concepts 411 Browsing overview 356 Managing PCs remotely 412 Browsing 356 Organizing PCs 412 VCA File Access service 359 SuperVision components 413 File types 361 Distributing files 416 Copying and moving files 367 Managing desktops 417 Desktop shortcuts 368 Remote configuration 417 Performing tasks on PCs using scripts 417 Executing Remote Programs 369 Controlling and monitoring PCs remotely 418 Executing remote programs overview 370 Other administration facilities 418 Executing a program 370 VCA Remote Execution service 372 Managing the Administration Database 421 Remote Program Starter documents 374 Administration database overview 422 Obtaining Administrator privilege 422 Printing 375 Database items 422 Printing overview 376 Creating Groups and PCs 423 UNIX to PC local printing 376 Creating a hierarchy of drives and folders 427 PC to UNIX remote printing 381 Aliases 429 Message Handling 387 Specifying files to be downloaded 435 Specifying database objects 436 Message handling overview 388 Specifying tasks 438 Message Pad 388 Deleting database items 439 Text messages 390 Restrictions 440 Multimedia messages 391 Running an update 444 UNIX messages 393 UNIX directory structure 445 Viewing Users 395 File names 446 User viewing overview 396 Controlling and Monitoring PCs Remotely 447 Viewing users 396 Controlling and monitoring PCs overview 448 Viewing user properties 397 Browsing PCs 448 Viewing programs running on a PC 450 Zones 399 Using Tcl Scripts 453 Organizing the Desktop with Zones 401 Tcl overview 454 Zones overview 402 UNIX components 454 Organizing zones 402 The Tcl interpreter (admsh) 454 Quitting Zones or deleting a zone 403 Getting information about Tcl 455 Using Zone Control 404 Using Tcl scripts for administration tasks 456 Viewing zone properties 405 Tcl scripts supplied