Mimer SQL Linux Mobile Guide Version 10.0 Mimer SQL, Linux Mobile Guide, Version 10.0, January 2011 © Copyright Mimer Information Technology AB. The contents of this manual may be printed in limited quantities for use at a Mimer SQL installation site. No parts of the manual may be reproduced for sale to a third party. Information in this document is subject to change without notice. All registered names, product names and trademarks of other companies mentioned in this documentation are used for identification purposes only and are acknowledged as the property of the respective company. Companies, names and data used in examples herein are fictitious unless otherwise noted. Produced and published by Mimer Information Technology AB, Uppsala, Sweden. P.O. Box 1713, SE-751 47 Uppsala, Sweden. Tel +46(0)18-780 92 00. Fax +46(0)18-780 92 40. Mimer SQL Web Sites: http://developer.mimer.com http://www.mimer.com Mimer SQL Version 10.0 i Linux Mobile Guide Contents Chapter 1 Introduction ....................................................................................... 1 Understanding the Concept..........................................................................................1 About Precompiled Statements....................................................................................3 Data Model Example With Statements.........................................................................3 What Happens When Exporting a Database? .............................................................5 Chapter 2 Getting Started on the Desktop ....................................................... 7 Installation and Package Content.................................................................................7 Development Environment............................................................................................8 Create a Database............................................................................................................ 8 Export the Databank Files ............................................................................................... 8 mimpdacopy command............................................................................................... 8 Starting a Mobile Database Server on x86.................................................................. 10 Import Using the mimexport Command ....................................................................... 10 Executing Example on x86..........................................................................................10 Create Databank, Tables and Statements .................................................................. 11 Execute Statements on Development Database........................................................ 12 Export Development Database ..................................................................................... 12 Start Mobile Database and Execute Statements........................................................ 13 Chapter 3 Getting Started on the Device........................................................ 15 The Device Environment .............................................................................................15 Delivered Items for the Device...................................................................................... 15 Software Setup................................................................................................................ 17 Executing Example on Target Platform .....................................................................18 Initiate the Database Server.......................................................................................... 18 Executing on Target Environment ................................................................................ 19 Network Access .............................................................................................................. 20 Avoiding Use of mimcontrol........................................................................................... 20 Using Engine Environment on the Device................................................................... 20 Chapter 4 Application Development............................................................... 21 Supported Database API’s ..........................................................................................21 Java Programming.......................................................................................................... 21 Java/JDBC using the Mimer CLDC/MIDP driver....................................................... 21 Java/JDBC using the Mimer CDC/FP driver ............................................................. 22 Standard Java/JDBC................................................................................................. 22 ii Contents Programming with ODBC.............................................................................................. 22 ODBC using the minodbc driver............................................................................... 22 Embedded SQL in C/C++ ............................................................................................. 23 Chapter 5 Summary Using the Mimer SQL Example Database ................... 25 Installing the Example Database ................................................................................25 Export the Database For Mobile Use..........................................................................25 Start a Mobile Database Server...................................................................................25 Execute Predefined Statements..................................................................................26 Index ................................................................................................................. 33 Mimer SQL Version 10.0 1 Linux Mobile Guide Chapter 1 Introduction Welcome to use Mimer SQL Mobile for Linux. Mimer SQL is a Relational Database management System (RDBMS). This document describes how the Mimer SQL Mobile concept is used on Linux. Mimer SQL can in general be described as self-tuned and powerful, and yet a very compact, database server. It possesses an extensive set of database functionality and is built on international SQL standards. With the Mimer SQL Mobile concept all functionality is remained intact while the runtime footprint is decreased. This is achieved by avoiding the runtime SQL compiling step using precompiled statements. A statement in this sense is a database object holding a predefined SQL statement. The statement can then be executed on the device. These statements can be static or dynamic. In the dynamic case, variables are used to couple the statement to the application. The database, including the statements, is then exported to the target device. Some important aspects for the Mimer SQL Mobile product are the following: Small - The Mimer SQL Mobile database product is optimized to be as small as possible. The database server also automatically compresses data on-the fly and savings of disk space are typically around 60%. Self-tuning - Mimer SQL's self-tuning mechanisms reduce the number of configuration parameters needed and make your database virtually maintenance free. These mechanisms include automatic reorganization of your database that dramatically improves database query performance. Full functionality - Mimer SQL Mobile supports transactions, stored procedures, triggers, referential integrity and multi-user concurrency. The complete support for SQL separates Mimer SQL Mobile from other small footprint databases on the market and enables you to reuse existing SQL knowledge. In addition, full Unicode 4 multi lingual support is provided. Standards - Mimer SQL Mobile conforms to all major SQL standards. Fail-safe - As Mimer SQL Mobile supports transactions, which means that your database is always consistent. Not even a power failure at a critical stage will damage your database. Once it is up and running again, your database automatically recovers to a consistent state. Understanding the Concept The following steps should be carried out to get a Mimer SQL Mobile database up and running on Linux. The steps forms an overview of the concept and the involved components that will be described further later on in this document. 2 Chapter 1 Introduction Understanding the Concept 1 Install Mimer SQL Mobile for Linux Unpack the delivered tar file and execute the miminstall command, or, install the distributed rpm file using the rpm installation procedures. 2 Create a database for development Run the dbinstall program to create a Mimer SQL database. This is an ordinary Mimer SQL database, equal to a database created with the Mimer SQL Engine product. 3 Create and store precompiled statements Create all the database objects for the application. Use the CREATE STATEMENT command to create and store the statements you need for your application logic. This enables you to access the database when it is exported for use in a minimized target environment. This is described further in the next section. 4 Verify the application in development environment Verify the interaction between the application and the database. You can switch the ServerType configuration parameter for the database to indicate that you will enable the Mobile execution mode. 5 Export the database, including created statements Use the mimpdacopy command to prepare and minimize the database for use on the target environment. The created database environment can be used immediately on