Troubleshooting Methods for Oracle Workflow

7/22/2019 Troubleshooting Methods for Oracle Workflow

1/25

Troubleshooting methods for Oracle WorkflowThis post describes various methods of debugging oracle workflow. Oracle workflow is generally used tointegrate the ERP business process into Oracle applications

Descriptions

Oracle workflow is a complete solution for integrating End to End business process within ERP. Oracle

workflow lets people receive emails about their activities and also sends remainder mails to thedocument approvers. Oracle workflow builder helps to define the workflow process and integrate all the

processes to define the business process.

Initial Level Checks:

1. Oracle workflow requires the Workflow Background process to be scheduled for every 10 minutes inthe system with the following parameters:

Y,N,N N,Y,N N,N,Y1. First get the concurrent program ID:SELECT concurrent_program_idFROM fnd_concurrent_programs_tlWHERE user_concurrent_program_name = 'Workflow Background Process';2. Check for the programs frequency of execution:SELECT request_date,actual_date,actual_completion_date,phase_code,status_codeFROM fnd_concurrent_requestsWhere concurrent_program_id = AND argument_text = ', , , N, Y, N'AND resubmit_interval = 10AND resubmit_interval_unit_code = MINUTESOrder By 1 Desc3. Check whether the program is scheduled and running for every 10 mins

4. Similarly repeat step 2 for other arguments.

Figure 1: Queries for checking the workflow Background Process

2. Check whether all the agent listeners are up and running as shown below:

Navigation Path:

a.Go to Workflow Administrator Web Applications responsibility and click on Workflow Manager as shownbelow.

Figure 1: Navigation to Oracle Workflow Manager

b.

You will be guided to the following page and here all of the highlighted must be up.

Figure 2: Workflow Components Dashboard

After undergoing the initial level checks we need to categorize the workflow issue to any one of thebelow category:

1. Workflow not running2. Notifications not being fired.

Workflow not running:We assume that the workflow has been initiated and its not running further. We need to get theworkflow name and itemkey for the workflow not running. Itemkey is a key to identify the workflow

instances below are some of the examples for Itemkey

OM Header workflowSELECT header_id FROM oe_order_headers_all


2/25

WHERE order_number = AND org_id = ;

OM Line level workflowSELECT line_id FROM oe_order_lines_allWHERE header_id = AND org_id = ;

PO Approval WorkflowSELECT wf_item_key FROM po_headers_allWHERE segment1 = AND org_id = ;

Requisition Workflow -

SELECT wf_item_key FROM po_requisition_headers_allWHERE segment1 = AND org_id = ;

After getting the workflow name and itemkey for the workflow which is not running follow the below

steps:

Go to workflow status monitor.

Figure 3: Navigation to Workflow Status Monitor

Enter the Workflow type and Itemkey of the workflow

Workflow may be in Active/Error/Complete/Defferred status

Complete - Workflow has successfully completed.Error - Workflow has error out.Active - Workflow is still active.Defferred - Workflow is waiting to be picked up by workflow

background engine.Active:

Select the workflow which we need to troubleshoot and click on the activity history.

Ensure that the recent activity is not in deferred status if so run the workflow background process.

Click on the activity to get the details

Figure 4: Activity Details ofWorkflow Activity

If the function type is PL/SQL then debug the package mentioned in the Function column (e.gOE_STANDARD_WF.STANDARD_BLOCK).

Retry

Select the recent activity and click on the retry button if the activity shows as error to restart the

workflow.If the error still exists then click on the error to debug the package as done for the active status.

Deferred

If the recent status is deferred then check the workflow background engine status. Also check the

deferred queue in the wf_deferred_table_m for the specific workflowSelect * from wf_deferred_table_m where corrid = APPS + ;

Notifications not getting fired:

All the workflow notifications are stored in the WF_NOTIFICATIONS table.Select * from WF_Notifications where subject = ;

Column Descriptions:

Mail_status:


3/25

Sent: - Mails are sent to the recipients.Error: - Mails are not delivered to the recipient may be due to invalid email address.

Status:Open: - Mails have been sent to the recipient and not yet viewed by the user.Closed: - Mail has been viewed by the recipient.Error: - Mail server is unable to deliver the message.Cancelled :- Workflow got cancelledTimeout :- Notification got timed out

Context: It has the itemtype and itemkey separated by Colons. Recipient Role : It has the recipient rolesSelect * from WF_roles where name = ;Select * from wf_user_roles where role_name = ;

After analyzing the columns of the wf_notifications, wf_roles, & wf_user_roles we can get the reasonfor the notifications not getting fired.

Common Reasons:

Recipient has left the company so the role has expired. Invalid email address. Email address may be different from the HR tables in such cases run the concurrent program WF

Synchronize Local Tables If emails got struck in the mail server contact the DBA team. If emails are not sent to the correct recipients then check the setups. Notification preference of the recipients may be Query/Summary which will not send email

notification but can be viewed from the recipient notification worklist.

Other workflow Tips:

Always clear the cache if you are not able to open the notifications listed in the notification worklist. If you are not able to view the workflow status diagram of the workflows owned by other users then

set the workflow Administrator privilege to *.

Figure 5: Workflow Configuration Page

Purge Obsolete Workflow runtime data concurrent program should be running every day toimprove the performance of the workflow.

