Search Results irc_variable_comp_element_bk1




Overview
Explore in AI Chat

Overview

IRC_VARIABLE_COMP_ELEMENT_BK1 is an Oracle Applications (APPS) PL/SQL package body that belongs to the Oracle iRecruitment module of Oracle E-Business Suite. In the EBS architecture, the "_BK1" suffix identifies this object as a backward-compatibility hook wrapper generated by the Oracle HRMS API Hook Pre-processor. Its role is to expose the variable compensation element business logic associated with a vacancy so that customer-defined application hooks can intercept that logic at a defined point in the processing cycle. The package is classified under the ETRM metadata as an "OTHER" API, indicating that it is not a primary public business API but rather a supporting wrapper used by the HRMS hook mechanism.

The header comment in the source, irvceapi.pkb 120.0, dates the generated code to 2005 and the wrapper creation to 2008, reflecting the standard EBS practice of auto-generating hook packages that delegate to the corresponding business event package. Here, the delegation target is IRC_VARIABLE_COMP_ELEMENT_BE1, which carries the actual implementation logic.

Key Procedures and Functions

  • CREATE_VARIABLE_COMPENSATION_A — The primary hook wrapper for creating a variable compensation entry tied to a vacancy. It accepts the vacancy identifier, the variable compensation lookup value, an effective date, and an object version number. Internally it records the commit unit, conditionally invokes the corresponding procedure in IRC_VARIABLE_COMP_ELEMENT_BE1 when application hooks are enabled (hr_api.call_app_hooks), closes the validation set via hr_multi_message.end_validation_set, and validates the commit unit for the CREATE_VARIABLE_COMPENSATION action. This is the pre-hook form of the operation.
  • CREATE_VARIABLE_COMPENSATION_B — The post-hook counterpart. Its body contains only entry and exit location markers and performs no substantive processing, consistent with the standard A/B pattern in which the "_A" procedure runs the hook-enabled logic and the "_B" procedure serves as the post-processing stub.

The absence of an "_A" naming exception and the presence of only two documented procedures confirm that this object conforms to the conventional HRMS API hook wrapper structure. No parameter lists are reproduced here beyond their documented purpose.

Tables Accessed

The documented metadata lists no tables accessed directly through APPS synonyms. All database activity is performed indirectly through the delegated call to IRC_VARIABLE_COMP_ELEMENT_BE1, which owns the DML against the iRecruitment vacancy and variable compensation tables. Because the wrapper does not issue SQL itself, it introduces no additional table dependencies beyond those of its delegate.

Usage Notes

This package is not intended for direct invocation by custom code. It is invoked internally by the HRMS API hook framework whenever the CREATE_VARIABLE_COMPENSATION business event fires — typically from the iRecruitment vacancy compensation functionality in the forms layer or from concurrent processes that assign variable compensation to vacancies. The ETRM metadata records that it is referenced by one other package, consistent with its role as a hook target rather than a standalone API.

Developers implementing custom hooks subscribe to this package by writing code in the corresponding user hook package, which the framework calls at the call_app_hooks point. Direct calls to IRC_VARIABLE_COMP_ELEMENT_BK1 bypass the commit-unit and validation-set bookkeeping managed by the BE1 layer and are therefore discouraged. Both Oracle EBS 12.1.1 and 12.2.2 retain this object for backward compatibility with pre-existing hook implementations.