Document describes a way of migrating CA-Clipper or (X)Harbour applications to an SQL environment using Mediator RDD. It also contains some hints how to effectively use Mediator and the description of additional functions of the software package. Mediator v.5.0 User’s Guide and Reference © OTC S.A., 2012 Contents I. INTRODUCTION ....................................................................... I-1 1. MEDIATOR ....................................................................................................... I-1 2. The MEDNTX driver ........................................................................................ I-4 3. The MEDCDX driver ........................................................................................ I-4 4. Application migration – the MEDNTX and MEDCDX drivers ....................... I-4 5. Language extensions ..................................................................................... I-5 6. Working in WAN .............................................................................................. I-5 7. Summary ......................................................................................................... I-5 II. GETTING STARTED ................................................................ II-1 1. The necessary components .......................................................................... II-1 2. Preparation of Windows NT/2000/XP server ................................................ II-3 3. Preparation of the database server .............................................................. II-4 a) Preparation of the Oracle server ................................................................................ II-4 b) Preparing the Microsoft SQL Server .......................................................................... II-5 c) Preparing Sybase Adaptive Server Anywhere ........................................................... II-7 d) Preparing PostgreSQL ............................................................................................... II-8 e) Preparing other DBMSs ............................................................................................. II-9 4. Preparing the MEDIATOR server ................................................................ II-10 5. Preparing the CA-Clipper client .................................................................. II-10 6. Setting up the (x)Harbour client ................................................................. II-13 7. Compatibility between the versions of the Mediator client and the server II- 15 III. OPERATING THE MEDIATOR SERVER ............................... III-1 1. Mediator for Windows NT/2k/XP (desktop version) ................................... III-1 a) Starting the server .................................................................................................... III-1 b) Configuration and management ............................................................................... III-1 c) The main panel of the Mediator server for Windows ................................................ III-2 2. Mediator for Windows NT/2k/XP (service version) .................................... III-4 a) Starting the server .................................................................................................... III-4 b) Configuration and management ............................................................................... III-4 3. Mediator for NetWare ................................................................................... III-4 a) Starting the server .................................................................................................... III-4 b) Configuration and management ............................................................................... III-4 c) The main panel of the Mediator server for NetWare ................................................. III-4 4. An external configuration program with a monitor for Mediator servers III-7 a) MMT application console .......................................................................................... III-7 b) Server description (window: Description of...) ........................................................ III-10 c) Editing Mediator server parameters (dialog: Configure Server...) .......................... III-12 d) Defining, editing and deleting users of the Mediator server (dialog: Users of...) .... III-15 e) System monitor ....................................................................................................... III-19 MEDIATOR 5.0. User’s Guide i IV. ADAPTING APPLICATIONS FOR WORK WITH RELATIONAL DATABASE MANAGEMENT SYSTEM .................................. IV-1 1. RDD drivers: MEDNTX and MEDCDX ......................................................... IV-1 2. Planning of application porting .................................................................. IV-1 3. Stages of adapting an application .............................................................. IV-1 4. Stage I: basic porting of an application ..................................................... IV-2 a) Data export ............................................................................................................... IV-2 b) Modification of the application source code .............................................................. IV-5 c) Benefits acquired from first stage of adapting an application ................................... IV-8 5. Stage II: the interface to the RDBMS transaction system ........................ IV-9 a) Introducing transactions ............................................................................................ IV-9 b) Benefits acquired from stage II of adapting an application ..................................... IV-10 6. Stage III: using SQL extensions ............................................................... IV-11 a) Introduction of SQL ................................................................................................. IV-11 b) Benefits acquired from stage III of adapting an application .................................... IV-12 7. Stage IV: integrating an application with other SQL applications ........ IV-12 8. Portability ................................................................................................... IV-13 9. Guidelines for Clip-4-Win users ............................................................... IV-13 V. EXTENSIONS OF THE MEDIATOR PACKAGE ...................... V-1 1. Using objects owned by other users .......................................................... V-1 2. Using non-standard extensions in names of databases and indexes ..... V-1 3. Cooperation of MEDNTX and MEDCDX drivers ......................................... V-2 4. The scope mechanism (SCOPE) ................................................................. V-2 5. Deleting objects from the database ............................................................ V-3 6. Filtering ......................................................................................................... V-3 7. Using SQL ..................................................................................................... V-5 8. Trapping SQL errors ..................................................................................... V-6 9. Transactions ................................................................................................. V-6 10. The record marking subsystem in RDBMS ................................................ V-8 11. Specification of storage parameters for tables and indexes in Oracle .... V-8 12. Locking tables and records ......................................................................... V-9 13. Mediator client in multithreaded applications .......................................... V-10 VI. WORKING WITH UNICODE .................................................... VI-1 VII. FUNCTIONS AND PROCEDURES OF MEDNTX AND MEDCDX DRIVERS ................................................................................ VII-8 1. BEGIN TRANSACTION ................................................................................................... VII-8 2. COMMIT TRANSACTION .............................................................................................. VII-9 3. DROP INDEX .................................................................................................................... VII-9 4. DROP TABLE .................................................................................................................... VII-9 5. MedAdir ............................................................................................................................ VII-10 6. MedChgPwd ..................................................................................................................... VII-11 7. MedChrIdxT ..................................................................................................................... VII-11 8. MedClntId ......................................................................................................................... VII-12 9. MedClpComp ................................................................................................................... VII-12 ii MEDIATOR 5.0. User’s Guide 10. MedClrTbCa .................................................................................................................... VII-12 11. MedClrScpe .....................................................................................................................