Search Results start_ont_debugger




Overview

OE_DEBUG_PUB is a public PL/SQL package body owned by the APPS schema in Oracle E-Business Suite. It is the central debugging and diagnostic utility for the Oracle Order Management (OE) application family and related supply chain modules. The package provides a controlled instrumentation layer that allows developers, support analysts, and implementers to trace runtime behavior of Order Management APIs, concurrent programs, and forms without modifying or recompiling the underlying business logic. Within the ETRM metadata it is classified as an API of type PUB, confirming that it is intended for external invocation rather than internal-only use.

The package is heavily embedded across the application: it is referenced by 524 other packages, and it does not itself reference any database object that calls back into it, indicating a terminal utility that many modules depend upon but which remains independent. Its primary role is to manage debug mode flags, accumulate debug messages during a session, buffer and retrieve those messages for display or logging, and integrate with Oracle Workflow (WSH_DEBUG_INTERFACE) and Inventory (INV_DEBUG_INTERFACE) debug frameworks.

Key Procedures and Functions

The package exposes fifteen documented procedures and functions that manage the lifecycle of a debug session:

  • SET_DEBUG_MODE — enables or disables debugging for the current session or context.
  • INITIALIZE — prepares internal debug storage and the message index.
  • DEBUG_ON — activates the debugger and begins collecting messages.
  • DEBUG_OFF — deactivates the debugger and stops collection.
  • ISDEBUGON — boolean function returning whether debug mode is currently active.
  • COUNTDEBUG — returns the number of debug messages recorded in the buffer.
  • ADD — writes a message into the debug buffer.
  • GETFIRST — positions the internal index at the first buffered message.
  • GETNEXT — retrieves the next message sequentially from the buffer.
  • GETNEXTBUFFER — retrieves the next buffer block, supporting large message volumes.
  • DUMPDEBUG — outputs the accumulated buffer, typically to a file or output device.
  • RESETINDEX — resets the read index back to the start of the buffer.
  • SETDEBUGLEVEL — sets the verbosity threshold used to filter messages.
  • START_ONT_DEBUGGER — starts the Order Management debugger interface.
  • STOP_ONT_DEBUGGER — stops the Order Management debugger interface.

Tables Accessed

Documented dependencies include OE_DEBUG_S, a sequence used to generate identifiers for buffered debug messages, and DUAL, used for scalar evaluations and sequencing logic. UTL_FILE and PLITBLM are referenced to support file output and PL/SQL table/index-by-table operations behind GETNEXT and DUMPDEBUG. DBMS_UTILITY and FND_FILE are leveraged for formatted output and error/utility routines. The package also interacts with FND_PROFILE, FND_GLOBAL, and FND_API, allowing debug settings to be governed by profile options and the runtime application context. Integration hooks with INV_DEBUG_INTERFACE and WSH_DEBUG_INTERFACE allow the Order Management debugger to coordinate with the Inventory and Workflow debuggers.

Usage Notes

OE_DEBUG_PUB is normally invoked from Order Management forms, concurrent programs, and custom PL/SQL that needs to capture diagnostic traces of order processing. It is not intended for direct end-user execution. Because it is referenced by over five hundred packages, enabling debug mode can produce substantial output; the SETDEBUGLEVEL and SET_DEBUG_MODE routines should be used to bound verbosity before activating the debugger. The START_ONT_DEBUGGER and STOP_ONT_DEBUGGER procedures wrap the Order Management debugger around a transaction so the buffer can be dumped cleanly. The package is valid in both EBS 12.1.1 and 12.2.2 and remains schema-owned by APPS.