Use the Set Override address in Test instances to check the email notifications.Troubleshooting Workflow Notification Mailer

IssuesTroubleshooting Workflow Notification Mailer Issues

Find Workflow Notification Mailer is up and Running?

SELECT component_name, component_status

FROM fnd_svc_components

WHERE component_type = 'WF_MAILER';

Workflow logs: FNDCPGSC*.txt under $APPLCSF/$APPLOG directory

Find the Failed Ones?

Select NOTIFICATION_ID, MESSAGE_TYPE, MESSAGE_NAME, STATUS, MAIL_STATUS, FROM_USER, TO_USER

from wf_notifications where MAIL_STATUS='FAILED';


4/25

Check pending e-mail notification that was pending for process.

Sql> SELECT COUNT(*), message_name FROM wf_notifications

WHERE STATUS='OPEN'

AND mail_status = 'MAIL'GROUP BY message_name;

Sql> SELECT * FROM wf_notifications

WHERE STATUS='OPEN'

AND mail_status = 'SENT'

ORDER BY begin_date DESC

Check the Workflow notification has been sent or not?

select mail_status, status from wf_notifications where notification_id=

--If mail_status is MAIL, it means the email delivery is pending for workflow mailer to send the

notification

--If mail_status is SENT, its means mailer has sent email

--If mail_status is Null & status is OPEN, its means that no need to send email as notification preference

of user is "Don't send email"

--Notification preference of user can be set by user by logging in application + click on preference + the

notification preference

1. Verify whether the message is processed in WF_DEFERRED queue

select * from applsys.aq$wf_deferred a where a.user_data.getEventKey()= ''

- notification id

2. If the message is processed successfully message will be enqueued to WF_NOTIFICATION_OUT queue, if

it errored out it will be enqueued to WF_ERROR queue

select wf.user_data.event_name Event_Name, wf.user_data.event_key Event_Key,

wf.user_data.error_stack Error_Stack, wf.user_data.error_message Error_Msg

from wf_error wf where wf.user_data.event_key = '

To check what all mails have went and which all failed ?

Select from_user,to_user,notification_id, status, mail_status, begin_date

from WF_NOTIFICATIONS where status = 'OPEN';


5/25

Select from_user, to_user, notification_id, status,

mail_status,begin_date,USER_KEY,ITEM_KEY,MESSAGE_TYPE,MESSAGE_NAME begin_date

from WF_NOTIFICATIONS where status = 'OPEN';

Users complain that notifications are stuck ?

Use the following query to check to see whatever the users are saying is correct

SQL> select message_type, count(1) from wf_notifications

where status='OPEN' and mail_status='MAIL' group by message_type;

E.g o/p of query -

MESSAGE_Type COUNT(1)

-------- ----------

POAPPRV 11 --- 11 mails of Po Approval not sent ---

INVTROAP 12

REQAPPRV 9

WFERROR 45 --- 45 mails have error

If Mail not received by User ?

select Name,DISPLAY_NAME,EMAIL_ADDRESS,NOTIFICATION_PREFERENCE,STATUS

from wf_users where DISPLAY_NAME=xxx,yyy ;

Status Active

Notification_preference-> Mailtext

Email Address should not be null

Notification not sent waiting to be mailed ?

SQL> select notification_id, status, mail_status, begin_date from WF_NOTIFICATIONSwhere status = OPEN and mail_status = MAIL;

To debug the notification id ?


6/25

$FND_TOP/sql

run wfmlrdbg.sql

******************************

Note: 1054215.1 - How to Check if the Workflow Mailer is Running

Note: 415516.1 - How to Check Whether Notification Mailer is Working or Not

Note: 831982.1 - 11i/R12 - A guide for troubleshoting Workflow Notification Emails - Inbound and

Outbound

Note: 1012344.7 - Notifications Not Being Sent In Workflow

Note: 560472.1 - Workflow Mailers Not Sending Notifications

Please see (Note: 753845.1 - How to Perform a Meaningful SMTP Telnet Test to Troubleshoot Java Mailer

Issues), the same error is reported in this doc.

*****************

Work-Flow mailer Architechture

Oracle Apps DBA point of view which is Workflow Notification Mailer .

Currently with OWF.H (Oracle Work Flow Minipack H) or 11.5.10 Oracle Applications Uses Java Mailer& before that it used to be

C Mailer.

Some of you who are on 11.5.8 or lower version might still be using wfmail.cfg under FND_TOP .

Configuration is quite simple via OAM (Oracle Application Manager) provided you or your unix team setup inbound & outbound

mails set up correctly.

Notification Mailer will inturn use Operating System command/mail for inbound(for receiving mail) & outbound(for sending mails).

In 11.5.10 Java Notification Mailer is available out of the box , you simply need to configure via Oracle Application Manager .

Workflow Notification Mailer Setup in Oracle Apps R12/12i

Workflow notification mailer setup in R12 is similar to 11i ( In both release 11i (OWF.H and higher in 11i) & R12 are Java Mailer)

* Previous version of Notification Mailer in 11i was based on C also called as C Mailer

Things to note

1. You use Oracle Application Manager (OAM) to configure Workflow Notification Mailer.

2. There are two kind of Notification (Outbound & Inbound) in Workflow Mailer

