mime-version: 1.0
date: Fri, 25 Jun 2010 16:39:26 -0500
content-transfer-encoding: quoted-printable
content-location: http://ww1.pervasive.com/developerzone/access_methods/readme_oledb.html
x-mimeole: Produced By Microsoft MimeOLE V6.00.2900.5931
from: <Saved by Windows Internet Explorer 8>
subject: Pervasive PSQL v9 OLE DB Provider
content-type: text/html;
	charset="Windows-1252"

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML xmlns:mso=3D"urn:schemas-microsoft-com:office:office" xmlns:msdt=3D"=
uuid:C2F41010-65B3-11d1-A29F-00AA00C14882"><HEAD><TITLE>Readme PSQL v9 OLE=
 DB Provider</TITLE>
<META content=3D"text/html; charset=3Dwindows-1252" http-equiv=3DContent-T=
ype>
<META name=3DAUTHOR content=3D"Pervasive Software">
<META name=3DDESCRIPTION=20
content=3D"Information about the Pervasive OLE DB Provider">
<META name=3DOWNER content=3D"Pervasive Developer Solutions Team">
<STYLE>BODY {
	FONT-FAMILY: Verdana, Arial, Helvetica, MS Sans Serif; FONT-SIZE: 80%; MA=
RGIN-RIGHT: 10em
}
A:link {
	FONT-FAMILY: Verdana; COLOR: #008000
}
A:active {
	FONT-FAMILY: Verdana; COLOR: #8fbc8b
}
A:visited {
	FONT-FAMILY: Verdana; COLOR: #996699
}
A:hover {
	BACKGROUND-COLOR: #996699; FONT-FAMILY: Verdana; COLOR: #ffffff
}
P {
	MARGIN-TOP: 0.6em; FONT-FAMILY: Verdana; MARGIN-BOTTOM: 0.6em; MARGIN-LEF=
T: 1em
}
H1 {
	BORDER-BOTTOM: black solid; MARGIN-BOTTOM: 0.5em; FONT-SIZE: 160%
}
H2 {
	MARGIN-TOP: 1.5em; MARGIN-BOTTOM: 0.5em; FONT-SIZE: 140%
}
H3 {
	MARGIN-TOP: 1.2em; MARGIN-BOTTOM: 0.5em; FONT-SIZE: 110%; xfont-size: 110%
}
H4 {
	MARGIN-TOP: 1.2em; MARGIN-BOTTOM: 0.5em; FONT-SIZE: 105%; xfont-size: 105%
}
H5 {
	MARGIN-TOP: 1.2em; MARGIN-BOTTOM: 0.5em; FONT-SIZE: 100%
}
BIG {
	FONT-SIZE: 105%; FONT-WEIGHT: bold
}
OL {
	MARGIN-TOP: 0.6em; MARGIN-BOTTOM: 0em; MARGIN-LEFT: 4em
}
UL {
	LIST-STYLE-TYPE: square; MARGIN-TOP: 0.6em; FONT-FAMILY: Verdana; MARGIN-=
BOTTOM: 0em
}
UL UL {
	MARGIN-TOP: 0em
}
UL LI {
	FONT-FAMILY: Verdana
}
P LI {
	LIST-STYLE-TYPE: square; FONT-FAMILY: Verdana; MARGIN-BOTTOM: 0em
}
LI P {
	FONT-FAMILY: Verdana
}
TABLE {
	MARGIN-TOP: 1em; MARGIN-LEFT: 5em; FONT-SIZE: 100%; MARGIN-RIGHT: 5em; ce=
ll-padding: 10
}
TH {
	TEXT-ALIGN: left; FONT-FAMILY: Verdana; BACKGROUND: #d3d3d3; VERTICAL-ALI=
GN: bottom
}
TR {
	VERTICAL-ALIGN: top
}
TD {
	FONT-FAMILY: Verdana; VERTICAL-ALIGN: top
}
STRONG {
	COLOR: maroon; FONT-WEIGHT: bold; TEXT-DECORATION: none
}
P.note {
	BORDER-BOTTOM: silver solid; BORDER-LEFT: silver solid; PADDING-BOTTOM: 1=
%; BACKGROUND-COLOR: #ffffee; PADDING-LEFT: 1%; PADDING-RIGHT: 1%; MARGIN-=
LEFT: 10em; BORDER-TOP: silver solid; MARGIN-RIGHT: 10em; BORDER-RIGHT: si=
lver solid; PADDING-TOP: 1%
}
PRE {
	MARGIN-TOP: 1.2em; FONT-FAMILY: Courier; MARGIN-BOTTOM: 1.5em; COLOR: blu=
e; MARGIN-LEFT: 5em
}
CODE {
	FONT-FAMILY: Courier; COLOR: blue
}
P.question {
=09
}
</STYLE>

