WorkflowBESetup

Oracle Applications Release 11i Release 11.5.9 WorkFlow Business Events – The Setups You May Be Missing Karen Brownfield [email protected] Release 11i Workshops Dallas, TX • Cincinnati, OH • Phoenix, AZ • Los Angeles, CA Denver, CO • Washington, DC • Atlanta, GA • Portland, OR www.solutionbeacon.com © 2004 Solution Beacon, LLC. All Rights Reserved. About the Trainer n n n n n n 25+ yrs experience in IT Industry 12+ yrs experience Oracle Applications 5 yrs experience Workflow OAUG Board of Directors 11 years, Former President Presenter of Training/Presentations multiple clients, conferences Solution Beacon is a leading provider of expert-level resources to Government Agencies and Fortune 1000 companies specializing in the Oracle Applications marketplace, providing leading expertise in the following areas: u Release 11i Upgrades/Implementations u Oracle Apps Database Administration u Oracle Systems Architecture u Oracle Performance Tuning u Oracle Workflow © 2004 Solution Beacon, LLC. All Rights Reserved. 2 Steps to Set up Business Event System n Optional – Establish database links to external systems u Optional – Enable Oracle Message Broker queues n Optional – Set up custom queues n Required – Check Business Event setup parameters © 2004 Solution Beacon, LLC. All Rights Reserved. 3 All Rights Reserved. LLC. .Steps to Set up Business Event System n n n n n 4 Required – Schedule listeners for local inbound agents Required – Schedule propagation for local outbound agents Required – Synchronize event and subscription license statuses with product license statuses Required – Ensure WF_CONTROL queue is periodically cleaned up Optional – change Global Preference © 2004 Solution Beacon. Setting up Queues Each agent must have a queue n Standard queues created by upgrade/install n 5 © 2004 Solution Beacon. All Rights Reserved. LLC. . All Rights Reserved. LLC.AQ$_IMS_ TEXT_MESSAG E WF_EVENT_T Description Workflow internal queue – not for customer use Standard queue for deferred subscription processing Standard queue for error handling Default inbound queue WF_DEFERRED In WF_ERROR WF_IN In In WF_EVENT_T WF_EVENT_T 6 © 2004 Solution Beacon. .Standard Queues/Listeners Queue Table / Name WF_CONTROL In / Out Out Payload Type SYS. All Rights Reserved. .AQ$_IMS_ TEXT_MESSAG E SYS.AQ$_IMS_ TEXT_MESSAG E SYS.Standard Queues/Listeners Queue Table / Name WF_JMS_IN WF_JMS_OUT In / Out In Payload Type SYS. LLC.AQ$_IMS_ TEXT_MESSAG E SYS.AQ$_IMS_ TEXT_MESSAG E Description Default inbound queue for JMS Text messages Default outbound queue for JMS Text messages Standard inbound queue for e-mail notification responses Standard outbound queue for e-mail notifications Out WF_NOTIFICA In TION_IN WF_NOTIFICA Out TION_OUT 7 © 2004 Solution Beacon. All Rights Reserved.Standard Queues Queue Table / Name WF_OUT In / Out Out Payload Type WF_EVENT_T WF_EVENT_T WF_EVENT_T Description Default outbound queue Not documented Not documented Not currently used WF_REPLAY_ In IN WF_REPLAY_ Out OUT WF_SMTP_0_ In 1_QUEUE 8 © 2004 Solution Beacon. . LLC. DBMS_AQADM. All Rights Reserved. LLC.Alter_Queue procedure n DO NOT change any other parameters for these queues 9 © 2004 Solution Beacon.Standard Queues n Default retention for consumed messages – 7 days n To change. . Enabling OMB queues n n n Only Required for Oracle8i database Set up WF_OMB_IN and WF_OMB_OUT queues u Translates between standard workflow event msg structure. All Rights Reserved. Assign WF_EVENT_OMB_QH as propagation protocol 10 © 2004 Solution Beacon. LLC. . OMBAQ_TEXT_MSG. WF_EVENT_T. and structure required by OMB. All Rights Reserved.sql to create PL/SQL spec n Run wfquhndob. LLC. .sql to create PL/SQL body n Both located in $APPL_TOP/wf/sql n 11 © 2004 Solution Beacon.Enabling OMB queues Run wfquhndos. Check Business Event Setup Parameters n n Admin responsibility Workflow | Check Event Manager Setup 12 © 2004 Solution Beacon. . LLC. All Rights Reserved. ora file or ALTER SYSTEM statement (9i) © 2004 Solution Beacon. 13 . LLC.ora Parameters are equal or greater than recommended levels u Aq_tm_processes – monitors delay events such as Wait activity u Job_Queue_Processes – handles propagation of Business Event System event messages u Job_Queue_Interval (8i only) – how frequently job_Queue_process wakes up Change values through init.Check Business Event System Parameters n n Verify Database Init. All Rights Reserved. press Edit. LLC.Check Business Event System Parameters Verify queues are created for standard queues (Queue Name and Queue Created columns in Local Agents section) n Do not use Create Link to Schedule Inbound Listeners n If Link says Edit. All Rights Reserved. . click Delete n 14 © 2004 Solution Beacon. . All Rights Reserved. LLC.Check Business Event System Parameters n Start outbound propagations u Admin responsibility t Workflow | Check Event Manager Setup u Click Create for all queues used 15 © 2004 Solution Beacon. .Check Business Event System Parameters n Start Outbound (cont) u Click Create u Enter Duration u Enter reschedule interval u Enter latency (how long to wait after all messages queued before checking again) t Must be > or = job_queue_interval 16 © 2004 Solution Beacon. All Rights Reserved. LLC. LLC. All Rights Reserved.Schedule In-Bound Listeners n Verify Listeners for local inbound agents are scheduled u Do not utilize Create link in Check Event Manager Setup u ECX_INBOUND and ECX_TRANSACTION are only required if using EDI Gateway 17 © 2004 Solution Beacon. . Schedule In-Bound Listeners Start Containers Requires GSM to be configured n Profile option ‘Concurrent:GSM Enables’ should be set to ‘Y’ n Done through OAM n Start Workflow Agent Listener (required) n 18 © 2004 Solution Beacon. . LLC. All Rights Reserved. Start Containers n n 19 Navigate to Workflow Manager Click on Service Components © 2004 Solution Beacon. All Rights Reserved. . LLC. Start Containers 20 © 2004 Solution Beacon. LLC. . All Rights Reserved. and Inbound status is ‘Running’ If not. click the Workflow Agent Listener Service Container 21 © 2004 Solution Beacon. Error. LLC.Start Containers n n Verify Deferred. All Rights Reserved. Deferred Notification Agent. . WF_ERROR. WF_IN © 2004 Solution Beacon.Start Containers n n If status is Deactivated. WF_NOTIFICATION_IN. click radio button next to Service. 22 . ensure Start is displayed action. All Rights Reserved. LLC. click Go Starts agent listener service components for WF_DEFERRED. LLC. All Rights Reserved. then something is wrong with GSM link to concurrent managers Until link is fixed…. .Start Containers n n If status “sticks” on Activating (doesn’t change to Running). 23 © 2004 Solution Beacon.. check program definition. may not be enabled u Run a program for each queue u Schedule to rerun periodically 24 © 2004 Solution Beacon. All Rights Reserved. LLC. .Schedule In-Bound Listeners – GSM Not Configured n Concurrent program – Workflow Agent Listener u If doesn’t show in Run Requests window. All Rights Reserved.5. LLC.9 © 2004 Solution Beacon.Schedule In-Bound Listeners n n n Minimum listeners that must be scheduled u WF_IN u WF_DEFERRED u WF_NOTIFICATION_IN u WF_ERROR Can create Program Set WF_REPLAY_IN was accidentally required with initial 11. 25 . All Rights Reserved. .Synchronize License Statuses Concurrent program: Synchronize Product License and Workflow BES License n Will have to be added to Request Group n 26 © 2004 Solution Beacon. LLC. verify ‘Workflow Control Cleanup’ is scheduled n Oracle recommends every 12 hours n 27 © 2004 Solution Beacon. LLC. All Rights Reserved.Verify Queue Cleanup Scheduled From Concurrent Manager. . Revisit System Status n Global Preferences page u Enabled – Internal / External Events u Local Only– Internal Only u External Only – do not use this value u Disabled – do not use this value 28 © 2004 Solution Beacon. All Rights Reserved. . LLC. Business Event System setup is valid © 2004 Solution Beacon. LLC. 29 . All Rights Reserved.Verify Event System Works n Workflow Agent Ping/Acknowledge u Sends ping event message to each inbound agent on local system u Waits to receive acknowledgement event message from each agent n If this workflow completes successfully. LLC.Verify Event System Works n n 30 Event Queue Summary Note Current Count for Inbound queues © 2004 Solution Beacon. All Rights Reserved. . Verify Event System Works n n 31 Launch Process Click on Workflow Agent Ping/Acknowledge © 2004 Solution Beacon. All Rights Reserved. . LLC. Verify Event System Works n n n Make up a Item Key (must be unique) Select Master Ping Process in Process Name Click OK 32 © 2004 Solution Beacon. All Rights Reserved. . LLC. 33 . All Rights Reserved.Verify Event System Works n Starts One Master and 3 Details u Detail for each IN queue except ERROR © 2004 Solution Beacon. LLC. LLC. . All Rights Reserved.Verify Event System Works n n n 34 Return to Event Queue Summary Click on Flashlight beside any queue where count is higher (except Out) Click Go © 2004 Solution Beacon. if so.Verify Event System Works n n There should be one message in IN. then message will go to Replay queue and stay there until Replay concurrent process runs © 2004 Solution Beacon. All Rights Reserved. one in Deferred Check if count increased for Replay. LLC. 35 . use concurrent manager program to start it u Messages will stay in queue until next time concurrent process runs for that queue. master process won’t complete until all messages have made it through the replay queue © 2004 Solution Beacon. 36 . LLC.Verify Event System Works n As each message is either “consumed” (or transferred to Replay queue). detail process for that queue completes u If Replay queue is being used. All Rights Reserved. Questions and Answers KISS Keep It Simple and Supportablesm Thank You! Karen Brownfield kbrownfield@solutionbeacon. 37 .solutionbeacon. All Rights Reserved. LLC.com © 2004 Solution Beacon.com www.