Table of Contents

Search

  1. Preface
  2. The Transformation Language
  3. Constants
  4. Operators
  5. Variables
  6. Dates
  7. Functions
  8. Creating Custom Functions
  9. Custom Function API Reference

Transformation Language Reference

Transformation Language Reference

Run-time APIs

Run-time APIs

The PowerCenter Integration Service calls the run-time APIs during a session to evaluate the expression that contains the custom function. It initializes the plug-in at the module, function, and function instance levels.
Each level contains a set of functions. These functions are associated with a handle, such as INFA_EXPR_MODULE_HANDLE. The first parameter for these functions is the handle the function affects. Custom Function API handles have a hierarchical relationship to each other. A parent handle has a 1:
n
relationship to its child handle.
The following figure shows the Custom Function API handles:
The following table describes the run-time handles:
Handle Name
Description
INFA_EXPR_MODULE_HANDLE
Represents the shared library or DLL. The plug-in can only access the module handle in its own shared library or DLL. It cannot access the module handle in any other shared library or DLL.
INFA_EXPR_FUNCTION_HANDLE
Represents a custom function within the shared library or DLL.
INFA_EXPR_FUNCTION_INSTANCE_HANDLE
Represents a specific custom function instance.