Professional Documents
Culture Documents
OPM Financials (GMF) Process Manufacturing Financials Troubleshooting Guide (Doc ID 1213193.1)
OPM Financials (GMF) Process Manufacturing Financials Troubleshooting Guide (Doc ID 1213193.1)
OPM Financials (GMF) Process Manufacturing Financials Troubleshooting Guide (Doc ID 1213193.1)
OPM Financials (GMF) Process Manufacturing Financials Troubleshooting Guide (Doc ID 1213193.1)
In this Document
Purpose
Questions and Answers
References
APPLIES TO:
PURPOSE
This document provides basic to advanced trouble shooting information which can be used by Customers, Support and Development.
This note provides troubleshooting information for OPM Financials Module (GMF). It covers the following topics.
Cost Rollup
Actual Cost
Lot Cost
Cost Update
Test Subledger Update
Final Subledger Update
Detailed Subledger Report
OPM Accounting Pre- Preprocessor
Create Accounting
For any OPM Financials issue Oracle Support request that you provide the file versions, log file with debug mode, error
messages, screen shots and steps followed.
Set this profile value to 3 to enable the Debug mode and set it to Null in order to disable debug mode. This profile can be set
from Menu -> Edit->Preferences ->Profiles->Personal Profile Values (Screen) . Query for profile name %GMFÞbug%.
(The long name of the Profile may vary - it is frequently set up as "GMF: Concurrent Debug Flag").
1 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
If profile value can not be seen from menu check by logging with the responsibility of system administrator. Otherwise contact
your system administrator.
If this profile does not exist or if this is a new instance then this profile has to be created.
There is a concurrent request named Diagnostics: Apps Check which can be submitted in order to get the file version and
profile values.
Responsibility : PURCHASING
Menu -> View Requests -> Submit a new concurrent request ->
Diagnostics: Apps Check
Parameter : Process Manufacturing Financials
(In order to get multiple product versions, submit different products needed in the parameter.)
If your requirement is to find only one form version , it is easier to get that from the Application .
These steps are same in 11i and R12.
Inside the application select the Menu: Use Help->About Oracle Applications Scroll down to find the form name Character: Use
Help->Version
If you have the access to the server where the Application is installed use below commands to get the executable file versions
2 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
Note that in SQL*Plus the output from the above statement will normally be limited to 80 characters.
You now need to use the SQL*Plus 'SET LONG <xxx>' command, using a number greater than the View Length returned
above. So if the query returned a length of '9800':
Note that the above query tells you which patches have specifically been applied on your environment, but it does not list those
fixes which came onto your system implicitly when (for example) a consolidated patch or a Patch Set was applied.
When given a list of patches, you can find out which ones are already applied on your system (either explicitly or implicitly) with
the following script:
When a value of Bug_Number is returned by this script, that patch is already applied and does not need to be applied again.
a) Cost Rollup
If the issue is happening for a particular item, run the cost rollup only for that item/product so that we have less data.
When a new request is submitted (screen name Start Cost Rollup), note down the reference number. Once the request is
completed go to the same Cost Rollup screen and click on the Cancel button. It will show Cost Rollup screen. Query for the
reference number.
Process status can be found from the Menu ->Actions->Process Status in the same screen. Error messages can be found from
the Menu ->Actions->View Error messages. If the error messages are less use the Menu -> Export to get the error messages
to an excel file.
If there are more error messages please use the below query to get the error messages from the database using the reference
number.
3 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
If the log file is very large, note down the concurrent request id from the Concurrent Requests screen and use it in below query
to find the location.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log file and error messages for issues related to this.
When a new request is submitted (screen name Start Actual Cost Process), note down the reference number. Once the
request is completed go to the same Actual Cost Process screen and click on the Cancel button. It will show Actual Cost
Process screen. Query for the reference number.
If the error messages are less use the Menu -> Export to get the error messages.
If there are more error messages please use the below query to get the error messages from the database using the reference
number.
Log file for the Actual Cost Process can be seen from Actual Cost Process screen by clicking on View Log button. Same log file
can be seen from Concurrent request screen. Menu -> View Requests ->Find Requests -> Search for the Actual Cost Process
Concurrent request. Click on the button View Log to get the log file.
If the log file is very large, note down the request id from the Requests screen and use it in below query to find the location.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log file and error messages for issues related to this.
If the issue is happening for a particular lot or item run the Lot cost process only for that so that we have less data.
When a new request is submitted (screen Lot Cost Process), note down the reference number. Process status can not be
4 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
found from the same screen. It can be found only from the view requests screen. Also there is no view error messages for this
process.
Log file for the Lot Cost Process can be seen from Concurrent request screen. Menu -> View Requests ->Find Requests ->
Search for the Lot Cost Process Concurrent request. Click on the button View Log to get the log file.
If the log file is very large, note down the request id from the Requests screen and use it in below query to find the location.
Please note that in case of lot costing unlike other requests there is no error message which can be found from Menu
->Actions- >View Error messages.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check)
and log file for issues related to this.
d) Cost Update
When a new request is submitted (screen name Start Cost Update Process), note down the reference number. Once the
request is completed go to the same Cost Update screen and click on the Cancel button. It will show Cost Update Process
screen. Query for the reference number.
If the error messages are less use the Menu -> Export to get the error messages.
If there are more error messages please use the below query to get the error messages from the database using the reference
number.
If the log file is very large, note down the request id from the Requests screen and use it in below query to find the location.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log file and error messages for issues related to this.
If the issue is happening for a particular source, run this process only for that source. If this is happening for a particular date
restrict this using the Post Start Date and Post End Date. This helps to have the smallest data that replicates the issue.
When a new request is submitted (screen name Test Subsidiary Ledger Update ), note down the reference number. Once the
request is completed go to the same Subsidiary Ledger Update screen and click on the Cancel button. It will show Subsidiary
Ledger Update Process screen. Query for the reference number.
5 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
If the error messages are less use the Menu -> Export to get the error messages.
If there are more error messages please use the below query to get the error messages from the database using the reference
number.SELECT line_no, message_text
FROM gl_mesg_tbl
WHERE reference_no = &EnterRefNo
ORDER BY line_no;
Log file for the Test Subledger can be seen from Concurrent request screen. Menu -> View Requests ->Find Requests ->
Search for the Test Subledger Concurrent request. Click on the button View Log to get the log file.
If the log file is very large, note down the request id from the Requests screen and use it in below query to find the location.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log file, report output if any and error messages for issues related to this.
Please note that Final mode can be run only once. So please check if the same issue happens when the Test Subledger is run.
If the issue is happening for a particular source, run this process only for that source. If this is happening for a particular date
restrict this using the Post Start Date and Post End Date. This helps to have the smallest data that replicates the issue.
When a new request is submitted (screen name Subsidiary Ledger Update ), note down the reference number. Once the
request is completed go to the same Subsidiary Ledger Update screen and click on the Cancel button. It will show Subsidiary
Ledger Update Process screen. Query for the reference number.
If the error messages are less use the Menu -> Export to get the error messages.
If there are more error messages please use the below query to get the error messages from the database using the reference
number.
Log file for the Lot Cost Process can be seen from Concurrent request screen. Menu -> View Requests ->Find Requests ->
Search for Final Subledger request. Click on the button View Log to get the log file.
If the log file is very large, note down the request id from the Requests screen and use it in below query to find the location.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log file, report output if any and error messages for issues related to this.
6 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
Navigation : Menu-> View Requests ->Submit New Request -> Detailed Subledger Report
Please note that reference number is taken from the Subledger update (11i) or from
OPM Accounting preprocessor (R12).
If this is happening for a particular date restrict this using the Start Date and End Date. This helps to have the smallest data
that replicates the issue.
Log file for the Detailed Subledger Report can be seen from Concurrent request screen. Menu -> View Requests ->Find
Requests -> Search for Detailed Subledger Report . Click on the button View Log to get the log file.
If the log file is very large, note down the request id from the Requests screen and use it in below query to find the location.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log file and report output for issues related to this.
If the issue is happening for a particular source, run this process only for that source. If this is happening for a particular date
restrict this using the Post Start Date and Post End Date. This helps to have the smallest data that replicates the issue.
When a new request is submitted (screen name Start OPM Accounting Preprocessor), note down the reference number. Once
the request is completed go to the same OPM Accounting Preprocessor screen and click on the Cancel button. It will show
Subsidiary Ledger Update Process screen. Query for the reference number.
If the error messages are less use the Menu -> Export to get the error messages.
If there are more error messages please use the below query to get the error messages from the database using the reference
number.
Log file can be seen from OPM OPM Accounting Preprocessor screen or from the Concurrent request screen. Menu -> View
Requests ->Find Requests -> Search for the OPM Preprocessor in the Concurrent request. Click on the button View Log to get
the log file.
If the log file is very large, note down the request id from the Requests screen and use it in below query to find the location.
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log file and error messages for issues related to this.
i) Create Accounting
7 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
Navigation : Menu-> View Requests ->Submit New Request -> Create Accounting
Please note that Final mode can be run only once. Make sure to run this in Draft mode and when everything works fine or
when you are ready to run the Final run then only run the Create Accounting in Final Mode.
If the issue is happening for a particular process category(source), run this process only for that process category(source). If
this is happening for a particular date restrict this using End Date. This helps to have the smallest data that replicates the issue.
GMF Debug Log mode has no effect on Create Accounting since this is part of SLA which is common for most of the Financial
Modules. In order to enable the Debug we need to set FND profile values , run create accounting and run the sql query.
Profile values
SLA: Enable Diagnostics : Yes
FND: Debug Log Enabled : Yes
FND: Debug Log Filename: Blank
FND: Debug Log Level: Statement
FND: Debug Log Module: %
These profile values can be set from Menu -> Edit->Preferences ->Profiles->Personal Profile Values (Screen) . Query for
%FNDÞbug%.
If profile values can not be seen from menu check by logging with the responsibility of system administrator. Otherwise contact
your system administrator.
3 Submit Request for the smallest criteria that replicates the issue. Note down the request id of the create accounting and
accounting program. If the Create Accounting spawns multiple Accounting Program requests then include all the request ids.
Provide the create accounting, Accounting program log fies and below sql query output
If you do not have the access to this file , request your dba to provide the above log file. Provide the file version (Apps Check),
log files, report output and query output for issues related to this.
If the create accounting completes in errors or in warning please run the period close exception report and check the errors or
use below sql
(&accounting_program_request_id is the request id of Accounting Program which is child request of Create Accounting) . If
the issue is related with the SLA ADR rule please review the related SLA ADRs. It is recommended to modify the SLA ADR
with the conditions similar to the default/seeded and see if it works. If it works keep on adding condition to find out which one
is failing.
8 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
Also please make sure the accounting entries are correct before running in Final mode because Final mode can not be
reverted. For seeing the different period end processes/steps for GMF/OPM Financials please refer to below document
Release 12 Period-End Process Flow For Oracle Process Manufacturing (OPM) Financials (GMF)- e-Business Suite
(Doc ID 1237963.1)
When you enable the trace you can see a Note window which shows the location and file name. Note down this or take a
screen shot.
This is needed if there is any APP-FND error messages or issues related to List of values or items is reported. Enable the trace
just before the error message occurs and
Disable the trace once the error message is displayed. Trace can be disabled by
Menu-> Help ->Diagnostics -> Trace >No Trace
Location of trace files (always on the database server) can be found from below query:
SELECT *
FROM v$parameter
WHERE name = 'user_dump_dest';
The following alternative query shows the location and name of trace files relating to currently-running Applications sessions
and processes:
b) Tables Analyzed
Run the above every 5 minutes or certain intervals based on how much time the total request takes. This way it is easy to find
out which statement is taking time.
9 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
In some cases we may need to enable trace for the whole application session. Follow below note for the complete steps
Note 170223.1 Title: Trace 11i Bind Variables - Profile Option: Initialization SQL Statement - Custom
In some cases we may need to enable the trace for the user in order to capture all the SQL statements executed. Follow below
note for the complete steps
Note 309798.1 How to Trace Specific Database Users to Collect Full DML Statements Executed
If you do not have the access to these files , request your dba to provide the above files. Provide the file version (Apps Check),
trace file ,log file and screen shots for issues related to this. If this is related to performance issue provide the file version (Apps
Check), trace file , log file , tkprof ,table analyzed output and Sql executed output.
Responsibility -> System Administrator ->Program ->Define - >Query for the Program name. Enable the checkbox for trace in
the Request. And save the record.
And provide the values for the request parameters and submit the request
Once the report is submitted and completed use the same responsibility and navigation path as above to deselect the
checkbox. This will disable the trace.
For example if trace_id = 123567 is returned, then in the user_dump_dest use the following to find the trace file
If this trace is related to a performance issue please perform the same steps mentioned in the Performance Related issues
under Enable Forms Trace.
If you do not have the access to these files , request your dba to provide the above files. Provide the file version (Apps Check),
trace file and log file for issues related to this. If this is related to performance issue provide the file version (Apps Check), trace
file, tkprof,table analyzed and Sql executed.
10 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
IC_TRAN_PND: Inventory Transaction Table having pending and completed transactions. Transaction types( PORC, XFER,
OMSO, PROD )
IC_TRAN_CMP: Inventory Transaction Table having completed transactions.Transaction types( CREI, ADJI, CRER, ADJR,
TRNI, TRNR, PIPH )
IC_PERD_BAL: Inventory Table having ending balance, consumption, and yield for closed inventory periods.
IC_ITEM_MST_B : Item definition table having all information relating to an item, such as lot/sublot control, unit of measure
information, and all class and type designations.
MTL_MATERIAL_TRANSACTIONS : Inventory Transaction table which stores a record of every material transaction or cost
update performed in Inventory.
MTL_TRANSACTION_LOT_NUMBERS: Inventory table which stores lot number information for transactions in the
MTL_MATERIAL_TRANSACTIONS table.
MTL_SYSTEM_ITEMS: Item definition table having all information relating to an item, such as lot/sublot control, unit of
measure information, and all class and type designations.
GMF_PERIOD_BALANCES : OPM Financials table having ending balance, consumption, and yield for closed inventory
periods.
11 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
GMF_PERIOD_STATUSES :OPM Financails table which stores the OPM Financials period status.
GMF_XLA_EXTRACT_HEADERS: SLA Extract Headers table which stores transactions for process inventory organizations
are processed and all the necessary data for accounting are stored in this table. When the SLA accounting program is run data
from this table is extracted for creation of journal entries in SLA.
GMF_XLA_EXTRACT_LINES: SLA Extract Lines table which stores transactions for process inventory organizations are
processed and all the necessary data for accounting are stored in this table. When the SLA accounting program is run data
from this table is extracted for creation of journal entries in SLA.
XLA_AE_HEADERS: SLA table stores subledger journal entries. There is a one-to-many relationship between accounting
events and journal entry headers.
XLA_AE_LINES:SLA table stores the subledger journal entry lines. There is a one-to-many relationship between subledger
journal entry headers and subledger journal entry lines.
XLA_DISTRIBUTION_LINKS: SLA table stores the link between transactions and Subledger journal entry lines.
Please make sure to provide the output in excel format with column headers . For multiple query outputs make sure to take
each output in a separate worksheet.
Invalid objects
Application Instance name, Apps Level, Host Name, Version and database version
Trans_id can be found from Opm Inventory Responsibility under the transaction inquiry
Item_id can be found using below query
12 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
13 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
Identify the TRANSACTION_ID from material transactions Inquiry screen in Inventory or provide the INVENTORY_ITEM_ID or
BATCH_ID in order to narrow down the data
Transaction_id can be found from Opm Inventory Responsibility under the transaction inquiry.
Enter the transaction dates or the item number and find out the transaction_id
Run Accounting Preprocessor only for a particular source and small date range to include transaction. This way we have the
smallest data that replicates the issue. Reference number is the number obtained while running OPM preprocessor.
a)
b)
14 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
c)
Also provide the debug log output file from the OPM preprocessor.
SLA Events
SLA Headers
SLA Lines
SLA Distributions
15 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
-- For batch replace the last line above with below information
--If you know the transaction_id use replace the last line with below
Also provide the FND debug log for the create accounting.
Transaction type can be identified from the transaction id or item no or inventory item id or date range by using below query.
This concept was introduced from 11.5.10 in order to resolve inventory reconciliation issues with batches crossing the period.
Prior to this when a batch is completed in one costing period and closed in the next or subsequent period, quantities yielded in
prior periods were counted twice in the PMAC cost calculation. This change assumes that the users are creating batch
transactions in sequence (like, first consumptions followed by yields) and no back dated transactions.
16 of 17 10/07/2018 09:31
Document 1213193.1 https://support.oracle.com/epmos/faces/Docum...
In Release 11i manually-executed scripts were used to recreate the Layer data, but in Release 12 and later a Concurrent
Request is provided to make it easier to include the recreation of the Layer Cost data in your routine Period End tasks.
This concurrent request is available from patch 8523022 (R12)/ patch 9078278 (R12.1.1) onwards. This can be run for a
particular period, batch or organization.
Run this request when the batch cost is not correct or when there is transactions which are out of sequence. Actual cost
process has to be run after this concurrent request and costs can be verified from the item costs screen.
Running this 'Recreate' program can not do any harm, so it is recommended that it should be routinely run before Actual
Costing in order to remove potential data problems (for example where the details of a Batch have been updated but these
changes are not reflected in the Layer Cost tables.
For details of this program in 11i, please refer the following Note -
- New concurrent program GMF Recreate Batch / Period Layers to recreate layer date for production batches Document ID
1068301.1
REFERENCES
NOTE:309798.1 - How to Trace Specific Database Users to Collect Full DML Statements Executed
NOTE:1237963.1 - Release 12 Period Close Process Flow For Oracle Process Manufacturing (OPM) Financials (GMF)- e-Business Suite
NOTE:170223.1 - How To Create a User Event Trace by Using Profile Option: Initialization SQL Statement - Custom
Didn't find what you are looking for?
17 of 17 10/07/2018 09:31