3. For Outbound Notification, CM (Concurrent Manager) node should be able to connect to SMTP (Simple Mail Transfer Protocol)

server/relay.

4. For Inbound Notification (Optional), CM node should be able to connect to IMAP (Internet Message Access Protocol) Server.

5. Log file for Workflow Mailer Notification are at $APPLCSF/$APPLLOG/FNDC*.txt
http://oraclehub.wordpress.com/2012/07/17/work-flow-mailer-architechture/http://oraclehub.wordpress.com/2012/07/17/work-flow-mailer-architechture/


7/25

6. Workflow Notification Mailer in background run as Concurrent Manager (Workflow Mailer Service, Workflow Agent

Listener Service)

7. If you dont wish to send mail notification to end user (from Dev/Test instance) then configure Test Address in configuration

screen.

Step to configure Workflow Notification Mailer

1. Login to Apps R12 with System Administrator Reponsibility

2. under Workflow : Oracle Applications Manager click on Workflow Manager

If this is first time you are configuring Workflow Notification Mailer in Oracle Apps R12/12i you will see Notification Mailers as

unavailable

Click on Notification Mailers

In next screen (as shown below, click on Edit Button)

Here you have option to select Inbound notification setup or Just outgoing Notification Setup.

Provide SMTP Server Name (ensure that CM node should be able to connect to SMTP Server or SMTP Relay)

UncheckInbound Processing(from above screen), if you dont wish to configure Inbound Notification Mailer.

If you wish to configure Inbound Notification as well then ensure IMAP Server should be configured with a valid user (createInbox,

Processed &Discard folder for this User)

Click onApply button to finish configuration, at this stage Notification Mailer will test SMTP Server & IMAP Server connectivity.

For Advanced setup, click onAdvanced at top right of configuration screen.

Metalink Notes for Notification Mailer

1. 453137.1 Oracle Workflow Best Practices Release 12 and Release 11i

2. 274764.1 Oracle Workflow Cartridge Workflow Java Mailer Setup Test

3. 433359.1 Tracking Workflow Notification Event Messages

4. 456921.1 Queries Related to Alert and Mailer Integration Post RUP4

5. 454706.1 How to Stop mails from Workflow Notification Mailer

Oracle Workflow Notification Mailer Outbound Processing

===========================================

Here are steps/events for Oracle Workflow Notification Outbound Processing(eMail from Oracle Applications Workflow to

Users)

1.When workflow Engine determines that a notification message must be sent, it raises an event in BES (Business Event System)

oracle.apps.wf.notifications.send

Event is raised with Notification ID (NID) as event key

2. There is seeded subscription to this Event

3. Event is placed on WF_DEFERRED agent

4.Event is dequeued from WF_DEFERRED and subscription is processed


8/25


9/25

.

Problem with above solution

- Execution ofAutoconfig will override above settings. Autoconfig will pick value against parameter s_wf_admin_role(default

value SYSADMIN) from context file $CONTEXT_FILE

.

Correct way to set Workflow Administrator Role

1. First identify Workflow RoleName associated with User or Responsibility.

A. For setting Admin Role to specific user

SQL> select name from apps.wf_roles where DISPLAY_NAME like '&USER_NAME' and

ORIG_SYSTEM='FND_USR';

B. For setting it to a responsibility (so that all users with that responsibility can

view other users Workflow)

SQL> select name from apps.wf_roles where DISPLAY_NAME like '&Responsibility_Name' and

ORIG_SYSTEM='FND_RESP';

SQL> select name from apps.wf_roles where DISPLAY_NAME like System Administrator;

(output for System Administrator responsibility should look

like)FND_RESP|SYSADMIN|SYSTEM_ADMINISTRATOR|STANDARD

SQL> select name from apps.wf_roles where DISPLAY_NAME like Application Developer;

(output forApplication Developer responsibility should look like)

FND_RESP|FND|APPLICATION_DEVELOPER|STANDARD

2. Update context file ($CONTEXT_FILE) variable s_wf_admin_role (If you dont see this

parameter in context file then apply latest Autoconfig Patch) to value from above query

For Sysadmin User - Set it to SYSADMIN

For System Administrator Responsibility - Set it to

FND_RESP|SYSADMIN|SYSTEM_ADMINISTRATOR|STANDARD

For Application Developer Responsibility - Set it

toFND_RESP|FND|APPLICATION_DEVELOPER|STANDARD

3. RunAutoconfig -

$OAD_TOP/admin/scripts/$CONTEXT_NAME/ adautocfg.sh (11i)

$ADMIN_SCRIPTS_HOME/adautocfg.sh (R12)

Reference documents for Workflow mailer setup


10/25

=============================================

268085.1 Configuring the Oracle Workflow 2.6/11i.OWF.H Java-based Notification Mailer

with Oracle Applications 11i

164871.1 Configuring the Workflow Notification Mailer in Oracle Applications Manager

11i

172174.1 WF 2.6: Oracle Workflow Notification Mailer Architecture in Release 11i

453137.1 Oracle Workflow Best Practices Release 12 and Release 11i

274764.1 Oracle Workflow Cartridge Workflow Java Mailer Setup Test

433359.1 Tracking Workflow Notification Event Messages

