Upgrading to the v4 API

Upgrade to the v4 API included with 16.0.

Prerequisites
Install SAP Sybase IQ server version 16.0.
Task

If you have existing scalar or aggregate UDFs developed for SAP Sybase IQ server versions 15.1, 15.2, or 15.3, those UDFs use the V3 API interface style and reference the extfnapiv3.h header file. Modify your legacy C or C++ external library files to reference the extfnapiv4.h header file.

Existing v3 scalar and aggregate functions continue to work as designed. However, to take advantage of scalar and aggregate distribution in PlexQ, you must upgrade the header file and library version to v4. You need not change the name of the typedefs for your scalar or aggregate function.

  1. Open the C or C++ external library file defining the scalar or aggregate user-defined function.
  2. Locate all instances of #include 'extfnapiv3.h' and change to #include 'extfnapiv4.h'.
  3. Set the dynamic library interface to EXTFN_V4_API.
  4. Rebuild.
Next
Sybase partners must ensure the library exports extfn_get_license_info as an entry point.
Related concepts
External Function Prototypes
Related tasks
Defining an Aggregate UDF
Defining a Scalar UDF
Developing a Table UDF
Developing a TPF
Related reference
License Information (a_v4_extfn_license_info)