oracle advanced supply chain planning r11i
TRANSCRIPT
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
Page 1
Oracle Advanced Supply Chain Planning R11i
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
Page 2
Oracle Advanced Supply Chain Planning R11i
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.
Page 3
Oracle Advanced Supply Chain Planning R11i
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.
Page 4
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
Page 5
Oracle Advanced Supply Chain Planning R11i
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.
Page 6
Oracle Advanced Supply Chain Planning R11i First of all let us begin by seeing the Supply/Demand for the Item SK-ATPFG.
Page 7
Oracle Advanced Supply Chain Planning R11i
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.
Page 8
Oracle Advanced Supply Chain Planning R11i
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.
Page 9
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’.
Page 10
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
-rw-r--r-- 1 oracle dba 39525 May 17 13:07 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
Page 11
Oracle Advanced Supply Chain Planning R11i
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.
Page 12
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
This means that the ATP (schduling) code has been called and the session id is 169808. There would a file created by the name session-169808 in both the appsbde6 and seth instance in their appropriate directory as specified by the init.ora paramter called as ‘utl_file_dir’.
Page 13
Oracle Advanced Supply Chain Planning R11i On appsbde6
$ cd /apps/oracle/visdb/9.2.0/appsutil/outbound/VIS_appsbde6 $ ls -ltr session-169808
-rw-r--r-- 1 oracle dba 3738 May 18 12:53 session-169808
$ cd /apps/oracle/visdb/9.2.0/admin/VIS_appsbde6/udump $ ls -la *5831*.trc
-rw-r--r-- 1 oracle dba 124345 May 18 12:53 vis_ora_5831.trc On seth
> cd /seth/oracle/bdemfgdb/9.2.0/appsutil/outbound/bdemfg_seth > ls -ltr session-169808
-rw-r--r-- 1 oracle dba 19526 May 17 16:00 session-169808
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 : 169808 Call_Schedule_Remote: Database Trace being enabled
Call_Schedule_Remote: spid: 3108 > cd /seth/oracle/bdemfgdb/9.2.0/admin/bdemfg_seth/udump > ls -la *3108*.trc
-rw-r--r-- 1 oracle dba 54356 May 17 16:00 bdemfg_ora_3108.trc
Note: This feature is available after SCP_PF.I or the version of MSCGATPB.pls greater or equal to 115.139.1159.4
Page 14
Oracle Advanced Supply Chain Planning R11i
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.
Page 15
Oracle Advanced Supply Chain Planning R11i Then Click on ‘ATP Details’ button The following screen appears.
Page 16
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
Page 17
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.
Page 18
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
This means that the ATP (schduling) code has been called and the session id is 169809. There would a file created by the name session-169809 in both the appsbde6 and seth instance in their appropriate directory as specified by the init.ora paramter called as ‘utl_file_dir’.
Page 19
Oracle Advanced Supply Chain Planning R11i On appsbde6
$ cd /apps/oracle/visdb/9.2.0/appsutil/outbound/VIS_appsbde6 $ ls -ltr session-169809
-rw-r--r-- 1 oracle dba 7704 May 18 13:17 session-169809
$ cd /apps/oracle/visdb/9.2.0/admin/VIS_appsbde6/udump $ ls -la *5831*.trc
-rw-r--r-- 1 oracle dba 192932 May 18 13:16 vis_ora_5831.trc On seth
> cd /seth/oracle/bdemfgdb/9.2.0/appsutil/outbound/bdemfg_seth > ls -ltr session-169809
-rw-r--r-- 1 oracle dba 42585 May 17 16:23 session-169809
To find the trace on the planning server open the session-169809 and search for the string ‘spid’ or the first few lines would look as follows
Call_Schedule_Remote: G_SESSION_ID : 169809 Call_Schedule_Remote: Database Trace being enabled
Call_Schedule_Remote: spid: 5923 > cd /seth/oracle/bdemfgdb/9.2.0/admin/bdemfg_seth/udump > ls -la *5923*.trc
-rw-r--r-- 1 oracle dba 161808 May 17 16:23 bdemfg_ora_5923.trc
Note: This feature is available after SCP_PF.I or the version of MSCGATPB.pls greater or equal to 115.139.1159.4
Page 20
Oracle Advanced Supply Chain Planning R11i
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
Page 21
Oracle Advanced Supply Chain Planning R11i
Click on ‘Schedule’ button. Following screen will appear. Click on OK..
Page 22
Oracle Advanced Supply Chain Planning R11i
Following screen appears.
Page 23
Oracle Advanced Supply Chain Planning R11i
Page 24
Oracle Advanced Supply Chain Planning R11i
This means that the ATP (schduling) code has been called and the session id is 169809. There would a file created by the name session-169825 in both the appsbde6 and seth instance in their appropriate directory as specified by the init.ora paramter called as ‘utl_file_dir’.
Page 25
Oracle Advanced Supply Chain Planning R11i On appsbde6
$ cd /apps/oracle/visdb/9.2.0/appsutil/outbound/VIS_appsbde6 $ ls -ltr session-169825
-rw-r--r-- 1 oracle dba 46965 Jul 19 10:47 session-169825 On seth
> cd /seth/oracle/bdemfgdb/9.2.0/appsutil/outbound/bdemfg_seth > ls -ltr session-169825
-rw-r--r-- 1 oracle dba 280039 Jul 18 13:52 session-169825
To find the trace on the planning server open the session-169825 and search for the string ‘spid’ or the first few lines would look as follows
Call_Schedule_Remote: G_SESSION_ID : 169825 Call_Schedule_Remote: Database Trace being enabled
Call_Schedule_Remote: spid: 29363 > cd /seth/oracle/bdemfgdb/9.2.0/admin/bdemfg_seth/udump > ls -la *29363*.trc
-rw-r--r-- 1 oracle dba 907141 Jul 18 13:52 bdemfg_ora_5923.trc
Note: This feature is available after SCP_PF.I or the version of MSCGATPB.pls greater or equal to 115.139.1159.4
Page 26