WG3:HBA-007 H2-2003-309 August, 2003 ISO International Organization for Standardization ANSI American National Standards Institute ANSI TC NCITS H2 ISO/IEC JTC 1/SC 32/WG 3 Database Title: (ISO-ANSI Working Draft) Object Language Bindings (SQL/OLB) Author: Jim Melton (Editor) References: 1) WG3:HBA-002 = H2-2003-304 = 5WD-01-Framework-2003-09, WD 9075-1 (SQL/Framework), September, 2003 2) WG3:HBA-003 = H2-2003-305 = 5WD-02-Foundation-2003-09, WD 9075-2 (SQL/Foundation), September, 2003 3) WG3:HBA-004 = H2-2003-306 = 5WD-03-CLI-2003-09, WD 9075-3 (SQL/CLI), September, 2003 4) WG3:HBA-005 = H2-2003-307 = 5WD-04-PSM-2003-09, WD 9075-4 (SQL/PSM), September, 2003 5) WG3:HBA-006 = H2-2003-308 = 5WD-09-MED-2003-09, WD 9075-9 (SQL/MED), September, 2003 6) WG3:HBA-007 = H2-2003-309 = 5WD-10-OLB-2003-09, WD 9075-10 (SQL/OLB), September, 2003 7) WG3:HBA-008 = H2-2003-310 = 5WD-11-Schemata-2003-09, WD 9075-11 (SQL/Schemata), September, 2003 8) WG3:HBA-009 = H2-2003-311 = 5WD-13-JRT-2003-09, WD 9075-13 (SQL/JRT), September, 2003 9) WG3:HBA-010 = H2-2003-312 = 5WD-14-XML-2003-09, WD 9075-14 (SQL/XML), September, 2003 2 ISO/IEC JTC 1/SC 32 Date: 2003-07-25 ISO/IEC 9075-10:2003 (E) ISO/IEC JTC 1/SC 32/WG 3 United States of America (ANSI) Information technology Ð Database languages Ð SQL Ð Part 10: Object Language Bindings (SQL/OLB) Technologies de l©informationÐ Langages de base de données — SQL — Partie 10: Liaison de Langage Object (SQL/OLB) Document type: International standard Document subtype: Document stage: (4) Approval Document language: English Copyright notice This ISO document is a Draft International Standard and is copyright-protected by ISO. Except as permitted under the applicable laws of the user's country, neither this ISO draft nor any extract from it may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, photocopying, recording, or otherwise, without prior written permission being secured. Requests for permission to reproduce should be addressed to ISO at the address below or ISO's member body in the country of the requester. Copyright Manager ISO Central Secretariat 1 rue de Varembé 1211 Geneva 20 Switzerland tel. +41 22 749 0111 fax +41 22 734 1079 internet: [email protected] Reproduction may be subject to royalty payments or a licensing agreement. Violaters may be prosecuted. Contents Page Foreword. xix Introduction. xx 1 Scope. 1 2 Normative references. 3 2.1 JTC 1 standards. 3 2.2 Other international standards. 3 3 Definitions, notations, and conventions. 5 3.1 Definitions. 5 3.1.1 Definitions provided in Part 10. 5 3.2 Notation. 6 3.3 Conventions. 7 3.3.1 Use of terms. 7 3.3.1.1 Other terms. 7 3.3.2 Specification of translator-generated classes. 8 4 Concepts. 11 4.1 Introduction. 11 4.2 Embedded syntax. 11 4.3 SQL constructs. 12 4.4 Character strings. 12 4.4.1 Unicode support. 12 4.4.2 Character sets. 13 4.5 Host variables. 13 4.6 Host expressions. 13 4.7 SQLJ clauses. 14 4.8 Database connection context. 14 4.9 Default connection context. 15 4.10 Schema checking using exemplar schemas. 15 4.11 Using multiple SQLJ contexts and connections. 16 4.12 Dynamic SQL and JDBC/SQLJ Connection interoperability. 16 4.12.1 Creating an SQLJ ConnectionContext from a JDBC connection. 16 4.12.2 Obtaining a JDBC connection from an SQLJ ConnectionContext. 17 4.12.3 Connection sharing. 17 4.12.4 Connection resource management. 17 4.13 SQL execution control and status. 18 4.14 Iterators. 19 4.15 Input and output assignability. 20 ©ISO/IEC 2003 – All rights reserved Contents iii ISO/IEC 9075-10:2003 (E) 4.16 Calls to stored procedures and functions. 31 4.17 Multiple JDBC ResultSet objects from stored procedure calls. 31 4.17.1 Resource management with multiple results. 32 4.18 JDBC/SQLJ ResultSet interoperability. 32 4.18.1 Creating an SQLJ iterator from a JDBC ResultSet object. 32 4.18.2 Obtaining a JDBC ResultSet object from an SQLJ iterator object. 33 4.18.3 Obtaining a JDBC ResultSet object from an untyped iterator object. 33 4.18.4 Iterator and JDBC ResultSet resource management. 33 4.19 Multi-threading considerations. 34 4.20 User-defined data types. 34 4.21 Batch updates. 35 4.21.1 Batchable statements and batch compatibility. 35 4.21.2 Statement batching API. ..