Search Results ben_cwb_cd_summary_pkg




Overview

The APPS.BEN_CWB_CD_SUMMARY_PKG package is a component of the Oracle E-Business Suite Compensation Workbench (CWB) module. Compensation Workbench enables organizations to distribute compensation planning responsibilities to managers, allowing them to allocate merit increases, bonuses, and other awards within defined budgets and eligibility rules. This package supports the "Communication and Distribution" (CD) portion of the CWB process, specifically the summarization and refresh of compensation data that managers and administrators view during the planning cycle.

The package is classified under the ETRM as an OTHER API type, indicating that it is an internal engine package rather than a published public API intended for customer extension. It resides in the APPS schema and holds a VALID status on both Oracle EBS 12.1.1 and 12.2.2. Its primary role is to generate and maintain the summary data used by the Compensation Workbench, ensuring that plan design, person rates, exchange rates, and organizational hierarchy information are consolidated into a form suitable for display and downstream processing.

Key Procedures and Functions

The package exposes five documented procedures and functions:

  • BEN_CWB_CD_SUMMARY_PROC — The principal driver procedure. It performs the core summarization logic, consolidating compensation detail, person, and rate information into the summary structures that support the Compensation Workbench display and reporting layer.
  • MESSAGE_LOG_PROC — A utility procedure responsible for writing diagnostic and status messages to the application log. It is used throughout the summarization run to record progress, exceptions, and informational events for troubleshooting.
  • CHECK_REFRESH_JOBS — A control procedure that inspects the current state of refresh jobs associated with the summarization process, determining whether a refresh is already running or whether a new one may be initiated.
  • INSERT_REFRESH_JOBS — Registers a new refresh job record, enabling the package to track and schedule the background work required to regenerate Compensation Workbench summary data.
  • DELETE_REFRESH_JOBS — Removes completed or obsolete refresh job records, keeping the job-tracking tables clean and preventing stale entries from blocking future refreshes.

No parameter lists are documented in the ETRM metadata; the descriptions above reflect the functional intent of each routine only.

Tables Accessed

The package reads and writes a range of CWB, benefits, and HR tables accessed through APPS synonyms. The principal tables include:

Usage Notes

This package is invoked indirectly rather than through a user-facing form. Its documented reverse dependency is the concurrent program BEN_CWB_BACK_OUT_CONC, which calls into the summarization logic during the back-out process that reverses or refreshes Compensation Workbench planning data. The package also references itself, consistent with internal recursive or helper invocations.

In practice, the package executes as part of the Compensation Workbench concurrent processing cycle, typically scheduled or triggered by an administrator before managers begin or resume planning. Because it is an internal engine package and is not documented as a public API, custom code should not call its procedures directly; instead, the supported concurrent programs should be used to trigger summarization and refresh activity. Any direct invocation risks conflicting with the refresh job tracking maintained by CHECK_REFRESH_JOBS, INSERT_REFRESH_JOBS, and DELETE_REFRESH_JOBS.