<META name=3DGENERATOR content=3D"MSHTML 8.00.6001.18928">
<!--[if gte mso 9]><xml>
<mso:CustomDocumentProperties>
<mso:PDB_ProductTaxHTField0 msdt:dt=3D"string">PSQL v9|7e3e4af7-15e0-439e-=
9929-f38b98b53be7</mso:PDB_ProductTaxHTField0>
<mso:PDB_Product msdt:dt=3D"string">27;#PSQL v9|7e3e4af7-15e0-439e-9929-f3=
8b98b53be7</mso:PDB_Product>
<mso:Publication_Date msdt:dt=3D"string">2006-05-01T00:00:00Z</mso:Publica=
tion_Date>
<mso:PDB_Synopsis msdt:dt=3D"string"></mso:PDB_Synopsis>
<mso:TaxCatchAll msdt:dt=3D"string">27;#PSQL v9|7e3e4af7-15e0-439e-9929-f3=
8b98b53be7</mso:TaxCatchAll>
</mso:CustomDocumentProperties>
</xml><![endif]-->
</HEAD>
<BODY>
<H1>Pervasive PSQL v9 OLE DB Provider - May 2006</H1>
<P>This document contains the following topics: </P>
<UL>
  <LI><A=20
  href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_Per=
vasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#about">About=20
  the OLE DB Provider</A>=20
  <LI><A=20
  href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_Per=
vasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#features">Features</A=
>=20

  <LI><A=20
  href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_Per=
vasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#requirements">System=
=20
  Requirements</A>=20
  <LI><A=20
  href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_Per=
vasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#getstart">Getting=20
  Started</A>=20
  <UL>
    <LI><A=20
    href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_P=
ervasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#install">Installati=
on</A>=20

    <LI><A=20
    href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_P=
ervasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#comps">Components=20
    List</A>=20
    <LI><A=20
    href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_P=
ervasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#usingpvid">Using=20
    the PVideoDB Sample Database</A> </LI></UL>
  <LI><A=20
  href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_Per=
vasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#kissues">Known=20
  Issues</A>=20
  <LI><A=20
  href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_Per=
vasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#links">Useful=20
  Links</A>=20
  <LI><A=20
  href=3D"http://ww1.pervasive.com/developerzone/access_methods/Readme_Per=
vasive%20PSQL%20v9%20OLE%20DB%20Provider_May2006.mht#disclaim">Disclaimer<=
/A>=20
  </LI></UL>
<H2><A name=3Dabout></A>About the OLE DB Provider</H2>
<P>This release of the OLE DB provider for Pervasive PSQL contains the fol=
lowing=20
resources:=20
<UL>
  <LI>OLE DB binary files=20
  <LI>OLE DB documentation </LI></UL>
<P></P>
<H2><A name=3Dfeatures></A>Features</H2>
<P>See <I>OLE DB Provider Guide</I> for complete information on the featur=
es of=20
the OLE DB provider. This manual is included in PDF format and can also be=
=20
viewed in the Pervasive Library at: <A=20
href=3D"http://www.pervasive.com/library/index.asp?_pub=3Dole_910">http://=
www.pervasive.com/library/index.asp?_pub=3Dole_910</A>.=20
</P>
<H2><A name=3DRequirements></A>System Requirements</H2>
<UL>
  <LI>Existing install of Pervasive PSQL v9 Engine=20
  <LI>MDAC 2.5 (2.7 or higher preferred). See <A=20
  href=3D"http://msdn.microsoft.com/data/mdac"=20
  target=3D_new>http://msdn.microsoft.com/data/mdac</A> to obtain MDAC. </=
LI></UL>
<H2><A name=3Dgetstart></A>Getting Started</H2>
<H3><A name=3Dinstall></A>Installation</H3>
<P><!---The following statement will be true again in v9.5 - commenting ou=
t for now --><!---The OLE DB provider is shipped with the Pervasive.SQL en=
gine. -->here=20
is no separate install for the OLE DB interface. The OLE DB runtime binari=
es=20
listed under the Components List are installed by the PSQL engine installa=
tion.=20
PSQL v9 SP2 OLE DB SDK is available for download at: <A=20
href=3D"http://www.pervasive.com/developerzone/access_methods/oledbado.asp=
"=20
target=3D_new>http://www.pervasive.com/developerzone/access_methods/oledba=
do.asp</A>.=20
</P>
<H3><A name=3Dcomps></A>Components List</H3>
<H3>&nbsp;</H3>
<TABLE border=3D1 cellPadding=3D10 width=3D179>
  <TBODY>
  <TR>
    <TH>Component</TH></TR>
  <TR>
    <TD>POLEDB.DLL</TD></TR>
  <TR>
    <TD>POLEDBER.DLL</TD></TR>
  <TR>
    <TD>POLEDBSY.DLL</TD></TR></TBODY></TABLE>
<P>&nbsp;</P>
<H3><A name=3Dusingpvid></A>Using the PVideoDB Sample Database</H3>
<P>The SDK includes the data files and dictionary files (DDFs) for a sampl=
e=20
database named PVideoDB. The sample database simulates the management of a=
 video=20
