Search Results ahl_ump_processunit_extn_pvt




Overview
Explore in AI Chat

Overview

APPS.AHL_UMP_PROCESSUNIT_EXTN_PVT is a private PL/SQL package within the Oracle Enterprise Asset Management (eAM) / Asset Lifecycle Management (ALM) module, specifically belonging to the AHL (Asset Health and Maintenance) application family used by Oracle's Enterprise Asset Management product line. Its classification as a "PVT" (private) package indicates it is an internal implementation package, not a public API intended for direct customer invocation.

The package name suggests it handles "process unit extension" logic tied to the Unit Maintenance Plan (UMP) component of AHL. In Oracle eAM, unit effectivities, unit deferrals, and simulation plans are central to modeling how maintenance requirements apply over time or under varying operational conditions. This package acts as a bridge between temporary staging tables and the persistent simulation/unit effectivity tables, performing the "flush" operations that move data from temporary working structures into the actual transactional and simulation tables.

Key Procedures and Functions

The ETRM metadata documents two procedures or functions within this package:

  • FLUSH_FROM_TEMP_TABLE — Responsible for reading data staged in temporary tables and moving or flushing that data out to its appropriate destination. This is typically the extraction side of a staging operation, where temporary integration or simulation working sets are consumed and forwarded for further processing or persistence.
  • FLUSH_TO_SIM_UE_TABLE — Flushes data into the Simulation Unit Effectivity tables (AHL_UE_SIMULATIONS, AHL_UE_SIMULATIONS_S). This procedure supports simulation scenarios for unit effectivities, allowing maintenance planners to model "what-if" effectivity configurations without committing changes to live data until the simulation is validated.

Both procedures interface with APPS.AHL_UMP_PROCESSUNIT_PVT, which is the public-facing counterpart package invoked by the application layer. This private extension package supplements the core processing unit logic, handling the mechanics of staging and simulation persistence.

Tables Accessed

The package accesses a broad set of AHL tables via APPS synonyms. The simulation-related tables — AHL_UE_SIMULATIONS and AHL_UE_SIMULATIONS_S (the simulation header and its sequence) — are written to by FLUSH_TO_SIM_UE_TABLE. Effectivity and deferral structures such as AHL_UNIT_EFFECTIVITIES_B, AHL_UNIT_DEFERRALS_B, AHL_TEMP_UNIT_EFFECTIVITIES, and AHL_TEMP_UNIT_SR_DEFERRALS are touched during the flush cycle, consistent with the temporary-to-persistent movement pattern. AHL_UE_RELATIONSHIPS and AHL_SIMULATION_PLANS_B support the relationship modeling between simulation units. Reference data including AHL_APPLICABLE_MRS, AHL_MR_HEADERS_B, AHL_SCHEDULE_MATERIALS, AHL_VISITS_B, AHL_VISIT_TASKS_B, AHL_UNIT_THRESHOLDS, and OKC_K_LINES_B (the service contract line table from OKC) are read to resolve the maintenance requirements, visit tasks, and contract lines applicable to each processed unit. Collectively these tables align with the maintenance planning and simulation workflow of Oracle eAM.

Usage Notes

Because AHL_UMP_PROCESSUNIT_EXTN_PVT is a private package, it should not be called directly from custom code. It is referenced by AHL_UMP_PROCESSUNIT_PVT, which itself is referenced only by the extension package — indicating a tightly coupled internal dependency chain. In practice, this package is invoked indirectly when users run unit maintenance plan simulation or effectivity processing through the Oracle eAM forms or concurrent programs that drive the Unit Maintenance Plan functionality.

Typical invocation paths include the Unit Effectivity simulation screens in maintenance planning, where an administrator creates or modifies simulation scenarios and commits them. The flush procedures execute during that commit cycle. Customizations should target the public API (AHL_UMP_PROCESSUNIT_PVT) or use documented integration points rather than referencing this private package. Since it is marked VALID in the ETRM metadata, the package is present and compiled in the 12.1.1 and 12.2.2 environments, though Oracle retains the right to modify private package signatures across patches or upgrades without notice.