Dyalog APL SQAPL Interface Guide Version 6.3

Total Page:16

File Type:pdf, Size:1020Kb

Dyalog APL SQAPL Interface Guide Version 6.3 The tool of thought for expert programming Dyalog APL SQAPL Interface Guide Version 6.3 Dyalog Limited Minchens Court Minchens Lane Bramley Hampshire RG26 5BH United Kingdom Tel: +44 (0)1256 830030 Fax: +44 (0)1256 830031 email: [email protected] http://www.dyalog.com Dyalog is a trademark of Dyalog Limited Copyright 1982-2017 SQL Interface Guide 2 Copyright 2017 by Dyalog Limited. All rights reserved. Version 6.3.0 First Edition January 2013 Document version 20170627 No part of this publication may be reproduced in any form by any means without the prior written permission of Dyalog Limited, Minchens Court, Minchens Lane, Bramley, Hampshire, RG26 5BH, United Kingdom. Dyalog Limited makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Dyalog Limited reserves the right to revise this publication without notification. TRADEMARKS: IBM is a registered trademark of International Business Machines Corporation. Microsoft, MS and MS-DOS are registered trademarks of Microsoft Corporation. SQAPL is copyright of Insight Systems ApS. UNIX is a trademark of X/Open Ltd. Windows, Windows NT, Visual Basic and Excel are trademarks of Microsoft Corporation. All other trademarks and copyrights are acknowledged. SQL Interface Guide 3 Contents C H A P T E R 1 INTRODUCTION .............................................................................. 6 ODBC ................................................................................................................................................ 6 SQAPL ............................................................................................................................................... 7 The LOADDATA Workspace ............................................................................................................... 8 Integrating SQAPL with Your Application .......................................................................................... 9 C H A P T E R 2 INSTALLATION AND CONFIGURATION .................................. 10 SQAPL on macOS ............................................................................................................................ 10 SQAPL on Microsoft Windows ........................................................................................................ 11 C H A P T E R 3 GETTING STARTED ...................................................................... 13 Initialisation .................................................................................................................................... 13 Connecting to a Service .................................................................................................................. 13 Return Codes .................................................................................................................................. 14 SQAPL “Objects” ............................................................................................................................. 15 Disconnecting from a Service .......................................................................................................... 15 Data Dictionary ............................................................................................................................... 15 Executing SQL Statements .............................................................................................................. 16 Bind Variables ................................................................................................................................. 17 Output Variables ............................................................................................................................. 18 APL Types ....................................................................................................................................... 19 Explicit Type Conversions ................................................................................................................ 20 Data Types Supported by a DSN ...................................................................................................... 21 C H A P T E R 4 USING DATA TYPES ..................................................................... 22 Simple Numeric Types .................................................................................................................... 22 High Precision Numbers .................................................................................................................. 22 Complex Numbers .......................................................................................................................... 23 Character Data ................................................................................................................................ 23 Very Wide Char Columns ................................................................................................................ 24 UTF-8 Data ...................................................................................................................................... 24 Binary Data ..................................................................................................................................... 25 Dates and Timestamps.................................................................................................................... 26 APL Arrays ...................................................................................................................................... 28 Conversion Errors ........................................................................................................................... 28 C H A P T E R 5 PREPARE, EXEC, FETCH .............................................................. 29 Low Level Interface ......................................................................................................................... 29 SQA.Prepare ................................................................................................................................... 30 Nulls ............................................................................................................................................... 32 Errors During Statement Execution ................................................................................................. 33 SQA.Describe .................................................................................................................................. 34 SQA.ExecDirect ............................................................................................................................... 35 SQA.Fetch ....................................................................................................................................... 35 Fetching Nulls ................................................................................................................................. 35 SQL Interface Guide 4 Optimising Fetches ......................................................................................................................... 35 C H A P T E R 6 ADVANCED FEATURES ................................................................ 38 Large Objects and Partial Binding.................................................................................................... 38 SQA.PutData ................................................................................................................................... 38 SQA.GetData................................................................................................................................... 39 SCAR Conversion Functions............................................................................................................. 40 Transactions ................................................................................................................................... 41 Remote Procedure Calls .................................................................................................................. 42 C H A P T E R 7 TROUBLESHOOTING GUIDE ...................................................... 43 Common Error Codes ...................................................................................................................... 43 No Error Messages ...................................................................................................................... 43 Exception Handling ......................................................................................................................... 45 SQA.GetInfo .................................................................................................................................... 45 SQA.NativeSQL ............................................................................................................................... 46 FUNCTION REFERENCE ................................................................................................. 47 SQAPL Quick Reference Card .......................................................................................................... 48 SQA.Apl2Scar .......................................................................................................................... 49 SQA.BrowseConnect ............................................................................................................... 49 SQA.Cancel ............................................................................................................................
Recommended publications
  • Cobol/Cobol Database Interface.Htm Copyright © Tutorialspoint.Com
    CCOOBBOOLL -- DDAATTAABBAASSEE IINNTTEERRFFAACCEE http://www.tutorialspoint.com/cobol/cobol_database_interface.htm Copyright © tutorialspoint.com As of now, we have learnt the use of files in COBOL. Now, we will discuss how a COBOL program interacts with DB2. It involves the following terms: Embedded SQL DB2 Application Programming Host Variables SQLCA SQL Queries Cursors Embedded SQL Embedded SQL statements are used in COBOL programs to perform standard SQL operations. Embedded SQL statements are preprocessed by SQL processor before the application program is compiled. COBOL is known as the Host Language. COBOL-DB2 applications are those applications that include both COBOL and DB2. Embedded SQL statements work like normal SQL statements with some minor changes. For example, that output of a query is directed to a predefined set of variables which are referred as Host Variables. An additional INTO clause is placed in the SELECT statement. DB2 Application Programming Following are rules to be followed while coding a COBOL-DB2 program: All the SQL statements must be delimited between EXEC SQL and END-EXEC. SQL statements must be coded in Area B. All the tables that are used in a program must be declared in the Working-Storage Section. This is done by using the INCLUDE statement. All SQL statements other than INCLUDE and DECLARE TABLE must appear in the Procedure Division. Host Variables Host variables are used for receiving data from a table or inserting data in a table. Host variables must be declared for all values that are to be passed between the program and the DB2. They are declared in the Working-Storage Section.
    [Show full text]
  • An Array-Oriented Language with Static Rank Polymorphism
    An array-oriented language with static rank polymorphism Justin Slepak, Olin Shivers, and Panagiotis Manolios Northeastern University fjrslepak,shivers,[email protected] Abstract. The array-computational model pioneered by Iverson's lan- guages APL and J offers a simple and expressive solution to the \von Neumann bottleneck." It includes a form of rank, or dimensional, poly- morphism, which renders much of a program's control structure im- plicit by lifting base operators to higher-dimensional array structures. We present the first formal semantics for this model, along with the first static type system that captures the full power of the core language. The formal dynamic semantics of our core language, Remora, illuminates several of the murkier corners of the model. This allows us to resolve some of the model's ad hoc elements in more general, regular ways. Among these, we can generalise the model from SIMD to MIMD computations, by extending the semantics to permit functions to be lifted to higher- dimensional arrays in the same way as their arguments. Our static semantics, a dependent type system of carefully restricted power, is capable of describing array computations whose dimensions cannot be determined statically. The type-checking problem is decidable and the type system is accompanied by the usual soundness theorems. Our type system's principal contribution is that it serves to extract the implicit control structure that provides so much of the language's expres- sive power, making this structure explicitly apparent at compile time. 1 The Promise of Rank Polymorphism Behind every interesting programming language is an interesting model of com- putation.
    [Show full text]
  • 2020-2021 Course Catalog
    Unlimited Opportunities • Career Training/Continuing Education – Page 4 • Personal Enrichment – Page 28 • High School Equivalency – Page 42 • Other Services – Page 46 • Life Long Learning I found the tools and resources to help me transition from my current career to construction management through an Eastern Suffolk BOCES Adult Education Blueprint Reading course. The program provided networking opportunities which led me to my new job. 2020-2021 COURSE CATALOG SHARE THIS CATALOG with friends and family Register online at: www.esboces.org/AEV Adult Education Did You Know... • Adult Education offers over 50 Career Training, Licensing and Certification programs and 30 Personal Enrichment classes. • Financial aid is available for our Cosmetology and Practical Nursing programs. • We offer national certifications for Electric, Plumbing and HVAC through the National Center for Construction Education and Research. • Labor Specialists and Vocational Advisors are available to assist students with planning their careers, registration and arranging day and evening tours. • Continuing Education classes are available through our on-line partners. The Center for Legal Studies offers 15 classes designed for beginners as well as advanced legal workers. In addition, they provide 6 test preparation courses including SAT®, GMAT® and LSAT®. UGotClass offers over 40 classes in Business, Management, Education and more. • Internship opportunities are available in many of our classes to assist the students to build skills towards employment. Do you know what our students are saying about us? “New York State “Great teacher. Answered Process Server is all questions and taught a very lucrative “I like how the Certified Microsoft Excel in a way “I took Introduction to side business.
    [Show full text]
  • Heritage Ascential Software Portfolio, Now Available in Passport Advantage, Delivers Trustable Information for Enterprise Initiatives
    Software Announcement July 18, 2006 Heritage Ascential software portfolio, now available in Passport Advantage, delivers trustable information for enterprise initiatives Overview structures ranging from simple to highly complex. It manages data At a glance With the 2005 acquisition of arriving in real time as well as data Ascential Software Corporation, received on a periodic or scheduled IBM software products acquired IBM added a suite of offerings to its basis and enables companies to from Ascential Software information management software solve large-scale business problems Corporation are now available portfolio that helps you profile, through high-performance through IBM Passport Advantage cleanse, and transform any data processing of massive data volumes. under new program numbers and across the enterprise in support of A WebSphere DataStage Enterprise a new, simplified licensing model. strategic business initiatives such as Edition license grants entitlement to You can now license the following business intelligence, master data media for both WebSphere programs for distributed platforms: DataStage Server and WebSphere management, infrastructure • consolidation, and data governance. DataStage Enterprise Edition. Core product: WebSphere The heritage Ascential programs in Datastore Enterprise Edition, this announcement are now WebSphere RTI enables WebSphere WebSphere QualityStage available through Passport DataStage jobs to participate in a Enterprise Edition, WebSphere Advantage under a new, service-oriented architecture (SOA)
    [Show full text]
  • SQL Server Express: Setting up for Unistream User Guide 3/17
    Headquarters Unitronics (1989) (R"G). Unitronics Building, Airport City P.O.B. 300, Ben Gurion Airport, Israel 70100 Tel: + 972 (3) 977 8888 Fax: + 972 (3) 977 8877 SQL Server Express: Setting up for UniStream User Guide 3/17 Contents SQL Server Express: Setting up for UniStream ...................................................... 1 Overview ....................................................................................................... 1 Supported Controllers ...................................................................................... 1 First-time Installation & Configuration ................................................................. 2 Download ...................................................................................................... 2 Installing SQL Server ...................................................................................... 3 Setting up the Local Database .......................................................................... 5 Configuring SQL Server ................................................................................... 6 Activating the SQL Server Browser. ................................................................ 6 Enable TCP/IP, Assign Port ............................................................................ 7 Create a new Login ....................................................................................... 8 SQL Server Express—Existing Installation ........................................................... 10 Enable TCP/IP, Assign Port
    [Show full text]
  • Cohesity Dataplatform Protecting Individual MS SQL Databases Solution Guide
    Cohesity DataPlatform Protecting Individual MS SQL Databases Solution Guide Abstract This solution guide outlines the workflow for creating backups with Microsoft SQL Server databases and Cohesity Data Platform. Table of Contents About this Guide..................................................................................................................................................................2 Intended Audience..............................................................................................................................................2 Configuration Overview.....................................................................................................................................................2 Feature Overview.................................................................................................................................................................2 Installing Cohesity Windows Agent..............................................................................................................................2 Downloading Cohesity Agent.........................................................................................................................2 Select Coheisty Windows Agent Type.........................................................................................................3 Install the Cohesity Agent.................................................................................................................................3 Cohesity Agent Setup........................................................................................................................................4
    [Show full text]
  • Developing Embedded SQL Applications
    IBM DB2 10.1 for Linux, UNIX, and Windows Developing Embedded SQL Applications SC27-3874-00 IBM DB2 10.1 for Linux, UNIX, and Windows Developing Embedded SQL Applications SC27-3874-00 Note Before using this information and the product it supports, read the general information under Appendix B, “Notices,” on page 209. Edition Notice This document contains proprietary information of IBM. It is provided under a license agreement and is protected by copyright law. The information contained in this publication does not include any product warranties, and any statements provided in this manual should not be interpreted as such. You can order IBM publications online or through your local IBM representative. v To order publications online, go to the IBM Publications Center at http://www.ibm.com/shop/publications/ order v To find your local IBM representative, go to the IBM Directory of Worldwide Contacts at http://www.ibm.com/ planetwide/ To order DB2 publications from DB2 Marketing and Sales in the United States or Canada, call 1-800-IBM-4YOU (426-4968). 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 1993, 2012. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Introduction to embedded Include files for COBOL embedded SQL SQL................1 applications .............29 Embedding SQL statements
    [Show full text]
  • JSON and PL/SQL: a Match Made in Database
    JSON and PL/SQL: A Match Made in Database Copyright © 2018 Oracle and/or its affiliates. All rights reserved. | 1 Resources for Oracle Database Developers • Official homes of SQL and PL/SQL - oracle.com/sql oracle.com/plsql • Dev Gym: quizzes, workouts and classes - devgym.oracle.com • Ask Tom - asktom.oracle.com – 'nuff said (+ new: Office Hours!) • LiveSQL - livesql.oracle.com – script repository and 24/7 18c database • SQL-PL/SQL discussion forum on OTN https://community.oracle.com/community/database/developer-tools/sql_and_pl_sql • PL/SQL and EBR blog by Bryn Llewellyn - https://blogs.oracle.com/plsql-and-ebr • Oracle Learning Library - oracle.com/oll • oracle-base.com - great content from Tim Hall • oracle-developer.net - great content from Adrian Billington Copyright © 2018 Oracle and/or its affiliates. All rights reserved. | Some Questions for You • Do you write code in the database? • Do you write UI code as well? • Do you work with UI developers? • Do you fight with UI developers? • Who has the ear of management, the database developers or the UI developers? Copyright © 2018 Oracle and/or its affiliates. All rights reserved. | What is JSON? • JavaScript Object Notation – A "lightweight", readable data interchange format. In other words, NOT XML. Squiggles instead of angle brackets. WAY better! J – Language independent, but widely used by UI developers, especially those working in JavaScript. • Built on two structures: – Name-value pair collections – Order list of values: aka, arrays Copyright © 2018 Oracle and/or its affiliates. All rights reserved. | What is JSON? (continued) • JSON object - unordered set of name-value pairs • JSON array - ordered collection of values.
    [Show full text]
  • The Object Constraint Language
    25/06/2012 Object Constraint Language A definitive guide Jordi Cabot – AtlanMod / EMN / INRIA /LINA/… Martin Gogolla – University of Bremen (with the invaluable help of slides of the BiG group - TUWien) http://modeling-languages.com @softmodeling © AtlanMod ‐ atlanmod‐contact@mines‐nantes.fr 1 Before we start… . OCL is not sexy and neither are these slides . Interrupt and participate at any time – No place to hide © AtlanMod ‐ atlanmod‐contact@mines‐nantes.fr 2 1 25/06/2012 WHY OCL? 3 © l Why OCL No serious use of UML without OCL!!! (limited expressiveness of ALL (graphical) notations © AtlanMod ‐ atlanmod‐contact@mines‐nantes.fr 4 2 25/06/2012 What does the model NOT say OCL is everywhere . Where can we find OCL? . Constraints . Well-formedness rules . Derivation rules . Pre/posconditions . Guards . Model to model transformations . Model to text transformations . … 3 25/06/2012 Why OCL Natural language is clearly not enough © AtlanMod ‐ atlanmod‐contact@mines‐nantes.fr 7 Motivation . Example 1 Employee age: Integer Please no underaged employees! age > =18 e1:Employee e2:Employee e3:Employee age = 17 age = 37 alter = 21 8 4 25/06/2012 Why OCL - Alternatives to OCL . NL . FOL . Alloy . SQL . DSLs for specific business rule patterns . Visual OCL . SBVR . … others? . You may not like it but right now there is nothing better than OCL!! (and so tightly integreated already with the other existing modeling standards) © AtlanMod ‐ atlanmod‐contact@mines‐nantes.fr 9 Why OCL – Visual OCL Context Person inv: VS self.isMarried implies self.wife>=18 or self.husband>=18 © AtlanMod ‐ atlanmod‐contact@mines‐nantes.fr 10 5 25/06/2012 Why OCL - SBVR .
    [Show full text]
  • APL2 and SQL: a Tutorial
    APL2 and SQL: A Tutorial August. 1989 Nancy Wheeler IBM APL Development Santa Teresa laboratory San Jose, California Reprinted with permission from the proceedings of APL89, August 1989, New York, New York. Copyright 1989, Association for Computing Machinery, Inc. ii APL2 and SQL: A Tutorial Contents Part I: SQL I Relational Data 1 SQL Statements 2 Data Defmition 2 Data Manipulation 3 Data Retrieval 4 Authorization Statements 5 Control Statements 5 Analysis 6 Using SQL 7 Using SQL from Programs 7 Static SQL vs. Dynamic SQL 7 Part 2: APL2 8 Relational Data in APL2 8 SQL Statements in APL2 9 Data Definition, Authorization 10 Data Manipulation 10 Data Retrieval 11 Control Statements 17 EXPLAIN 19 Error Handling 19 Part 3: APL2 and SQL 23 Locking 23 Lock Size 23 Isolation Level 23 Explicit Lock Control 24 Authority 25 The Index 25 Storage 26 Performance 27 Appendix A. SQL Statement Summary 28 Appendix B. AP 127 Operations and SQL Workspace Functions 29 Appendix C. Return Code Summary 31 Appendix D. Installation Instructions 32 SQL/DS (CMS) Environment 32 DB2 (TSO) Environment 33 Appendix E. References 35 DB2 Publications 35 SQL/DS Publications 35 APL2 Publications 35 Contents iii Other 35 iv APL2 and SQL: A Tutorial Figures I. Relational Table 1 2. CREATE TABLE statement 2 3. Data Manipulation Statements 4 4. Data Retrieval Statements 4 5. Authorization Statements 5 6. Control Statements 6 7. Relational data in an APL2 matrix 8 8. Relational data in an ApL2 vector 9 9. Data Definition Statements from APL2 10 10. Data Manipulation Statements in APL2 11 11.
    [Show full text]
  • SQL to Hive Cheat Sheet
    We Do Hadoop Contents Cheat Sheet 1 Additional Resources 2 Query, Metadata Hive for SQL Users 3 Current SQL Compatibility, Command Line, Hive Shell If you’re already a SQL user then working with Hadoop may be a little easier than you think, thanks to Apache Hive. Apache Hive is data warehouse infrastructure built on top of Apache™ Hadoop® for providing data summarization, ad hoc query, and analysis of large datasets. It provides a mechanism to project structure onto the data in Hadoop and to query that data using a SQL-like language called HiveQL (HQL). Use this handy cheat sheet (based on this original MySQL cheat sheet) to get going with Hive and Hadoop. Additional Resources Learn to become fluent in Apache Hive with the Hive Language Manual: https://cwiki.apache.org/confluence/display/Hive/LanguageManual Get in the Hortonworks Sandbox and try out Hadoop with interactive tutorials: http://hortonworks.com/sandbox Register today for Apache Hadoop Training and Certification at Hortonworks University: http://hortonworks.com/training Twitter: twitter.com/hortonworks Facebook: facebook.com/hortonworks International: 1.408.916.4121 www.hortonworks.com We Do Hadoop Query Function MySQL HiveQL Retrieving information SELECT from_columns FROM table WHERE conditions; SELECT from_columns FROM table WHERE conditions; All values SELECT * FROM table; SELECT * FROM table; Some values SELECT * FROM table WHERE rec_name = “value”; SELECT * FROM table WHERE rec_name = "value"; Multiple criteria SELECT * FROM table WHERE rec1=”value1” AND SELECT * FROM
    [Show full text]
  • Embedded SQL Guide for RM/Cobol
    Firebird Embedded SQL Guide for RM/Cobol Embedded SQL Guide for RM/Cobol 3 Table of Contents 1. Program Structure...............................................................................................................................6 1.1. General...........................................................................................................................................6 1.2. Reading this Guide.........................................................................................................................6 1.3. Definition of Terms........................................................................................................................6 1.4. Declaring Host Variables...............................................................................................................7 1.5. Declaring and Accessing Databases...............................................................................................7 1.6. Transactions....................................................................................................................................7 1.7. SQL Statements..............................................................................................................................8 1.8. Statement Handles..........................................................................................................................8 1.9. Dynamic SQL (DSQL)...................................................................................................................8 1.10. Error
    [Show full text]