How to Enable Trace or Debug for APIs executed as SQL Script Outside of the Applications ?

In this Document

APPLIES TO:

Oracle Inventory Management - Version 11.5.10.CU2 to 12.1.3 [Release 11.5.10 to 12.1]

Oracle Bills of Material - Version 11.5.10.2 to 12.1.3 [Release 11.5 to 12.1]

Oracle Engineering - Version 11.5.10.2 to 12.1.3 [Release 11.5 to 12.1]

Oracle Product Hub - Version 11.5.10.2 to 12.1.3 [Release 11.5 to 12.1]

Information in this document applies to any platform.

This document includes all versions of 11.5.10 and R12 and later

GOAL

This document addresses the below questions:

1. How do you enable trace for an API when executed from a SQL script outside of Oracle Applications ?

2. How to get the debug log for APIs when executed from a SQL script outside of Oracle Applications ?

a) Inventory APIs

b) Bills of Material and Engineering APIs

c) Advanced Product Catalog (APC / EGO/ PIM) APIs

Note: Debug profiles are specific to modules, but, trace can be enabled for any API by following the steps provided here.

SOLUTION

1: How do you enable trace for an API when executed from a SQL script outside of Oracle Applications ?

-- enable trace

ALTER SESSION SET EVENTS '10046 trace name context forever, level 12';

-- Set the trace file identifier, to locate the file on the server

ALTER SESSION SET TRACEFILE_IDENTIFIER = 'API_TRACE';

-- Execute the API from the SQL script, in the same session.

EXEC <procedure name> ;

-- Once the API completes execution, disable trace

ALTER SESSION SET EVENTS '10046 trace name context off';

-- Locate the trace file based on the tracefile identifier

SELECT VALUE FROM V$PARAMETER WHERE NAME = 'user_dump_dest';

-- Generate the tkprof of the trace file

tkprof <trace_File>.trc <tkprof>.out sys=no explain=apps/<apps pwd>

2: How do you get debug log for an API when executed from a SQL script outside of Oracle Applications ?

a) For Inventory APIs

i. Enable INV Debug profiles at User level for the user who would be running the API.

For example:

INV:Debug Trace = YES

INV:Debug level = 15

INV: Debug File = /tmp/invdbg_TAR.dbg

For more information, on INV Debug profiles, Please refer to Note 148651.1

ii. Add the below declarations to the sql script calling the API outside of Oracle Applications.

-- Declarations

l_user_id NUMBER := -1;

l_resp_id NUMBER := -1;

l_application_id NUMBER := -1;

l_user_name VARCHAR2(30) := 'MFG'; -- user name

l_resp_name VARCHAR2(30) := 'Inventory'; -- responsibility name

iii. Add the below code before the API is called in the SQL script. This will initialize applications context, and will use the values of the debug profiles set for this user.

-- Get the user_id

SELECT user_id

INTO l_user_id

FROM fnd_user

WHERE user_name = l_user_name;

-- Get the application_id and responsibility_id

SELECT application_id, responsibility_id

INTO l_application_id, l_resp_id

FROM fnd_responsibility_vl

WHERE responsibility_name = l_resp_name;

FND_GLOBAL.APPS_INITIALIZE(l_user_id, l_resp_id, l_application_id); -- Mfg / Mfg & Dist Mgr / INV

dbms_output.put_line('Initialized applications context: '|| l_user_id || ' '|| l_resp_id ||' '|| l_application_id );

iv. Now, go ahead and execute the API from the SQL script, this willl create the debug log file with the file name as provided in the profile "INV: Debug File".

You can review step-by-step video here - Video - Trace
and Debug INV API (2:00)

b) For Bills of Material & Engineering APIs

i. Initialize the below parameters to the API:

(...

p_debug => 'Y',

p_output_dir => '/usr/tmp', -- Directory from utl_file_dir

p_debug_filename => 'bom_api_debug.log' -- Debug log filename

);

ii. Now run the API script or procedure created, This will create the debug log in the directory as mentioned in the parameters.

For example:

Bom_Bo_Pub.process_bom (p_bo_identifier => 'BOM',

p_api_version_number => 1.0,

p_init_msg_list => TRUE,

p_bom_header_rec => l_bom_header_rec,

p_bom_revision_tbl => l_bom_revision_tbl,

p_bom_component_tbl => l_bom_component_tbl,

p_bom_ref_designator_tbl => l_bom_ref_designator_tbl,

p_bom_sub_component_tbl => l_bom_sub_component_tbl,

x_bom_header_rec => x_bom_header_rec,

x_bom_revision_tbl => x_bom_revision_tbl,

x_bom_component_tbl => x_bom_component_tbl,

x_bom_ref_designator_tbl => x_bom_ref_designator_tbl,

x_bom_sub_component_tbl => x_bom_sub_component_tbl,

x_return_status => l_return_status,

x_msg_count => l_msg_count ,

p_debug => 'Y',

p_output_dir => '/usr/tmp',

p_debug_filename => 'bom_api_debug.log'

);

You can review step-by-step video here - Video
- Trace and Debug ECO API (2:00)

c) For Advanced Product Catalog (APC / PIM / EGO) APIs

i. Initialize the below parameters to the API:

(...

p_debug_level => 3 -- 0 - No debug, 3 - finest debug information

);

ii. Now run the API script or procedure created, This will create the debug log in the directory (as in 'utl_file_dir' DB parameter, for ex: /usr/tmp)

For example:

EGO_USER_ATTRS_DATA_PUB.PROCESS_USER_ATTRS_DATA(

              l_api_version

              , l_object_name

              , l_attributes_row_table

              , l_attributes_data_table

              , l_pk_column_name_value_pairs

              , l_class_code_name_value_pairs

              , l_user_privileges_on_object

              , l_entity_id

              , l_entity_index

              , l_entity_code

              , l_debug_level

              , l_init_error_handler

              , l_write_to_concurrent_log

              , l_init_fnd_msg_list

              , l_log_errors

              , l_add_errors_to_fnd_stack

              , l_commit

              , x_failed_row_id_list

              , x_return_status

              , x_errorcode

              , x_msg_count

              , x_msg_data

          );