Runtime Manual ACUCOBOL-GT® Version 8.1 Micro Focus 9920 Pacific Heights Blvd. San Diego, CA 92121 858.795.1900 © Copyright Micro Focus 1998-2008. All rights reserved. Acucorp, ACUCOBOL-GT, Acu4GL, AcuBench, AcuConnect, AcuServer, AcuSQL, AcuXDBC, AcuXUI, extend, and “The new face of COBOL” are registered trademarks or registered service marks of Micro Focus. “COBOL Virtual Machine” is a trademark of Micro Focus. Acu4GL is protected by U.S. patent 5,640,550, and AcuXDBC is protected by U.S. patent 5,826,076. Microsoft and Windows are registered trademarks of Microsoft Corporation in the United States and/or other countries. UNIX is a registered trademark of the Open Group in the United States and other countries. Solaris is a trademark of Sun Microsystems, Inc., in the United States and other countries. Other brand and product names are trademarks or registered trademarks of their respective holders. Microsoft, ActiveX, Windows, Win32, and Windows NT are registered trademarks of Microsoft Corporation in the United States and/or other countries. HP-UX is a trademark of the Hewlett-Packard Company. DB2 Connect is a trademark, and IBM, AIX, CICS, DB2, Informix, MQSeries, AS/400, OS/390, PowerPC, RS/6000, TXSeries, WebSphere, pSeries, and zSeries are registered trademarks of IBM in the United States. UNIX is a registered trademark of the Open Group in the United States and other countries. Oracle is a registered trademark, and Oracle 8i, Oracle9i, Pro*C, Pro*COBOL, and SQL*Plus are trademarks or registered trademarks of Oracle Corporation. Btrieve is a registered trademark of Pervasive Software Inc. Sybase is a trademark of Sybase, Inc. Linux is a registered trademark of Linus Torvalds. Other brand and product names are trademarks or registered trademarks of their respective holders. E-01-UG-080901-Runtime Manual-8.1 Contents Chapter 1: Introduction 1.1 Overview.......................................................................................................................... 1-2 1.1.1 Available Runtime Systems................................................................................... 1-2 1.1.1.1 Windows runtime systems........................................................................... 1-2 1.1.2 Runtime Configuration File................................................................................... 1-3 Chapter 2: Setting Up Your Terminals 2.1 How the Terminal Manager Works ................................................................................. 2-2 2.1.1 Terminal Manager Functions................................................................................. 2-3 2.1.2 Alternate Terminal Manager (ATM)..................................................................... 2-4 2.2 Getting Your Terminals Ready........................................................................................ 2-5 2.2.1 Step One—Terminal Identification ....................................................................... 2-5 2.2.2 Step Two—Terminal Definition............................................................................ 2-7 2.2.2.1 Windows special considerations.................................................................. 2-7 2.2.3 Step Three—Configuration Variables ................................................................... 2-8 2.3 The Keyboard Interface ................................................................................................... 2-9 2.3.1 Key Mapping ....................................................................................................... 2-10 2.3.1.1 Key interpretation...................................................................................... 2-10 2.3.1.2 Key translation........................................................................................... 2-11 2.3.1.3 Keyboard configuration............................................................................. 2-11 2.3.2 Redefining the Keyboard..................................................................................... 2-16 2.3.2.1 The KEYBOARD variable........................................................................ 2-16 2.3.2.2 The KEYSTROKE variable ......................................................................2-19 2.3.2.3 Table of keys ............................................................................................. 2-31 2.3.2.4 Additional Windows keys ......................................................................... 2-34 2.3.2.5 Special keys............................................................................................... 2-37 2.3.2.6 Default keyboard .......................................................................................2-39 2.3.2.7 Modification examples .............................................................................. 2-41 2.4 The Display Interface.....................................................................................................2-41 2.4.1 Adding Color ....................................................................................................... 2-42 2.4.2 The SCREEN Option........................................................................................... 2-45 2.4.2.1 SCREEN examples....................................................................................2-57 2.4.3 Additional Configuration Variables .................................................................... 2-57 2.4.4 Double-Byte Character Handling ........................................................................ 2-59 2.5 Restricted Attribute Handling........................................................................................ 2-60 2.5.1 Restricted Video Modes ...................................................................................... 2-61 Contents-ii 2.5.1.1 Restrictions ................................................................................................2-64 2.6 The Terminal Database File...........................................................................................2-65 2.6.1 Required Functions ..............................................................................................2-70 2.6.2 Additional Screen Functions................................................................................2-72 2.6.3 Video Attributes...................................................................................................2-73 2.6.4 Color ....................................................................................................................2-74 2.6.4.1 One-color terminals ...................................................................................2-75 2.6.5 Function Keys and Other Keys............................................................................2-76 2.6.5.1 User-defined keys ......................................................................................2-76 2.6.6 Line Drawing .......................................................................................................2-76 2.6.6.1 Multi-character sequences for graphics.....................................................2-78 2.6.7 Graphical Window and Control Emulation ........................................................2-79 2.6.8 Mouse Support for X Terminals ..........................................................................2-82 2.6.9 Initialization .........................................................................................................2-83 2.6.10 Print Functions...................................................................................................2-84 2.6.11 Continued Entries ..............................................................................................2-84 Chapter 3: Runtime Configuration File 3.1 Using Configuration Variables ........................................................................................3-2 3.2 Configuration File Variables............................................................................................3-5 3D_LINES ......................................................................................................................3-5 4GL_COLUMN_CASE..................................................................................................3-6 7_BIT ..............................................................................................................................3-6 A_CHECKDIV...............................................................................................................3-7 A_DEBUG......................................................................................................................3-7 A_DISPLAY...................................................................................................................3-8 A_EXTFH_FUNC ..........................................................................................................3-8 A_EXTFH_LIB ..............................................................................................................3-9 A_EXTFH_SIMPLE_OPEN_OUTPUT ......................................................................3-10 A_EXTFH_VARIABLE_IDX, A_EXTFH_VARIABLE_REL, A_EXTFH_VARIABLE_SEQ.....................................................................................3-10 A_JAVA_CHARSET ...................................................................................................3-11 A_JAVA_GC_COUNT ................................................................................................3-11 A_JAVA_TRACE_FILENAME ..................................................................................3-11