456921.1 Queries Related to Alert and Mailer Integration Post RUP4

454706.1 How to Stop mails from Workflow Notification Mailer

How to Perform a Meaningful SMTP Telnet Test to

Troubleshoot Java Mailer For Sending Email

Notifications [ID 753845.1]

Posted: June 26, 2012 inWorkflow-mailer

0

How to Perform a Meaningful SMTP Telnet Test toTroubleshoot Java Mailer For Sending Email Notifications[ID 753845.1]This document details the steps to perform a meaningful telnet test to investigate java mailer issues related to sending

workflow email notifications to the SMTP server.As it is explained in the Oracle Workflow Administrators Guide, it is

mandatory to have an SMTP server set up in order to send the workflow notification e-mail messages. This means that the

notification mailer does not send the notification e-mails itself but completely relies on the SMTP server to achieve this task.

For this reason, it is important to be able to send an email using telnet on the SMTP server in the conditions that are used by the

mailer.

Note:this test is useful in the following situations (the below list is not exhaustive):
http://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/http://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/http://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/#respondhttp://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/#respondhttp://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/#respondhttp://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/http://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/http://oraclehub.wordpress.com/2012/06/26/how-to-perform-a-meaningful-smtp-telnet-test-to-troubleshoot-java-mailer-for-sending-email-notifications-id-753845-1/


11/25

- You are setting the workflow notification mailer up and you want to validate the outbound processing parameters.

- You suspect a connectivity issue between the java mailer node and the SMTP server node.

- You suspect that SMTP server does not process emails.

- You notice that given notifications in WF_NOTIFICATIONS have MAIL_STATUS = FAILED, and that the notification preference of

the notification recipient has been switched to DISABLED (this can be seen in $FND_TOP/sql/wfmlrdbg.sql output againt the given

notification id).

- You want to validate a given email address.

More particularly this test will provide relevant output when the following strings are seen in mailer log:

- javax.mail.SendFailedException: 550 5.7.1 Unable to relay

- javax.mail.MessagingException

- Invalid Address

- Relay access denied

- Unable to relay- Relaying denied

- Client does not have permission to submit mail to this server

- Validation failed for the following parameters -> {OUTBOUND_SERVER=Unable to make a

network connection.}

- EXCEPTION:[SVC-GSM-WFMLRSVC-12848-10006 :

oracle.apps.fnd.wf.mailer.SMTPOutboundProcessor.read]:Not sending notification

{3939936}because the notification mail status is null OR not 'MAIL'

- Updating notification {3939936} status {FAILED} {WFMLRSND_FAILED_UNDELIVERABLE}

{{SYSADMIN}}

etc...

SOLUTIONIt is very important to perform all the steps mentioned below; they will allow to perform the telnet SMTP test from the right node

and to pass the correct values during the test.

1) Identify the concurrent tiers node where mailer runs

by running script below:

select target_node from fnd_concurrent_queues where concurrent_queue_name like

'WFMLRSVC%';


12/25

It will return for example:

TARGET_NODE

------------------------------

ebiz1

In this example ebiz1 is the node where java mailer runs.

2) Gather other parameters values necessary for the SMTP telnet test:

To perform the SMTP telnet test, in addition to mailer node, you will also need to know on which node is the SMTP server (this is

mailer outbound server parameter), and what is the reply to address that is set up for the java mailer (this is mailer reply to

parameter).

To get these values run the following:

SELECT b.component_name,

c.parameter_name,

a.parameter_value

FROM fnd_svc_comp_param_vals a,

fnd_svc_components b,

fnd_svc_comp_params_b c

WHERE b.component_id = a.component_id

AND b.component_type = c.component_type

AND c.parameter_id = a.parameter_id

AND c.encrypted_flag = 'N'

AND b.component_name like '%Mailer%'

AND c.parameter_name in ('OUTBOUND_SERVER', 'REPLYTO')

ORDER BY c.parameter_name;

It will return for example:

COMPONENT_NAME PARAMETER_NAME PARAMETER_VALUE

------------------------------- ------------------------------ -----------------------

Workflow Notification Mailer OUTBOUND_SERVER mitini1

Workflow Notification Mailer REPLYTO jmailer1@dummy_domain.com
mailto:jmailer1@dummy_domain.commailto:jmailer1@dummy_domain.com


13/25

In this example the outbound server is on mitini1 node and the reply to address is set tojmailer1@dummy_domain.com.

3) Perform the SMTP telnet test as follows:

3.1) Log on to the node where mailer runs (to identify it, please refer to step 1)

This is mandatory. SMTP telnet test is only meaningful when it is performed from the concurrent tier where mailer runs.

In our example you should log to ebiz1 node.

3.2) From mailer node, issue the following commands one by one:

telnet [outbound server] 25

EHLO [mailer node]

MAIL FROM: [reply_to address]

RCPT TO: [my_test_email_address]

DATA

Subject: Test messageTest message body

.

quit

Notes:a) Very important, the commands needs to be entered one by one

b) Replace [outbound server] by the value retrieved for OUTBOUND_SERVER in step 2.

c) Replace [mailer node] by the value retrieved in step 1.

d) Replace [reply_to address] by the value retrieved for REPLYTO in step 2.

e) Replace [my_test_email_address] by the email address that you need to test.

