oracle advanced supply chain planning r11i

Oracle Advanced Supply Chain Planning R11i

HOW TO GENERATE/RETRIEVE ATP SESSION AND TRACE FILE

Prepared by Oracle Applications Manufacturing BDE

Author: Sanjeev Kale

Creation Date: May 17, 2005

Last Updated: July 18, 2005

Copyright © 2002 Oracle Corporation All Rights Reserved


INTRODUCTION .................................................................................................................................................................................. 3 SETUP .................................................................................................................................................................................................... 4 DEMONSTRATION .............................................................................................................................................................................. 6

Create Sales Order and Book the Order.............................................................................................................................................. 8 Unschedule the Sales Order .............................................................................................................................................................. 12 ATP Inquiry ...................................................................................................................................................................................... 15 Order backlog Workbench................................................................................................................................................................ 21


INTRODUCTION The purpose of the document is to walk you through the steps to generate the ATP session and trace file and how to get them from the database tier. I have made certain assumptions while writing this. They are as follows

• You are using 11.5.10 version of Oracle Application. • Wherever possible I have mentioned version specific actions.


SETUP We are going to see how to generate/retrieve ATP session debug files and trace file from two machine implementation. My ERP source instance is called ‘VIS’ and is on the host appsbde6. The Planning server instance is called ‘bdemfg’ and is on the host seth. When I refer to seth we are refering to the planning server, the ERP source will be refered to as appsbde6. In the appsbde6 instance I have set the values of the following profile options as

MSC: ATP Debug Mode = Debug and Database Trace MRP: Calculate Supply Demand = Yes OM: Debug Level = 5 OM: Debug Log Directory = /usr/tmp

The profile optins on the Planning server (seth) can be anything. If you are doing ATP Inquiry from the Destination itself then and only then you will need to set the MSC:ATP Debug Mode and MRP: Calculate Supply Demand profile options to get the ATP session file.

Note: when the profile MRP: Calculate Supply Demand is set to Yes, Oracle Global Order Promising performs extra work to retrieve and retain the detail. This makes ATP performance slower. You should only set this profile to Yes for analysis purpose.

Please review the following notes for understanding the location for the ATP session file and OM debug file.

Note 122372.1 - Generating ATP Debug Session and Trace Files Note 121054.1 - How to generate a debug file in OM

Using the SQL script from the Note 122372.1 we identify the location where the ATP session files will be written to in both the instances.

http://metalink.oracle.com/metalink/plsql/showdoc?db=NOT&id=122372.1



Oracle Advanced Supply Chain Planning R11i On appsbde6 the session files will be written to the following directory

SELECT ltrim(rtrim(value)) Value FROM (select value from v$parameter2 where name='utl_file_dir' order by rownum desc) WHERE rownum <2; VALUE -------------------------------------------------------------------------------- /apps/oracle/visdb/9.2.0/appsutil/outbound/VIS_appsbde6

the trace files will be written to the following directory

select value from v$parameter where name ='user_dump_dest'; VALUE -------------------------------------------------------------------------------- /apps/oracle/visdb/9.2.0/admin/VIS_appsbde6/udump

On seth the session files will be written to the following directory

SELECT ltrim(rtrim(value)) Value FROM (select value from v$parameter2 where name='utl_file_dir' order by rownum desc) WHERE rownum <2; VALUE -------------------------------------------------------------------------------- /seth/oracle/bdemfgdb/9.2.0/appsutil/outbound/bdemfg_seth

the trace files will be written to the following directory

select value from v$parameter where name ='user_dump_dest'; VALUE -------------------------------------------------------------------------------- /seth/oracle/bdemfgdb/9.2.0/admin/bdemfg_seth/udump


DEMONSTRATION The demonstration will show the following.

• Create a Sales Order and book the order. (This will show how the Scheduling works) • Then we will unschedule the Sales Order and finally • We will perform and ATP Inquiry.

We will see in all these scenarios how to retrieve the correct ATP session and trace file.

Oracle Advanced Supply Chain Planning R11i First of all let us begin by seeing the Supply/Demand for the Item SK-ATPFG.


Create Sales Order and Book the Order Logged in the application as ‘Order management Super User, Vision Operations (USA)’ responsibility. Navigation Path Orders, Returns Order organizer Enter the Customer Name and complete the Header information and then Click on Line items. Note the Sales order number (in this case it is 56704) Enter the Line order details in this case

Ordered Item = SK-ATPFG Qty = 35 Request Date = Enter todays date.


Click on the menu Tools Debug. Following screen will appear.

Click on the ‘OK’ button and then click on the ‘Book Order’ Button. It will come with the message saying the Order has been Booked. The OM debug message file will be created in /usr/tmp directory by the name l4007123.dbg.

Oracle Advanced Supply Chain Planning R11i Before closing the Sales Order form, navigate to Help About Oracle Applications… In the window look for VERSION_DATABASE_PROCESS, and a number associated with it. In this case it

VERSION_DATABASE_PROCESS : 5831 Navigate to View Requests and click on the ‘Submit a New Request’ button, select single request and in the Run the request form click on the LOV for the request name and select the request name as ‘Diagnostics: OM Debug File Retrieval’ and in the Debug File Name parameter enter the name of the OM Debug file that it showed when Debug was enabled in the Sales Order form. In this case it would be l4007123.dbg, and launch the request. Once the request completes successfully query the request and click on the ‘View Output’ It would show the output from the request which is the OM Debug file. In the OM Debug file do a search for a string ‘session’ and make sure you see the following in the OM Debug file

