Acu4gl User's Guide V8.1

Total Page:16

File Type:pdf, Size:1020Kb

Acu4gl User's Guide V8.1 User’s Guide Acu4GL® Version 8.1 Micro Focus (IP) Ltd. 9920 Pacific Heights Blvd, Suite 150 San Diego, CA 92121 858.795.1900 © Copyright Micro Focus (IP) Ltd, 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 (IP) Ltd. “COBOL Virtual Machine” is a trademark of Micro Focus (IP) Ltd. 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. DB2 Connect is a trademark, and IBM, AIX, DB2, Informix, MQSeries, AS/400, OS/390, PowerPC, RS/6000, WebSphere, pSeries, and zSeries are registered trademarks of IBM in the United States. E-01-UG-080901-Acu4GL-8.1 Contents Chapter 1: Acu4GL Overview 1.1 Welcome to Acu4GL .......................................................................................................1-2 1.2 Document Overview ........................................................................................................ 1-3 1.3 Accessing Data ................................................................................................................ 1-6 1.3.1 Interface Routines.................................................................................................. 1-7 1.3.2 Data Dictionaries and Acu4GL ............................................................................. 1-8 1.3.3 The ACUCOBOL-GT Web Runtime and Acu4GL .............................................. 1-8 1.4 Database Concepts...........................................................................................................1-9 1.5 How Acu4GL Works .....................................................................................................1-10 1.5.1 What Is a Transparent Interface?......................................................................... 1-11 1.5.2 Data Dictionaries and Mapping........................................................................... 1-11 1.5.3 Steps to Follow .................................................................................................... 1-12 1.5.4 Summary.............................................................................................................. 1-14 Chapter 2: Getting Started 2.1 Getting Started ................................................................................................................. 2-2 2.2 Technical Services ........................................................................................................... 2-2 2.3 Installation ....................................................................................................................... 2-2 2.4 Using the “sql.acu” Program ........................................................................................... 2-3 2.4.1 Running “sql.acu” From the Command Line ........................................................ 2-3 2.4.2 To Call “sql.acu” From a Program ........................................................................2-4 2.5 The Demonstration Program............................................................................................ 2-6 Chapter 3: Data Dictionaries 3.1 Data Dictionaries or XFDs .............................................................................................. 3-2 3.2 XFD Files......................................................................................................................... 3-2 3.2.1 Understanding How the Database Table Is Formed.............................................. 3-3 3.2.2 Defaults Used in XFD Files................................................................................... 3-5 3.2.3 Summary of Dictionary Fields............................................................................... 3-7 3.2.4 Identical Field Names............................................................................................ 3-8 3.2.5 Long Field Names.................................................................................................. 3-8 3.2.6 Naming the XFD File ............................................................................................ 3-9 Contents-ii Chapter 4: Using Directives 4.1 What Are Directives?.......................................................................................................4-2 4.2 Directive Syntax...............................................................................................................4-3 4.3 Directives Supported by the Acu4GL Interfaces .............................................................4-4 4.3.1 ALPHA ..................................................................................................................4-5 4.3.2 BINARY ................................................................................................................4-6 4.3.3 COBOL-TRIGGER ...............................................................................................4-7 4.3.4 COMMENT ...........................................................................................................4-8 4.3.5 DATE.....................................................................................................................4-9 4.3.6 FILE .....................................................................................................................4-12 4.3.7 NAME..................................................................................................................4-13 4.3.8 NUMERIC ..........................................................................................................4-16 4.3.9 SECONDARY_TABLE ......................................................................................4-17 4.3.10 USE GROUP .....................................................................................................4-18 4.3.11 VAR_LENGTH .................................................................................................4-20 4.3.12 WHEN ...............................................................................................................4-20 4.3.13 XSL....................................................................................................................4-26 Chapter 5: Invalid Data 5.1 Illegal COBOL Data ........................................................................................................5-2 5.1.1 Invalid Key Data....................................................................................................5-3 5.1.2 Invalid Data Other Than Keys ...............................................................................5-3 5.2 Invalid Database Data ......................................................................................................5-3 Chapter 6: Working with COBOL 6.1 Preparing and Compiling Your COBOL Program...........................................................6-2 6.1.1 Compiling With No Directives ..............................................................................6-4 6.1.2 Compiling With the WHEN Directive...................................................................6-6 6.1.3 Using Additional Directives ..................................................................................6-8 6.2 Creating File Descriptors and SELECT Statements ......................................................6-10 Chapter 7: New and Existing Databases 7.1 Databases .........................................................................................................................7-2 7.2 Default Acu4GL Behavior...............................................................................................7-2 7.3 Accessing Existing Database Files ..................................................................................7-3 7.3.1 How Do I Match Existing Text Fields? .................................................................7-3 7.3.2 How Do I Match Existing Numeric Fields? ..........................................................7-3 7.3.3 Field Names ...........................................................................................................7-4 7.3.4 Index Names ..........................................................................................................7-4 Contents-iii Chapter 8: Compiler and Runtime Options 8.1 Compiler Options............................................................................................................. 8-2 8.2 Runtime Configuration Variables .................................................................................. 8-4 4GL_2000_CUTOFF...................................................................................................... 8-5 4GL_8_DIGIT_CUTOFF............................................................................................... 8-5 4GL_COLUMN_CASE ................................................................................................. 8-6 4GL_COMMIT_COUNT ............................................................................................. 8-6 4GL_CONVERT_DATE_ZERO................................................................................... 8-8 4GL_DB_MAP..............................................................................................................
Recommended publications
  • CA XCOM Data Transport for Z/OS User Guide
    CA XCOM™ Data Transport® for z/OS User Guide Version 12.0.00 This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the “Documentation”) is for your informational purposes only and is subject to change or withdrawal by CA at any time. This Documentation is proprietary information of CA and may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. If you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy. The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed. TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.
    [Show full text]
  • ACUCOBOL-GT | Open Systems COBOL Compiler and Runtime System
    ® ACUCOBOL-GT | Open Systems COBOL Compiler and Runtime System EXECUTIVE OVERVIEW ACUCOBOL-GT is an advanced COBOL development system for extending and modernizing business-critical COBOL applications. It is an extremely portable COBOL, supporting single- source, compile-once deployment on hundreds of platforms including most UNIX®, Linux®, Windows®, VMS, and MPE/iX systems. ACUCOBOL-GT includes extensive facilities for interoperating with C, Java, .NET and XML. It supports connectivity to leading relational databases and ISAM data sources through both open and patented technologies. The core component of ® Imagine. COBOL interoperating with Java™ Acucorp’s family of extend technologies, ACUCOBOL-GT supports thin client and multi-tier technology... running a .NET™ assembly… client/server architectures, as well as COBOL Web processing XML data…or providing a Web services and platform-independent graphical user service. Imagine running COBOL from a mobile, interfaces. Flexible and scalable, ACUCOBOL-GT handheld device. What would this kind of works anywhere in the enterprise, from back office to point-of-sale. functionality mean to your business? For some, it might give a competitive edge, adding value to ACUCOBOL-GT is a multi-component COBOL mission-critical applications. To others it might development system that includes a compiler, the mean breathing new life into a languishing COBOL Virtual Machine™ (runtime), the Vision indexed file system, a source-level interactive application. ACUCOBOL-GT offers all of these debugger and nearly a dozen support utilities. capabilities and more. Our graphical technology allows you to create a native graphical user interface with the Screen Section and familiar COBOL verbs like DISPLAY and ACCEPT.
    [Show full text]
  • PL/I for AIX: Programming Guide
    IBM PL/I for AIX Programming Guide Ve r s i o n 2.0.0 SC18-9328-00 IBM PL/I for AIX Programming Guide Ve r s i o n 2.0.0 SC18-9328-00 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page 309. Second Edition (June 2004) This edition applies to IBM PL/I for AIX 2.0.0, 5724-H45, and to any subsequent releases until otherwise indicated in new editions or technical newsletters. Make sure you are using the correct edition for the level of the product. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below. A form for readers’ comments is provided at the back of this publication. If the form has been removed, address your comments to: IBM Corporation, Department HHX/H1 555 Bailey Ave San Jose, CA, 95141-1099 United States of America When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. ©International Business Machines Corporation 1998,2004. All rights reserved. Contents Figures . vii COMPILE . .47 COPYRIGHT . .48 CURRENCY . .48 Part 1. Introducing PL/I on your DEFAULT . .48 workstation . .1 EXIT. .54 EXTRN . .54 Chapter 1. About this book . .3 FLAG . .55 FLOATINMATH. .55 Chapter 2. How to read the syntax GONUMBER . .56 GRAPHIC . .56 diagrams . .5 IMPRECISE . .56 INCAFTER . .57 Chapter 3.
    [Show full text]
  • Guide to Openvms File Applications
    Guide to OpenVMS File Applications Order Number: AA-PV6PD-TK April 2001 This document is intended for application programmers and designers who write programs that use OpenVMS RMS files. Revision/Update Information: This manual supersedes the Guide to OpenVMS File Applications, OpenVMS Alpha Version 7.2 and OpenVMS VAX Version 7.2 Software Version: OpenVMS Alpha Version 7.3 OpenVMS VAX Version 7.3 Compaq Computer Corporation Houston, Texas © 2001 Compaq Computer Corporation Compaq, AlphaServer, VAX, VMS, the Compaq logo Registered in U.S. and Patent and Trademark Office. Alpha, OpenVMS, PATHWORKS, DECnet, and DEC are trademarks of Compaq Information Technologies Group, L.P. in the United States and other countries. UNIX and X/Open are trademarks of The Open Group in the United States and other countries. All other product names mentioned herein may be the trademarks of their respective companies. Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. ZK4506 The Compaq OpenVMS documentation set is available on CD-ROM.
    [Show full text]
  • Oral History of Roger Sippl
    Oral History of Roger Sippl Interviewed by: Luanne Johnson Recorded: December 13, 2005 and January 12, 2006 Mountain View, California CHM Reference number: X3655.2007 © 2005 Computer History Museum Table of Contents BACKGROUND AND THE DECISION TO MAJOR IN COMPUTER SCIENCE .............................. 3 EMPLOYMENT AT BECHTEL AND THE DECISION TO SEEK A JOB IN SILICON VALLEY....... 5 CROMEMCO AND DEVELOPING THE DESIGN FOR A RELATIONAL DATABASE..................... 8 FOUNDING RELATIONAL DATABASE SYSTEMS ............................................................................ 14 DECISION TO INCORPORATE SQL AND DEVELOPMENT OF INFORMIX 4GL ........................ 16 MERGER WITH INNOVATIVE SOFTWARE ........................................................................................ 20 PROBLEMS AFTER THE MERGER WITH INNOVATIVE.................................................................. 23 DECISION TO LEAVE INFORMIX AND SUBSEQUENT ACTIVITIES............................................. 25 PROMOTING UNIX................................................................................................................................... 28 SUPPORT SERVICES PROVIDED BY INFORMIX TO CUSTOMERS............................................ 30 Roger Sippl Conducted by The Information Technology Corporate Histories Project Abstract: In this interview, Roger Sippl describes his career prior to founding Relational Database Systems (later renamed to Informix) in 1980, including developing the design for the INFORMIX relational database management
    [Show full text]
  • Iscobol JISAM 100% Portable, Compact ISAM File System
    Datasheet isCOBOL JISAM 100% Portable, Compact ISAM File System Customers expect data access anytime on anyplace. With isCOBOL JISAM, your business can deliver fast and efficient access to COBOL ap- plications with ISAM data files anywhere Java technology runs, with- out the overhead of adding a relational database management system or investing in complex program change. Anytime, anywhere data access isCOBOL JISAM is a 100% Java-based indexed sequential access (ISAM) file system based on X/Open standards, opening up a wide range of different platforms, from mainframes to hand- held devices, for new and existing COBOL programs accessing ISAM data files. Highlights Using a B+ tree-index architecture, isCOBOL JISAM offers fast, self-balancing and flexible data • Written entirely in Java to run retrieval. With isCOBOL JISAM you can: anywhere the Java Runtime Environment (JRE) is supported, • Index a file with any number of indexes, each of which may include up to 16 non-con- including mobile devices An- tiguous segments. droid based. • Scan all or part of an index in ascending or descending order. • Includes built-in routines to • Use both unique keys and duplicate keys. perform basic file management • Simplify multi-language distributions and localization leveraging isCOBOL technology’s maintenance tasks support for Unicode. • Supports multi-language de- ployments The JUTIL utility is included with isCOBOL JISAM for basic file management. With JUTIL, devel- • Includes the ISMIGRATE utility opers can load and unload binary or line sequential files, compact files, check file consistency for simplified migration of data and rebuild isCOBOL JISAM files. files from other data sources Enable COBOL data access from Java • Includes the isCOBOL Graphical Veryant makes it easy for organizations to open vital COBOL data to new applications while Indexed File Editor (GIFE) utility continuing to leverage existing skill sets.
    [Show full text]
  • Unit 2 File Concepts and File Structure
    UNIT 2 FILE CONCEPTS AND FILE STRUCTURE Structure 2.0 Objectives 2.1 Introduction 2.2 File Organisation 2.2.1 Sequential File Organisation 2.2.2 Indexed Sequential File 2.3 Random Access File Organisation 2.4 Multi-key File Organisation 2.4.1 Multilist File Organisation 2.4.2 Inverted File Organisation 2.5 Summary 2.6 Answers to Self Check Exercises 2.7 Keywords 2.8 References and Further Reading 2.0 OBJECTIVES In the preceding Unit of this block you have learnt about the Database Concepts and various types of databases and database models. You have seen that the files are main ingredient of databases. In this Unit you will learn the concepts of files in the computer environment and also how such files are organised. After the completion of this unit, you will be able to: define what is file organisation and discuss its different types; understand various file organisation techniques; and discuss various types of indexes used in file organisation. 2.1 INTRODUCTION Generally speaking, a file consists of a collection of records. A key element in file management is concerned with the ways in which the records themselves are organised inside the file, since this affects system performances heavily as far as record finding and access are concerned. Here, by “organisation”, we refer to the logical arrangement of the records in a file (their ordering or, more generally, the presence of ``closeness’’ relations between them based on their content), and not to the physical layout of the file as stored on a storage media.
    [Show full text]
  • Enterprise PL/I for Z/OS Messages and Codes About This Book
    Enterprise PL/I for z/OS IBM Developer for z Systems PL/I for Windows IBM Messages and Codes Version 5 Release 2 GC27-8950-01 Enterprise PL/I for z/OS IBM Developer for z Systems PL/I for Windows IBM Messages and Codes Version 5 Release 2 GC27-8950-01 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page 163. First Edition (September 2017) | This edition applies to Version 5 Release 2 of Enterprise PL/I for z/OS (5655-PL5), and Version 9.1 of IBM Developer for z Systems (formerly IBM Rational Developer for System z) PL/I for Windows, and to any subsequent releases until otherwise indicated in new editions or technical newsletters. Make sure you are using the correct edition for the level of the product. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below. A form for readers' comments is provided at the back of this publication. If the form has been removed, address your comments to: IBM Corporation, Department H150/090 555 Bailey Ave. San Jose, CA, 95141-1099 United States of America When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corporation 1999, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this book ..........
    [Show full text]
  • Universe User Reference Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Table of Contents Table of Contents
    C:\Program Files\Adobe\FrameMaker8\UniVerse 10.3\userref\Front February 5, 2009 11:04 am Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta UniVerse User Reference Version 10.3 February, 2009 C:\Program Files\Adobe\FrameMaker8\UniVerse 10.3\userref\Front February 5, 2009 11:04 am Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta IBM Corporation 555 Bailey Avenue San Jose, CA 95141 Licensed Materials – Property of IBM © Copyright International Business Machines Corporation 2008, 2009. All rights reserved. AIX, DB2, DB2 Universal Database, Distributed Relational Database Architecture, NUMA-Q, OS/2, OS/390, and OS/400, IBM Informix®, C-ISAM®, Foundation.2000 ™, IBM Informix® 4GL, IBM Informix® DataBlade® module, Client SDK™, Cloudscape™, Cloudsync™, IBM Informix® Connect, IBM Informix® Driver for JDBC, Dynamic Connect™, IBM Informix® Dynamic Scalable Architecture™ (DSA), IBM Informix® Dynamic Server™, IBM Informix® Enterprise Gateway Manager (Enterprise Gateway Manager), IBM Informix® Extended Parallel Server™, i.Financial Services™, J/Foundation™, MaxConnect™, Object Translator™, Red Brick® Decision Server™, IBM Informix® SE, IBM Informix® SQL, InformiXML™, RedBack®, SystemBuilder™, U2™, UniData®, UniVerse®, wIntegrate® are trademarks or registered trademarks of International Business Machines Corporation. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Windows, Windows NT, and Excel are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited.
    [Show full text]
  • Dcimfuser Guide
    DBMaker DCI MFCOBOL User's Guide Version: 5.1 Document No: 51/DBME51-T12302010-01-DMFC Author: DBMaster Support & production Team, Research & Development Division, SYSCOM Computer Engineering CO. Print Date: Nov 1 2011 Introduction Table of Content 1 Introduction ........................................................................................4 1.1 Additional Resources..................................................................................... 5 1.2 Technical Support .......................................................................................... 5 1.3 Document Conventions.................................................................................. 6 2 DCI for MFCOBOL ..............................................................................7 2.1 DCI for MFCOBOL Overview......................................................................... 7 File System and Databases......................................................................................................... 7 Relation Chart .............................................................................................................................. 8 System Requirements.................................................................................................................. 8 2.2 Setup Instructions .......................................................................................... 9 Install Net Express 5.1 ............................................................................................................... 9 Install
    [Show full text]
  • Tun SQL – Data Access Tun Plus 2009 Issued May 2008
    Tun SQL – Data Access Tun Plus 2009 Issued May 2008 Copyright © 1989-2008 Esker S.A. All rights reserved. © 1998-2002 The OpenSSL Project; © 1994-2003 Sun Microsystems, Inc.; © 1996 Wolfgang Platzer ([email protected] graz.ac.at); © 1995-1998 Eric Young ([email protected]). All rights reserved. Tun contains components which are derived in part from OpenSSH software. See the copyright.txt file on the Tun CD for additional copyright notices, conditions of use and disclaimers. Use and duplicate only in accordance with the terms of the Software License Agreement - Tun Products. North and South American distributions of this manual are printed in the U.S.A. All other distributions are printed in France. Information in this document is subject to change without notice. No part of this document may be reproduced or transmitted in any form or by any means without the prior written consent of Esker S.A.. Esker S.A., 10 rue des Émeraudes, 69006 Lyon, France Tel: +33 (0)4.72.83.46.46 ♦ Fax: +33 (0)4.72.83.46.40 ♦ [email protected] ♦ www.esker.fr Esker, Inc., 1212 Deming Way, Suite 350, Madison, WI 53717 USA Tel: +1.608.828.6000 ♦ Fax: +1.608.828.6001 ♦ [email protected] ♦ www.esker.com Esker Australia Pty Ltd. (Lane Cove - NSW) ♦ Tel: +61 (0)2 8596 5100 ♦ [email protected] ♦ www.esker.com.au Esker GmbH (München) ♦ Tel: +49 (0) 89 700 887 0 ♦ [email protected] ♦ www.esker.de Esker Italia SRL (Milano) ♦ Tel: +39 02 57 77 39 1 ♦ [email protected] ♦ www.esker.it Esker Ibérica, S.L.
    [Show full text]
  • VSI COBOL DBMS Database Programming Manual
    VSI OpenVMS VSI COBOL DBMS Database Programming Manual Document Number: XX-XXXXXX-XXX Publication Date: month 2018 This manual explains how to develop Oracle DBMS database programs with VSI COBOL on the OpenVMS Alpha, OpenVMS I64, and the OpenVMS VAX operating systems. Revision Update Information: This is a new manual. Operating system and Version: VSI OpenVMS Version X.X Software Version: VSI COBOL Version X.X VMS Software, Inc., (VSI) Bolton, Massachusetts, USA VSI OpenVMS VSI COBOL DBMS Database Programming Manual: Copyright © 2018 VMS Software, Inc., (VSI), Bolton Massachusetts, USA Legal Notice Confidential computer software. Valid license from VSI required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for VSI products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. VSI shall not be liable for technical or editorial errors or omissions contained herein. HPE, HPE Integrity, HPE Alpha, and HPE Proliant are trademarks or registered trademarks of Hewlett Packard Enterprise. UNIX is a registered trademark of The Open Group. Oracle is a registered trademark of Oracle and/or its affiliates. The VSI OpenVMS documentation
    [Show full text]