f) By default SMTP server runs on port 25. If another port is used youll have to modify the port accordingly in the syntax below.

g) Enter a blank line after the email subject and after the text Test message body.

h) The end of the message is signaled by a . on a line by itself.

i) To exit the telnet session, typequit and then hit enter.

So the commands to enter in the context of our example are:

telnet mitini1 25

EHLO ebiz1

MAIL FROM: jmailer1@dummy_domain.com

RCPT TO: robert.king@dummy_domain.com

DATA

Subject: Test messageTest message body
mailto:jmailer1@dummy_domain.commailto:jmailer1@dummy_domain.commailto:jmailer1@dummy_domain.commailto:jmailer1@dummy_domain.com


14/25

.

quit

(lets assume robert.king@dummy_domain.com is the given address you want to test)

3.3) Then verify the following:

a) Has an error message been thrown during the test?

To compare the output you get with the normal output received during telnet SMTP test, please refer to section 8a (Verify SMTP

Server ) innote 242941.1How To Troubleshoot Java-based Workflow Notification Mailer In 11.5.9 and OWF.G.

b) Check the INBOX of the email address used for the test (my_test_email_address)

Is there an email here with Subject: Test message and with sender corresponding to reply_to_address email address?

In our example, you should check robert.king@dummy_domain.com INBOX and research a message with subject Test message

and that is from sender jmailer1@dummy_domain.com.

4) Test interpretation

If an error message has been thrown during the test, or if the test email has not been received, this means the SMTP telnet test is

not successful. Because the java mailer uses the SMTP server to send notification emails, it is a prerequisite for a correct behavior

of the java mailer that this test is successful.

If the test is not successful, depending on the message received, the problem has to be addressed by the SMTP Server

administrator or the Network administrator. Commonly, relaying needs to be enabled.

5) Finishing tasks

a) Confirm that the SMTP server defined within the Workflow Notification mailer setup reflects the correct address.

b) Once the mail server tests are complete and successful, to re-send any failed notifications, please run the Resend Failed

Notifications concurrent request.

Workflow Information Center, Diagnostics, & Community Please reference the Workflow Product Information Center Document for Top Workflow Resources:Document 1320509.1

For additional help, please refer to one of the following documents on diagnostics to address current needs. Providingdiagnostic output on an issue for support when logging a service request is very helpful.Document 179661.1for 11i or

Document 421245.1for Rel 12.x

Visit theCore Workflowcommunity for help with industry experts or to share knowledge.
https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=242941.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=242941.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=242941.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1320509.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1320509.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1320509.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=179661.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=179661.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=179661.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=421245.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=421245.1https://communities.oracle.com/portal/server.pt/community/core_workflow/244https://communities.oracle.com/portal/server.pt/community/core_workflow/244https://communities.oracle.com/portal/server.pt/community/core_workflow/244https://communities.oracle.com/portal/server.pt/community/core_workflow/244https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=421245.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=179661.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1320509.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=242941.1


15/25

Please seeDocument 1186338.1for recorded Workflow Webcasts

Troubleshooting Workflow Notification Mailer

IssuesPosted: June 26, 2012 inWorkflow-mailer

0

Troubleshooting Workflow Notification Mailer IssuesTroubleshooting Workflow Notification Mailer Issues

Troubleshooting Workflow Notification Mailer Issues

Find Workflow Notification Mailer is up and Running?

SELECT component_name, component_status

FROM fnd_svc_components

WHERE component_type = WF_MAILER;

Workflow logs: FNDCPGSC*.txt under $APPLCSF/$APPLOG directory

Find the Failed Ones?

Select NOTIFICATION_ID, MESSAGE_TYPE, MESSAGE_NAME, STATUS, MAIL_STATUS, FROM_USER, TO_USER from

wf_notifications where MAIL_STATUS=FAILED;

Check pending e-mail notification that was pending for process.

Sql> SELECT COUNT(*), message_name FROM wf_notifications

WHERE STATUS=OPEN

AND mail_status = MAIL

GROUP BY message_name;

Sql> SELECT * FROM wf_notifications

WHERE STATUS=OPEN
https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1186338.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1186338.1https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1186338.1http://oraclehub.wordpress.com/2012/06/26/troubleshooting-workflow-notification-mailer-issues/http://oraclehub.wordpress.com/2012/06/26/troubleshooting-workflow-notification-mailer-issues/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/2012/06/26/troubleshooting-workflow-notification-mailer-issues/#respondhttp://oraclehub.wordpress.com/2012/06/26/troubleshooting-workflow-notification-mailer-issues/#respondhttp://oraclehub.wordpress.com/2012/06/26/troubleshooting-workflow-notification-mailer-issues/#respondhttp://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/2012/06/26/troubleshooting-workflow-notification-mailer-issues/http://oraclehub.wordpress.com/2012/06/26/troubleshooting-workflow-notification-mailer-issues/https://supporthtml.oracle.com/epmos/faces/ui/km/DocumentDisplay.jspx?id=1186338.1


16/25

AND mail_status = SENT

ORDER BY begin_date DESC

Check the Workflow notification has been sent or not?

select mail_status, status from wf_notifications where notification_id=

If mail_status is MAIL, it means the email delivery is pending for workflow mailer to send the notification