store. The data files and DDFs are located in=20
&lt;<I>directory</I>&gt;\samples\PvideoDB, where &lt;<I>directory</I>&gt; =
is the=20
directory where you installed the OLE DB provider. </P>
<P>In addition, the OLE DB provider includes code samples for use with the=
=20
PVideoDB database. To use the code samples, you must first create the PVid=
eoDB=20
database.</P>
<P><B>Note:</B> If you are using a Linux server and windows client, use th=
e=20
following procedure to compile the sample files: </P>
<OL>
  <LI>Browse to <FONT color=3D#0000ff>PSQL-SDK-OLEDB-9.50.066.000-Win32.ex=
e</FONT>=20
  usually present in the build repository.=20
  <LI>Unzip this file to the convienent folder of your choice (For example=
:=20
  \OLEDBSDK).=20
  <LI>When the file is unzipped, the following subfolders are created:<FON=
T=20
  color=3D#0000ff>Samples\Vbasic</FONT>=20
  <LI>In the file <FONT color=3D#0000ff>..\samples\Vbasic\PVideoVB.vbp</FO=
NT> is=20
  ADOcommon.bas under modules. Open the file.=20
  <LI>Edit the following line:<BR>Public Const ConnStr =3D=20
  "Provider=3DPervasiveOLEDB;Data Source=3DPVideo"<BR>to<BR>ConnStr =3D=20
  "Provider=3DPervasiveOLEDB;Data Source=3D<DATABASE name>;Location=3D&lt;=
server name=20
  where &gt;"=20
  <LI>Compile the code to build the executable. </LI></OL>
<H4>To create the PVideoDB database</H4>
<OL>
  <LI>Start Pervasive PSQL Control Center from the Pervasive group in the=
=20
  <B>Start</B> menu.=20
  <LI>In Pervasive PSQL Explorer, expand the <B>Engines</B> node.=20
  <LI>Right-click on the desired server where the database engine is runni=
ng.=20
  <LI>Click <B>New</B> --&gt; <B>Database</B>.=20
  <LI>Type "PVideoDB" for <B>Database Name</B>.=20
  <LI>Specify &lt;<I>directory</I>&gt;\samples\PVideoDB for <B>Location</B=
>.=20
  <LI>Click <B>Finish</B>.=20
  <LI>Exit Pervasive PSQL Control Center. </LI></OL>
<H2>Known Issues</H2>
<P>The following are known issues with this and previous releases: </P>
<TABLE border=3D1 cellPadding=3D5 width=3D434>
  <TBODY>
  <TR>
    <TH>Defect</TH>
    <TH>Description</TH></TR>
  <TR>
    <TD>31168</TD>
    <TD>The OLE DB driver cannot open files in exclusive mode Currently, w=
e=20
      have no support for exclusive access from OLEDB. It is not a support=
ed=20
      property. </TD></TR>
  <TR>
    <TD>53423 </TD>
    <TD>OLE DB does not support GUID/UNIQUEIDENTIFIER</TD></TR></TBODY></T=
ABLE>
<H2><A name=3Dlinks></A>Useful Links</H2>
<P>Discuss all your Pervasive development issues at DevTalk at <A=20
href=3D"http://www.pervasive.com/devtalk">http://www.pervasive.com/devtalk=
</A>.=20
</P>
<P>See some creative applications and code snippets and share your own at=
=20
Pervasive ComponentZone at <A=20
href=3D"http://www.pervasive.com/componentzone">http://www.pervasive.com/c=
omponentzone</A>.=20
</P>
<H2><A name=3Ddisclaim></A>Disclaimer</H2>
<P><FONT size=3D2>PERVASIVE SOFTWARE INC. LICENSES THE SOFTWARE AND DOCUME=
NTATION=20
PRODUCT TO YOU OR YOUR COMPANY SOLELY ON AN "AS IS" BASIS AND SOLELY IN=20
ACCORDANCE WITH THE TERMS AND CONDITIONS OF THE ACCOMPANYING LICENSE AGREE=
MENT.=20
PERVASIVE SOFTWARE INC. MAKES NO OTHER WARRANTIES WHATSOEVER, EITHER EXPRE=
SS OR=20
IMPLIED, REGARDING THE SOFTWARE OR THE CONTENT OF THE DOCUMENTATION; PERVA=
SIVE=20
SOFTWARE INC. HEREBY EXPRESSLY STATES AND YOU OR YOUR COMPANY ACKNOWLEDGES=
 THAT=20
PERVASIVE SOFTWARE INC. DOES NOT MAKE ANY WARRANTIES, INCLUDING, FOR EXAMP=
LE,=20
WITH RESPECT TO MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURP=
OSE OR=20
ARISING FROM COURSE OF DEALING OR USAGE OF TRADE, AMONG OTHERS. </FONT></P>
<P><FONT size=3D-1>Copyright (c) 1999-2006 Pervasive Software Inc. All Rig=
hts=20
Reserved. </FONT></P></BODY></HTML>

