Table of Contents

Search

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

Transformation Language Reference

Transformation Language Reference

Function Instance-Level Initialization Function

Function Instance-Level Initialization Function

PowerCenter calls fnInstance_init once for each custom function instance to initialize any structure related to the custom function instance. If there are two instances of a custom function in a mapping or workflow, PowerCenter calls this function twice. PowerCenter calls the module-level initialization function before calling this function.
Use the following syntax:
INFA_EXPR_STATUS (*fnInstance_init)(INFA_EXPR_FUNCTION_INSTANCE_HANDLE fnInstance);
Argument
Datatype
Input/
Output
Description
fnInstance
INFA_EXPR_FUNCTION_HANDLE
Input
Performs the following tasks:
  • Stores user-defined pointers for the framework to retrieve during run time or deinitialization.
  • Initializes data structures for the function instance level.
  • If the input argument is a constant, the plug-in retrieves this constant value and for performs any necessary preprocessing.
The return datatype is INFA_EXPR_STATUS. Use ISUCCESS and IFAILURE as the return values. If the function returns IFAILURE, the session or workflow fails.