If mail_status is SENT, its means mailer has sent email

If mail_status is Null & status is OPEN, its means that no need to send email as notification preference of user is Dont send

email

Notification preference of user can be set by user by logging in application + click on preference + the notification preference

1. Verify whether the message is processed in WF_DEFERRED queue

select * from applsys.aq$wf_deferred a where a.user_data.getEventKey()=

- notification id

2. If the message is processed successfully message will be enqueued to WF_NOTIFICATION_OUT queue, if it errored out it will be

enqueued to WF_ERROR queue

select wf.user_data.event_name Event_Name, wf.user_data.event_key Event_Key,

wf.user_data.error_stack Error_Stack, wf.user_data.error_message Error_Msg

from wf_error wf where wf.user_data.event_key =

To check what all mails have went and which all failed ?

Select from_user,to_user,notification_id, status, mail_status, begin_date

from WF_NOTIFICATIONS where status = OPEN;

Select from_user, to_user, notification_id, status, mail_status,begin_date,USER_KEY,ITEM_KEY,MESSAGE_TYPE,MESSAGE_NAME

begin_date

from WF_NOTIFICATIONS where status = OPEN;

Users complain that notifications are stuck ?


17/25

Use the following query to check to see whatever the users are saying is correct

SQL> select message_type, count(1) from wf_notifications

where status=OPEN and mail_status=MAIL group by message_type;

E.g o/p of query -

MESSAGE_Type COUNT(1)

-

POAPPRV 11 11 mails of Po Approval not sent

INVTROAP 12

REQAPPRV 9

WFERROR 45 45 mails have error

If Mail not received by User ?

select Name,DISPLAY_NAME,EMAIL_ADDRESS,NOTIFICATION_PREFERENCE,STATUS

from wf_users where DISPLAY_NAME=xxx,yyy ;

Status Active

Notification_preference-> Mailtext

Email Address should not be null

Notification not sent waiting to be mailed ?

SQL> select notification_id, status, mail_status, begin_date from WF_NOTIFICATIONS

where status = OPEN and mail_status = MAIL;

To debug the notification id ?

$FND_TOP/sql

run wfmlrdbg.sql

******************************

Note: 1054215.1 How to Check if the Workflow Mailer is Running

Note: 415516.1 How to Check Whether Notification Mailer is Working or Not


18/25

Note: 831982.1 11i/R12 A guide for troubleshoting Workflow Notification Emails Inbound and Outbound

Note: 1012344.7 Notifications Not Being Sent In Workflow

Note: 560472.1 Workflow Mailers Not Sending Notifications

Please see (Note: 753845.1 How to Perform a Meaningful SMTP Telnet Test to Troubleshoot Java Mailer Issues), the same error

is reported in this doc.

Oracle workflow notification mailer statussql

Posted: June 26, 2012 inAPPS scripts,Workflow-mailer

0

Oracle workflow notification mailer status sql

Oracleworkflow notification mailer sqls

=========================================

1. Workflow: version

2. check workflow status.

3. check if workflow is used by only one instance

4. check if processor_read_timeout_close is set to Y

5. check for bad e-mail address

6. How to know mail sent to a user with details:

7. How to know whether it is set to correct url from porfile options:

8. How to know reqid, process id, sid..

9. workflow patches
http://oraclehub.wordpress.com/2012/06/26/oracle-workflow-notification-mailer-status-sql/http://oraclehub.wordpress.com/2012/06/26/oracle-workflow-notification-mailer-status-sql/http://oraclehub.wordpress.com/2012/06/26/oracle-workflow-notification-mailer-status-sql/http://oraclehub.wordpress.com/category/apps-scripts/http://oraclehub.wordpress.com/category/apps-scripts/http://oraclehub.wordpress.com/category/apps-scripts/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/2012/06/26/oracle-workflow-notification-mailer-status-sql/#respondhttp://oraclehub.wordpress.com/2012/06/26/oracle-workflow-notification-mailer-status-sql/#respondhttp://oraclehub.wordpress.com/2012/06/26/oracle-workflow-notification-mailer-status-sql/#respondhttp://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/apps-scripts/http://oraclehub.wordpress.com/2012/06/26/oracle-workflow-notification-mailer-status-sql/


19/25

10. Workflow: To see failed, open notifications

11. To check if email address, notification preference, display_name

12. How to know workflow responsibility from backend:

13. Steps to drop and recreate WF_CONTROL queue:

=================

1. Workflow: version

=================

$FND_TOP/sql/wfver.sql

----------------------------------------------------

2. check workflow status.

----------------------------------------------------

set linesize 120

set pagesize 50

column COMPONENT_NAME format a45

column STARTUP_MODE format a15

column COMPONENT_STATUS format a15

select fsc.COMPONENT_NAME,fsc.STARTUP_MODE,fsc.COMPONENT_STATUS,fcq.last_update_date

fromAPPS.FND_CONCURRENT_QUEUES_VL fcq, fnd_svc_components fsc

where fsc.concurrent_queue_id = fcq.concurrent_queue_id(+)

order by COMPONENT_STATUS , STARTUP_MODE , COMPONENT_NAME;

----------------------------------------------------

3. check if workflow is used by only one instance

----------------------------------------------------

col value format a20

