User’s Guide ACUCOBOL-GT® Version 8.1.3 Micro Focus 9920 Pacific Heights Blvd San Diego, CA 92121 858.795.1900 © Copyright Micro Focs (IP) LTD. 1998-2010. All rights reserved. Acucorp, ACUCOBOL-GT, Acu4GL, AcuBench, AcuConnect, AcuServer, AcuSQL, AcuXDBC, 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. E-01-UG-100501-ACUCOBOL-GT-8.1.3 Contents Chapter 1: Introduction 1.1 ACUCOBOL-GT Documentation ................................................................................... 1-2 1.2 Product Overview ............................................................................................................1-2 1.2.1 Portability and Compatibility ................................................................................ 1-4 1.2.2 Native Instructions................................................................................................. 1-4 1.2.3 The ACUCOBOL-GT Runtime............................................................................. 1-5 1.2.3.1 Windows console runtime ........................................................................... 1-6 1.2.4 Runtime Configuration .......................................................................................... 1-7 1.2.5 Graphical Technology ........................................................................................... 1-8 1.2.6 File System Flexibility........................................................................................... 1-9 1.2.7 Complementary Technologies............................................................................. 1-10 1.3 Document Overview ...................................................................................................... 1-12 1.3.1 User’s Guide ........................................................................................................ 1-12 1.3.2 User Interface Programming................................................................................ 1-13 1.3.3 Reference Manual................................................................................................ 1-14 1.3.4 Appendices .......................................................................................................... 1-15 1.3.5 Getting Started.....................................................................................................1-16 1.3.6 Transitioning to ACUCOBOL-GT......................................................................1-16 1.3.7 A Guide to Interoperating with ACUCOBOL-GT .............................................. 1-16 1.3.8 A Programmer’s Guide to the Internet ................................................................ 1-17 1.3.9 Related Documents.............................................................................................. 1-17 1.4 Supported Hardware ...................................................................................................... 1-17 1.4.1 Native Code Supported Processors......................................................................1-18 1.5 Environment Variables .................................................................................................. 1-18 1.6 Notation ......................................................................................................................... 1-20 1.7 How to Get Help ............................................................................................................ 1-20 1.7.1 Handling Compilation Problems ......................................................................... 1-21 1.7.2 Handling Program Execution Problems .............................................................. 1-22 Chapter 2: Compiler and Runtime 2.1 Introduction...................................................................................................................... 2-2 2.2 Using the Compiler..........................................................................................................2-3 2.2.1 Standard Options ................................................................................................... 2-4 2.2.2 Native Code Options.............................................................................................. 2-5 2.2.3 Listing Options ...................................................................................................... 2-9 Contents-ii 2.2.4 Internal Tables Options.......................................................................................2-13 2.2.5 Compatibility Options..........................................................................................2-15 2.2.6 Interoperability Options.......................................................................................2-21 2.2.7 File Options..........................................................................................................2-23 2.2.8 Source Options.....................................................................................................2-30 2.2.9 Reserved Word Options.......................................................................................2-32 2.2.10 Data Storage Options .........................................................................................2-34 2.2.10.1 Truncation Options ..................................................................................2-46 2.2.11 Video Options ....................................................................................................2-48 2.2.12 Warning and Error Options................................................................................2-51 2.2.13 Debugging Options ............................................................................................2-52 2.2.14 Mapping Options ...............................................................................................2-54 2.2.15 Conditional Compilation Options......................................................................2-57 2.2.16 Miscellaneous Options.......................................................................................2-58 2.2.17 Upper and Lower Case ......................................................................................2-68 2.2.18 File Name Handling...........................................................................................2-68 2.2.18.1 Remote file name handling......................................................................2-69 2.2.19 Compiler Command-Line Examples .................................................................2-70 2.2.20 CBLFLAGS Environment Variable ..................................................................2-71 2.2.21 Help, Version Information, and Communication With C Programs .................2-72 2.2.22 The “>>IMP” Directive .....................................................................................2-73 2.3 Using the Runtime System.............................................................................................2-75 2.3.1 Runtime Options ..................................................................................................2-77 2.4 Compatibility Modes......................................................................................................2-92 2.5 Source Formats ..............................................................................................................2-93 2.6 COPY Libraries..............................................................................................................2-95 2.6.1 Resource Files......................................................................................................2-97 2.6.1.1 General Rules for Resources .....................................................................2-98 2.7 Source Code Control......................................................................................................2-99 2.8 Runtime Configuration ................................................................................................2-100 2.8.1 File Name Assignments .....................................................................................2-101 2.8.2 Code and Data File Search Paths.......................................................................2-103 2.8.3 File Status Codes ...............................................................................................2-104 2.8.4 Terminal Handling Options ...............................................................................2-105 2.8.5 File Handling Options........................................................................................2-105 2.8.5.1 Sort files...................................................................................................2-106 2.8.5.2 Carriage control .......................................................................................2-106 2.8.5.3 Device locking.........................................................................................2-107 2.9 File Name Interpretation ..............................................................................................2-107