The PrimeBase REALbasic Plug-in
Version 1.12

Table Of Contents

Introduction

Requirements

Documentation

Release Notes



Introduction

The PrimeBase Plug-in for REALbasic can be used with REALbasic to build applications accessing a PrimeBase database server and targeted for Mac OSX (Mach), Mac Carbon, Windows, and Linux Operating systems. In order to use your application you must also install the PrimeBase VM library on the machine on which the application is to run.

All required PrimeBase libraries can be downloaded from the PrimeBase website. Download and install the SDK package for the platform(s) that you are interested in. If you have already installed other PrimeBase products you may already have the desired libraries installed.


Requirements

Applications that use the PrimeBase REALbasic plug-in requires one or both of the following libraries to be install on the machine on which the application will be running.

For client/server connections the PrimeBase Virtual Machine library is required. The name of the library is platform dependent:

For runtime connections the PrimeBase Runtime Server library is required. The name of the library is platform dependent: In order for an application using the PrimeBase REALbasic plug-in to run the PrimeBase Virtual Machine library and/or the PrimeBase Runtime Server library must be installed on the machine first. If it is not installed the application will not be able to connect to a Primebase data source and will return an error when trying to connect stating that it could not find the required library and the name of the library it failed to find.

In addition, Mac OSX Carbon applications require the PBAPI.bundle library. This is a gateway library that loads the libpbvm.so or libpbds.so library as required. Developers must be aware of this because as a result, any file paths used in PBT code executed by the plug-in must be in 'unix' format.

When trying to load a library the following search will be performed based on the application type and platform:


Mac PPC (Classic Carbon):

Library name: "PBVMLib" or "PBDSLIB"
Search path:

 1) The folder in which the application is running.
 2) The system extensions folder.
 


Mac OSX (Carbon/Mach):

Library name:"PBAPI.bundle" and "libpbvm.so" or "libpbds.so"
Search path:

 1) The folder in which the application is running.
 2) /usr/local/primebase/libs.


Windows:

Library name: "PBVM.DLL" or "PBDS.DLL"
Search path:

 1) The folder in which the application is running.
 2) In the system32 folder.


Linux:

Library name:"libpbvm.so" or "libpbds.so"
Search path:

 1) The folder in which the application is running.
 2) /usr/local/primebase/libs.