select p.parameter_id,

p.parameter_name,

v.parameter_value value

from apps.fnd_svc_comp_param_vals_v v,

apps.fnd_svc_comp_params_b p,


20/25

apps.fnd_svc_components c

where c.component_type = 'WF_MAILER'

and v.component_id = c.component_id

and v.parameter_id = p.parameter_id

and p.parameter_name in ( 'INBOUND_SERVER','ACCOUNT', 'REPLYTO')

order by p.parameter_name;

----------------------------------------------------

4. check if processor_read_timeout_close is set to 'Y'

----------------------------------------------------

set pagesize 100

set linesize 132

set feedback off

set verify off

col value format a35

col component_name format a30

select c.component_id, c.component_name, p.parameter_id, p.parameter_name,

v.parameter_value value

from apps.fnd_svc_comp_param_vals_v v, apps.fnd_svc_comp_params_b p,

apps.fnd_svc_components c

where c.component_type = 'WF_MAILER'

and v.component_id = c.component_id

and v.parameter_id = p.parameter_id

and p.parameter_name = 'PROCESSOR_READ_TIMEOUT_CLOSE'

order by c.component_name,p.parameter_name;

-

5. check for bad e-mail address

-

If below SQL statement is returning rows you need to correct the email addresses for associated users:

set linesize 170

col name format a40

col email_address format a80

select name, email_address from apps.wf_local_roles where email_address like '% %';

select name, email_address from apps.wf_local_roles where email_address like '%%';

============================================


21/25

6. How to know mail sent to a user with details:

============================================

select name, display_name, notification_preference, email_address from wf_local_roles

where name = '';

====================================================================

7. How to know whether it is set to correct url from porfile options:

====================================================================

set linesize 155;

set pagesize 200;

set verify off;

col Profile format a50;

col Value format a50;

select t.PROFILE_OPTION_ID ID, z.USER_PROFILE_OPTION_NAME Profile,

nvl(v.PROFILE_OPTION_VALUE,'Replace with non-virtual URL') Value

from apps.fnd_profile_options t, apps.fnd_profile_option_values

v,apps.fnd_profile_options_tl z

where (v.PROFILE_OPTION_ID (+) = t.PROFILE_OPTION_ID)

and (z.PROFILE_OPTION_NAME = t.PROFILE_OPTION_NAME)

and (t.PROFILE_OPTION_NAME in ('WF_MAIL_WEB_AGENT'));

====================================

8. How to know reqid, process id, sid..

=====================================

select request_id,phase_code,status_code,hold_flag from fnd_concurrent_requests where

REQUEST_ID=20422815;

select ORACLE_PROCESS_ID,ORACLE_SESSION_ID,OS_PROCESS_ID from fnd_concurrent_requests

where REQUEST_ID=20422815;

select a.session_id,

b.owner,

b.object_type,

b.object_name,

a.oracle_username,

a.os_user_name,

a.process,

a.locked_mode

from v$locked_object a, dba_objects b


22/25

where b.object_id = a.object_id

and a.session_id='3383';

select name, display_name, notification_preference, email_address from wf_local_roles

where name = 'SYSADMIN';

===================

9. workflow patches

===================

will provide us information as to your base line codelevel.

Many issues are only relevant to a certain codelevel so this information is essential:

set linesize 155;

set pagesize 200;

set verify off;

select b.bug_number bug, b.LAST_UPDATED_BY ldate, decode( bug_number, 2728236 , 'OWF.G

INCLUDED IN 11.5.9',

3031977, 'POST OWF.G ROLLUP 1 - 11.5.9.1',

3061871, 'POST OWF.G ROLLUP 2 - 11.5.9.2',

3124460, 'POST OWF.G ROLLUP 3 - 11.5.9.3',

3316333, 'POST OWF.G ROLLUP 4 - 11.5.9.4.1',

3314376, 'POST OWF.G ROLLUP 5 - 11.5.9.5',

3409889, 'POST OWF.G ROLLUP 5 Consolidated Fixes For OWF.G RUP5', 3492743, 'POST OWF.G

ROLLUP 6 - 11.5.9.6',

3868138, 'POST OWF.G ROLLUP 7 - 11.5.9.7',

3262919, 'FMWK.H',

3262159, 'FND.H INCLUDE OWF.H',

3258819, 'OWF.H INCLUDED IN 11.5.10',

3438354, '11i.ATG_PF.H INCLUDE OWF.H',

3140000, 'ORACLE APPLICATIONS RELEASE 11.5.10 MAINTENANCE PACK',

3240000, '11.5.10 ORACLE E-BUSINESS SUITE CONSOLIDATED UPDATE 1',

3460000, '11.5.10 ORACLE E-BUSINESS SUITE CONSOLIDATED UPDATE 2',

3480000, 'ORACLE APPLICATIONS RELEASE 11.5.10.2 MAINTENANCE PACK',

4017300, 'ATG_PF:11.5.10 Consolidated Update (CU1) for ATG Product Family',

4125550, 'ATG_PF:11.5.10 Consolidated Update (CU2) for ATG Product Family',

4719658, 'ONE OFF PATCH FOR MISSING RESPONSIBILITIES - WFDS Fix',

5121512, 'AOL USER RESPONSIBILITY SECURITY FIXES VERSION 1',


23/25

6008417, 'AOL USER RESPONSIBILITY SECURITY FIXES 2b',

4676589, '11i.ATG_PF.H RUP4',

5473858, '11i.ATG_PF.H RUP5',

5903765, '11i.ATG_PF.H RUP6',

4334965, '11i.ATG_PF.H RUP3') patch

