Search Results ahl_util_uc_pkg




Overview

APPS.AHL_UTIL_UC_PKG is a utility package body in the Oracle E-Business Suite Advanced Service (AHL) application module. Its principal purpose is to support the Unit Configuration (UC) functionality within Oracle Enterprise Asset Management and Complex Maintenance, Repair, and Overhaul (cMRO). Unit configuration represents the hierarchical composition of a rotable or configurable asset, tracking parent-child relationships between components and their instance-level attributes. This package provides the shared PL/SQL routines that validate, interpret, and resolve configuration data across the AHL and CSI schemas.

The package is classified as OTHER under the ETRM API taxonomy and holds a VALID status in the APPS schema. It is a heavily depended-upon utility layer: it is referenced by 53 other database packages, while it references a broad set of AHL, CSI, HR, and FND objects. Because it is not referenced by any object as a parent dependency in the reverse direction, it functions as a low-level helper rather than a top-level API.

Key Procedures and Functions

The documented interface exposes 30 procedures and functions, organized around several functional themes:

Tables Accessed

The package reads and writes AHL tables including AHL_ITEM_ASSOCIATIONS_B, AHL_MC_HEADERS_B, AHL_MC_RELATIONSHIPS, AHL_UC_HEADERS_H, and AHL_UNIT_CONFIG_HEADERS, which store configuration headers, historical snapshots, maintenance relationships, and item associations. It also accesses CSI tables — CSI_ITEM_INSTANCES, CSI_II_RELATIONSHIPS, CSI_INSTANCE_STATUSES, CSI_IEA_VALUES, CSI_I_EXTENDED_ATTRIBS, and CSI_TXN_TYPES — to resolve instance hierarchies, statuses, and extended attributes. Reference and lookup data comes from FND_APPLICATION, FND_LOOKUP_VALUES, HR_ALL_ORGANIZATION_UNITS, and HR_LOCATIONS_ALL, supporting organizational and location resolution. It additionally invokes CSI_DATASTRUCTURES_PUB, CSI_II_RELATIONSHIPS_PUB, and AHL_MC_PATH_POSITION_PVT for business logic.

Usage Notes

This package is not intended for direct end-user invocation. It is called programmatically from Oracle Forms, concurrent programs, and other application packages that manage unit configuration and maintenance relationships. Customizations and extensions should call the public procedures rather than bypassing them, as they encapsulate validation and lookup logic. Because it is referenced by 53 packages, care should be taken when upgrading, since procedural signature changes can cascade through dependent AHL and CSI code. The dependency on FND_MSG_PUB and FND_API indicates the routines follow standard EBS error-handling conventions and should be invoked with the standard message stack initialized.