NOTE: This document describes how to extend perl to include the ACEDB Aceclient functionality. Only the production of a dynamically loaded Aceclient module is described. These instructions should work with perl 5.x and ACEDB 4.5 and above.

Assumptions:

You have made and installed perl 5.x (most recently tested with 5.004_01). Perl must be compiled with dynamic loading (the default).

You have done a 'make all' on the ACEDB distribution.

[Note: In the ace4_5e distribution, you must also 'make libfree.a libacecl.a'. The makefile for this version doesn't include these two products under 'all'.]

You have an aceserver running somewhere which will allow you to test this extension.

Steps:

Set the environmental variables ACEDB_SRC and ACEDB_MACHINE to the same values that you did when you compiled ACEDB.

Set the environmental variable PERL_SRC to point to the directory where you compiled perl - NOT where you installed perl (which is probably something like /usr/local/bin).

Run the instpace.pl script - this can be found in $ACEDB_SRC/wrpc. This script will check to make sure that everything is set properly, that all the files are in their proper places, and then unpack the Aceclient extension into $PERL_SRC.

Read the output from instpace.pl. If something is amiss then it will tell you. If everything is OK it will provide you with instructions for making and installing the extensions. Note: If you get an error indicating that either libfree.a or libacecl.a were not found, re-make the ACEDB distribution with 'make libfree.a libacecl.a', as mentioned above.

A simple perl-based aceclient called pacecl.pl was unpacked along with the Aceclient extension when you ran instpace.pl. This can be used to test the Aceclient extension. It is best if you test that your aceserver is functioning properly before you test the perl extension. You can do this by running the C version of aceclient which was produced when you made ACEDB.