Search Results igs_en_reinstate_pkg




Overview

IGS_EN_REINSTATE_PKG is a PL/SQL package in the APPS schema belonging to the Oracle E-Business Suite Student System (also known as Oracle Student System, or OSS), which is part of the Oracle Higher Education solution set. The package is classified under the ETRM as an "OTHER" API, indicating that it is an internal or utility package rather than a formally published public API. Its name and contents identify its purpose: to reinstate a student's unit attempt — that is, to restore a previously discontinued, withdrawn, or otherwise invalidated enrolment in a specific unit offering option (UOO) so that the student's academic record reflects the attempt as active again.

Reinstatement is a common administrative requirement in student records processing. A student may withdraw from a unit and later be permitted to resume it, or an institution may reverse a discontinuation following an appeal, a data correction, or a change in the student's circumstances. This package encapsulates the validation and update logic required to perform that reversal consistently, rather than leaving it to ad hoc updates against the underlying enrolment tables.

The package header carries a header comment dated 2005, consistent with the lineage of the Student System modules, which were progressively integrated into the EBS 12.1.1 and 12.2.2 releases. Its presence in APPS reflects the standard EBS deployment practice of compiling product PL/SQL into the shared APPS schema.

Key Procedures and Functions

The documented package specification exposes a single procedure:

  • REINSTATE_STDNT_UNIT_ATTEMPT — The sole entry point in the package spec. It accepts the identifying context of the student unit attempt to be reinstated (person, course, course version, load calendar type, load sequence number, and unit offering option identifier, plus the person type) and returns status information to the caller. Its output parameters follow standard EBS API conventions: a return status code, a message buffer for error or informational text, and a deny/warn indicator that signals whether the operation should be blocked or merely flagged. The procedure performs the reinstatement of the specified student unit attempt.

No other public procedures or functions are declared in the documented specification, and the ETRM lists only this one procedure against the package.

Tables Accessed

The documented metadata records references through APPS synonyms to IGS_EN_METHOD_TYPE. This table holds the method-of-attendance or method-of-study type definitions used within the Student System's enrolment (IGS_EN) schema. The package consults it as part of validating or reconstructing the enrolment context when a unit attempt is reinstated, for example to confirm the method type associated with the original or reinstated attempt remains valid.

Beyond this documented reference, reinstatement processing in the Student System inherently operates against the core student unit attempt and enrolment tables (such as the IGS_EN_STDNT_ATT_ALL and related offering tables) that store the attempt record itself; the ETRM excerpt records only IGS_EN_METHOD_TYPE as an explicitly documented dependency.

Usage Notes

Because IGS_EN_REINSTATE_PKG is classified as OTHER rather than a published public API, it is best regarded as an internal implementation package. It is typically invoked indirectly — for instance, from Student System forms or concurrent programs that present a reinstatement action to users, or from other Student System PL/SQL that orchestrates enrolment changes. Custom code may call REINSTATE_STDNT_UNIT_ATTEMPT directly, but callers must supply valid identifiers for the person, course, version, load calendar, sequence, and unit offering option, and must interpret the returned status, message, and deny/warn values rather than assuming success.

The ETRM records no packages that reference this package, so it sits at the edge of the dependency graph. As with all internal Student System packages, behaviour should be verified against the specific 12.1.1 or 12.2.2 instance before use, since the package specification is not part of Oracle's committed public interface and may change between releases or patches.