Parameter Value: 204

1. CALLING MRP API WITH SESSION ID 1698073. AFTER CALLING MRP_ATP_PUB.CALL_ATPS 2. ENTERING LOAD_RESULTS_FROM_REC -----------------Loading MRP Result--------------- MRP COUNT IS 1 SCHEDULE ACTION CODE SCHEDULE LOADING ATP RECORD 207 ERROR CODE : 0

This means that the ATP (schduling) code has been called and the session id is 169807. There would a file created by the name session-169807 in both the appsbde6 and seth instance in their appropriate directory as specified by the init.ora paramter called as ‘utl_file_dir’.

Oracle Advanced Supply Chain Planning R11i On appsbde6

$ cd /apps/oracle/visdb/9.2.0/appsutil/outbound/VIS_appsbde6 $ ls -ltr session-169807

-rw-r--r-- 1 oracle dba 4465 May 18 10:00 session-169807

$ cd /apps/oracle/visdb/9.2.0/admin/VIS_appsbde6/udump $ ls -la *5831*.trc

-rw-r--r-- 1 oracle dba 64445 May 18 10:00 vis_ora_5831.trc On seth

> cd /seth/oracle/bdemfgdb/9.2.0/appsutil/outbound/bdemfg_seth > ls -ltr session-169807


To find the trace on the planning server open the session-169807 and search for the string ‘spid’ or the first few lines would look as follows

Call_Schedule_Remote: G_SESSION_ID : 169807 Call_Schedule_Remote: Database Trace being enabled

Call_Schedule_Remote: spid: 15601 > cd /seth/oracle/bdemfgdb/9.2.0/admin/bdemfg_seth/udump > ls -la *15601*.trc

-rw-r--r-- 1 oracle dba 152442 May 17 13:07 bdemfg_ora_15601.trc

Note: This feature is available after SCP_PF.I or the version of MSCGATPB.pls greater or equal to 115.139.1159.4


Unschedule the Sales Order . Navigation Path Orders, Returns Order organizer and Enter the Order Number 56704 and query the order. Click on Tools Debug the following screen will appear.

Click on the ‘OK’ button. Click on Tools Scheduling and then select Unschedule from the window.

Oracle Advanced Supply Chain Planning R11i Navigate to View Requests and click on the ‘Submit a New Request’ button, select single request and in the Run the request form click on the LOV for the request name and select the request name as ‘Diagnostics: OM Debug File Retrieval’ and in the Debug File Name parameter enter the name of the OM Debug file that it showed when Debug was enabled in the Sales Order form. In this case it would be l4007125.dbg, and launch the request. Once the request completes successfully query the request and click on the ‘View Output’ It would show the output from the request which is the OM Debug file. In the OM Debug file do a search for a string ‘session’ and make sure you see the following in the OM Debug file

SESSION ID IN CALL_MRP 169808 calling mrps atp api: 18-MAY-05 15:52:58 After MRPs ATP API: S: 18-MAY-05 15:53:04 CALLING LOAD_RESULTS ENTERING LOAD_RESULTS_FROM_TBL -----------------Loading MRP Result From Tbl--------------- Loading mrp results Mrp count is 1 Line count is 1 Scheduling action UNSCHEDULE Load results line_id 195915 Index 1 2. ENTERING LOAD_RESULTS_FROM_REC -----------------Loading MRP Result--------------- MRP COUNT IS 1 SCHEDULE ACTION CODE UNSCHEDULE



ATP Inquiry Navigation Path Scheduling ATP Inquiry. Enter the Following Data in the ATP Inquiry screen.

Organization = M1 Item = SK-ATPFG Qty = 40 Request Date = Enter todays date.

Oracle Advanced Supply Chain Planning R11i Then Click on ‘ATP Details’ button The following screen appears.

Oracle Advanced Supply Chain Planning R11i Click on the ‘+’ sign on the Pegging window and then highlight the second line and then click the right mouse button the Following screen appears

Oracle Advanced Supply Chain Planning R11i Click on the Supply/Demand the following Screen comes up.

When customers have issues wherein they say they are not able to see certain Supply or Demand while doing scheduling or ATP inquiry this is the best way to diagnose the issue. This screen will be shown if the MRP:Calculate Supply Demand profile option is set to Yes.

Oracle Advanced Supply Chain Planning R11i Close this Supply/Demand screen and go the ATP Details Screen and then Navigate to Help Diagnostics Examine. In the Field select the SESSION_ID and value field will return the session id. The



Order backlog Workbench Navigation Path Scheduling Order Backlog Workbench. Enter the Following Data in the Order Backlog Workbench.

Organization = M1 Enter the Criteria Criteris = Item Name Condition = Equals From = SK-ATPFG

Click on ‘Find’ button, It would come up with the following Screen


Click on ‘Schedule’ button. Following screen will appear. Click on OK..


Following screen appears.



-rw-r--r-- 1 oracle dba 46965 Jul 19 10:47 session-169825 On seth


-rw-r--r-- 1 oracle dba 280039 Jul 18 13:52 session-169825




-rw-r--r-- 1 oracle dba 907141 Jul 18 13:52 bdemfg_ora_5923.trc


oracle advanced supply chain planning r11i

Documents