from apps.AD_BUGS b

where b. BUG_NUMBER in

('2728236','3031977','3061871','3124460','3316333','3314376','3409889','3492743','32621

59','3262919','3868138','3258819','3438354','3240000','3460000','3140000','3480000','40

17300','4125550','4719658','5121512','6008417','4676589','5473858','5903765','4334965')

order by patch;

===============================================

10. Workflow: To see failed, open notifications

===============================================

SELECT message_type, COUNT(1)

FROM apps.wf_notifications

WHERE 1 = 1 AND mail_status = 'FAILED' AND status = 'OPEN'

GROUP BY message_type;

====================================================================

11. To check if email address, notification preference, display_name

====================================================================

select DISPLAY_NAME, NOTIFICATION_PREFERENCE from wf_users where EMAIL_ADDRESS =

'[email protected]' and STATUS = 'ACTIVE' and DISPLAY_NAME = 'xxxxx';

select DISPLAY_NAME, NOTIFICATION_PREFERENCE, EMAIL_ADDRESS from wf_users where

NOTIFICATION_PREFERENCE='MAILTEXT' and STATUS = 'ACTIVE';

select distinct(count(*)) from wf_users where NOTIFICATION_PREFERENCE='MAILTEXT' and

STATUS = 'ACTIVE' and EMAIL_ADDRESS = '[email protected]';

====================================================

12. How to know workflow responsibility from backend:

====================================================

select wes.status, wes.phase, wes.rule_function, wes.on_error_code from wf_events we,

wf_event_subscriptions wes


24/25

where we.name='oracle.apps.fnd.wf.ds.userRole.updated' and

we.guid=wes.event_filter_guid;

============================================

13. Steps to drop and recreate WF_CONTROL queue:

============================================

a. Shut down the concurrent managers.

b. Connect to sqlplus session asAPPS user:

Execute: (For Workflow Embedded withinApps)

SQL>exec DBMS_AQADM.DROP_QUEUE_TABLE(queue_table => 'APPLSYS.WF_CONTROL', force

=>TRUE);

SQL> commit;

Execute: (For Standalone Workflow)

sqlplus / @wfctlqec.sql

c. Execute wfjmsqc2.sql for creating all Advanced Queues with JMS Text structures.

Usage:

sqlplus / @wfjmsqc2.sql

Both of the script are under $FND_TOP/patch/115/sql or $FND_TOP/sql directories.

d.Run afwfqgnt.sql to recreate grants/synonyms for Workflow Advanced Queue tables

Usage:

sqlplus apps/apps @$FND_TOP/patch/115/sql/afwfqgnt.sqlAPPSAPPLSYS

Additional Information: For Rebuilding all other WF Queue refer Note 754468.1 Title: How to Rebuild Workflow Queues ,based on

your application version.


25/25

How To Route / Send All Workflow Mailer

Notifications To A Single Email Id / Address ?

Posted: June 24, 2012 inWorkflow-mailer

0

Mostly, this option will come handy after a clone, wherein you want to retain all the production / source instance data and continue

to run workflow mailer but without sending emails to the real end users.

To achieve this you can set an Override address to route all the notifications to a single email address.

Steps

1. Login as sysadmin

2. Select System Administration Responsibility

3. Click Workflow under Oracle Applications Manager

4. Click on the tick mark or page icon next to Notification Mailers

5. Click on Workflow Notification Mailer under Name column

6. Click Set Override Address button next to Test Mailer button

7. Key in the new email address and click submit.

After submitting, Java mailer will send a verification email to the mentioned email address with a verification code and link to

activate the override entry.

Either you can request the email id owner to send you the email with the verification code so that you can key-in the code or if the

email address owner has access to Oracle Apps, he/she can click the link and enter the verification code.
http://oraclehub.wordpress.com/2012/06/24/how-to-route-send-all-workflow-mailer-notifications-to-a-single-email-id-address/http://oraclehub.wordpress.com/2012/06/24/how-to-route-send-all-workflow-mailer-notifications-to-a-single-email-id-address/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/2012/06/24/how-to-route-send-all-workflow-mailer-notifications-to-a-single-email-id-address/#respondhttp://oraclehub.wordpress.com/2012/06/24/how-to-route-send-all-workflow-mailer-notifications-to-a-single-email-id-address/#respondhttp://oraclehub.wordpress.com/2012/06/24/how-to-route-send-all-workflow-mailer-notifications-to-a-single-email-id-address/#respondhttp://oraclehub.wordpress.com/category/workflow-mailer/http://oraclehub.wordpress.com/2012/06/24/how-to-route-send-all-workflow-mailer-notifications-to-a-single-email-id-address/http://oraclehub.wordpress.com/2012/06/24/how-to-route-send-all-workflow-mailer-notifications-to-a-single-email-id-address/

Troubleshooting Methods for Oracle Workflow

Documents

Transcript of Troubleshooting Methods for Oracle Workflow