Using Btrieve with Perl on Windows x64

Documented below is one approach to configuring the Btrieve 2 SDK for the Perl programming language. In this example, we will use Visual Studio 2015 to target a native Windows x64 environment. It is assumed that Zen is already installed and running.

• Install SWIG and Perl if not already installed.
  • http://www.swig.org/
  • http://www.strawberryperl.com/
• Install the Btrieve 2 Windows SDK for Zen.
  • https://esd.actian.com/product/Zen_PSQL/SDKs
• Generate, build, and install Btrieve Perl.
  • Open the Visual Studio x64 Native Tools Command Prompt.
  • Change directory into the Btrieve 2 SDK directory.
  • Generate Btrieve Perl.
    • c:\swigwin-3.0.12\swig.exe -cppext cpp -outcurrentdir -perl5 -c++ -Iinclude swig\btrievePerl.swig
      • Note that the path to SWIG used above may differ.
      • Note that Perl version 5 is specified.
  • Build Btrieve Perl.
    • cl -EHsc -c -Iinclude -DWIN32 -IC:\Strawberry\perl\lib\CORE btrievePerl_wrap.cpp
      • Note that the path to Perl used above may differ.
      • You may need to modify the Perl installation's configuration to get a clean compile. This is not a SWIG issue but a Perl issue.
    • link -dll win64\x86_64\btrieveCpp.lib -libpath:C:\Strawberry\perl\lib\CORE libperl528.a -out:btrievePerl.dll btrievePerl_wrap.obj
      • Note that the path to Perl used above may differ.
  • Install Btrieve Perl.
    • copy btrievePerl.pm "c:\Program Files\Actian\Zen\bin"
    • copy btrievePerl.dll "c:\Program Files\Actian\Zen\bin"
      • You may need elevated permissions to perform these copies.
  • Execute the Btrieve Perl sample program.
    • c:\Strawberry\perl\bin\perl.exe samples\btest.pl 9
      • You should see the output "record: (9, 81, 3)".
      • Note that the path to Perl used above may differ.
      • You may need to allow everyone to write to the current directory if you receive the error "Error: BtrieveClient->FileCreate:94:Permission error at samples\btest.pl line 50.".

Using Btrieve with Perl on Ubuntu Linux x64

Documented below is one approach to configuring the Btrieve 2 SDK for the Perl programming language. In this example, we will target an Ubuntu Linux x64 environment. It is assumed that Zen is already installed and running.

• Install SWIG and Perl if not already installed.
  • sudo apt install swig
  • sudo apt install perl
• Install the Btrieve 2 Linux SDK for Zen.
  • https://esd.actian.com/product/Zen_PSQL/SDKs
• Generate, build, and install Btrieve Perl.
  • Open a Terminal window.
  • Change directory into the Btrieve 2 SDK directory.
  • Generate Btrieve Perl.
    • swig -cppext cpp -outcurrentdir -perl5 -c++ -Iinclude swig/btrievePerl.swig
      • Note that Perl version 5 is specified.
  • Build Btrieve Perl.
    • g++ -c -fPIC -Iinclude -I/usr/lib/x86_64-linux-gnu/perl/5.30.0/CORE btrievePerl_wrap.cpp
      • Note that the path to Perl used above may differ.
    • g++ -shared btrievePerl_wrap.o -o btrievePerl.so -L/usr/local/actianzen/lib64 -lbtrieveCpp
  • Install Btrieve Perl.
    • sudo cp btrievePerl.pm /usr/local/actianzen/lib64
    • sudo cp btrievePerl.so /usr/local/actianzen/lib64
  • Execute the Btrieve Perl sample program.
    • export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/x86_64-linux-gnu:/usr/local/actianzen/lib64
    • perl samples/btest.pl 9
      • You should see the output "record: (9, 81, 3)".
      • You may need to allow everyone to write to the current directory if you receive the error "Error: BtrieveClient->FileCreate:94:Permission error at samples\btest.pl line 50.".