© 2004 solution beacon, llc. all rights reserved. oracle applications release 11i release 11.5.9...
TRANSCRIPT
© 2004 Solution Beacon, LLC. All Rights Reserved.
Oracle Applications Release 11i
Release 11.5.9 WorkFlowBusiness Events – The
Setups You May Be MissingKaren [email protected]
Release 11i WorkshopsDallas, TX • Cincinnati, OH • Phoenix, AZ • Los
Angeles, CA Denver, CO • Washington, DC • Atlanta, GA • Portland, OR
www.solutionbeacon.com
2© 2004 Solution Beacon, LLC. All Rights Reserved.
About the Trainer
25+ yrs experience in IT Industry25+ yrs experience in IT Industry 12+ yrs experience Oracle Applications12+ yrs experience Oracle Applications 5 yrs experience Workflow5 yrs experience Workflow OAUG Board of Directors 11 years, Former OAUG Board of Directors 11 years, Former
PresidentPresident Presenter of Training/Presentations multiple Presenter of Training/Presentations multiple
clients, conferencesclients, conferences Solution BeaconSolution 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:
Release 11i Upgrades/Implementations Oracle Apps Database Administration Oracle Systems Architecture Oracle Performance Tuning Oracle Workflow
3© 2004 Solution Beacon, LLC. All Rights Reserved.
Steps to Set up Business Event System
Optional – Establish database links Optional – Establish database links to external systemsto external systems Optional – Enable Oracle Optional – Enable Oracle
Message Broker queuesMessage Broker queues Optional – Set up custom queuesOptional – Set up custom queues Required – Check Business Event Required – Check Business Event
setup parameterssetup parameters
4© 2004 Solution Beacon, LLC. All Rights Reserved.
Steps to Set up Business Event System
Required – Schedule listeners for local Required – Schedule listeners for local inbound agentsinbound agents
Required – Schedule propagation for local Required – Schedule propagation for local outbound agentsoutbound agents
Required – Synchronize event and Required – Synchronize event and subscription license statuses with product subscription license statuses with product license statuseslicense statuses
Required – Ensure WF_CONTROL queue is Required – Ensure WF_CONTROL queue is periodically cleaned upperiodically cleaned up
Optional – change Global PreferenceOptional – change Global Preference
5© 2004 Solution Beacon, LLC. All Rights Reserved.
Setting up Queues
Each agent must have a queueEach agent must have a queue Standard queues created by Standard queues created by
upgrade/installupgrade/install
6© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues/Listeners
Queue Queue Table / NameTable / Name
In / In / OutOut
Payload Payload TypeType
DescriptionDescription
WF_CONTROWF_CONTROLL
OutOut SYS.AQ$_IMSSYS.AQ$_IMS_TEXT_MESSA_TEXT_MESSAGEGE
Workflow internal Workflow internal queue – not for queue – not for customer usecustomer use
WF_DEFERREWF_DEFERREDD
InIn WF_EVENT_TWF_EVENT_T Standard queue for Standard queue for deferred subscription deferred subscription processingprocessing
WF_ERRORWF_ERROR InIn WF_EVENT_TWF_EVENT_T Standard queue for Standard queue for error handlingerror handling
WF_INWF_IN InIn WF_EVENT_TWF_EVENT_T Default inbound queueDefault inbound queue
7© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues/Listeners
Queue Queue Table / NameTable / Name
In / In / OutOut
Payload Payload TypeType
DescriptionDescription
WF_JMS_INWF_JMS_IN InIn SYS.AQ$_IMS_SYS.AQ$_IMS_TEXT_MESSATEXT_MESSAGEGE
Default inbound queue Default inbound queue for JMS Text messagesfor JMS Text messages
WF_JMS_OUTWF_JMS_OUT OutOut SYS.AQ$_IMS_SYS.AQ$_IMS_TEXT_MESSATEXT_MESSAGEGE
Default outbound queue Default outbound queue for JMS Text messagesfor JMS Text messages
WF_NOTIFICWF_NOTIFICATION_INATION_IN
InIn SYS.AQ$_IMS_SYS.AQ$_IMS_TEXT_MESSATEXT_MESSAGEGE
Standard inbound queue Standard inbound queue for e-mail notification for e-mail notification responsesresponses
WF_NOTIFICWF_NOTIFICATION_OUTATION_OUT
OutOut SYS.AQ$_IMS_SYS.AQ$_IMS_TEXT_MESSATEXT_MESSAGEGE
Standard outbound Standard outbound queue for e-mail queue for e-mail notificationsnotifications
8© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues
Queue Queue Table / Table / NameName
In / OutIn / Out Payload TypePayload Type DescriptionDescription
WF_OUTWF_OUT OutOut WF_EVENT_TWF_EVENT_T Default outbound Default outbound queuequeue
WF_REPLAYWF_REPLAY_IN_IN
InIn WF_EVENT_TWF_EVENT_T Not documentedNot documented
WF_REPLAYWF_REPLAY_OUT_OUT
OutOut WF_EVENT_TWF_EVENT_T Not documentedNot documented
WF_SMTP_0WF_SMTP_0_1_QUEUE_1_QUEUE
InIn Not currently Not currently usedused
9© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues
Default retention for consumed Default retention for consumed messages – 7 daysmessages – 7 days
To change, To change, DBMS_AQADM.Alter_Queue procedureDBMS_AQADM.Alter_Queue procedure
DO NOT change any other DO NOT change any other parameters for these queuesparameters for these queues
10© 2004 Solution Beacon, LLC. All Rights Reserved.
Enabling OMB queues
Only Required for Oracle8Only Required for Oracle8i i databasedatabase Set up WF_OMB_IN and WF_OMB_OUT Set up WF_OMB_IN and WF_OMB_OUT
queuesqueues Translates between standard Translates between standard
workflow event msg structure, workflow event msg structure, WF_EVENT_T, and structure required WF_EVENT_T, and structure required by OMB, OMBAQ_TEXT_MSG.by OMB, OMBAQ_TEXT_MSG.
Assign WF_EVENT_OMB_QH as Assign WF_EVENT_OMB_QH as propagation protocolpropagation protocol
11© 2004 Solution Beacon, LLC. All Rights Reserved.
Enabling OMB queues
Run wfquhndos.sql to create Run wfquhndos.sql to create PL/SQL specPL/SQL spec
Run wfquhndob.sql to create Run wfquhndob.sql to create PL/SQL bodyPL/SQL body
Both located in $APPL_TOP/wf/sqlBoth located in $APPL_TOP/wf/sql
12© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event Setup Parameters
Admin Admin responsibilityresponsibility
Workflow | Workflow | Check Event Check Event Manager SetupManager Setup
13© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event System Parameters
Verify Database Init.ora Parameters are equal Verify Database Init.ora Parameters are equal or greater than recommended levelsor greater than recommended levels Aq_tm_processes – monitors delay events Aq_tm_processes – monitors delay events
such as Wait activitysuch as Wait activity Job_Queue_Processes – handles propagation Job_Queue_Processes – handles propagation
of Business Event System event messagesof Business Event System event messages Job_Queue_Interval (8i only) – how Job_Queue_Interval (8i only) – how
frequently job_Queue_process wakes upfrequently job_Queue_process wakes up Change values through init.ora file or ALTER Change values through init.ora file or ALTER
SYSTEM statement (9i)SYSTEM statement (9i)
14© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event System Parameters
Verify queues are created for Verify queues are created for standard queues (Queue Name and standard queues (Queue Name and Queue Created columns in Local Queue Created columns in Local Agents section)Agents section)
Do not use Create Link to Schedule Do not use Create Link to Schedule In-bound ListenersIn-bound Listeners
If Link says Edit, press Edit, click If Link says Edit, press Edit, click DeleteDelete
15© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event System Parameters
Start outbound propagationsStart outbound propagations Admin responsibilityAdmin responsibility
Workflow | Check Event Manager SetupWorkflow | Check Event Manager Setup
Click Create for all queues usedClick Create for all queues used
16© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event System Parameters
Start Outbound (cont)Start Outbound (cont) Click CreateClick Create Enter DurationEnter Duration Enter reschedule intervalEnter reschedule interval Enter latency (how long to wait Enter latency (how long to wait
after all messages queued after all messages queued before checking again)before checking again)
Must be > or = job_queue_intervalMust be > or = job_queue_interval
17© 2004 Solution Beacon, LLC. All Rights Reserved.
Schedule In-Bound Listeners
Verify Listeners for local inbound Verify Listeners for local inbound agents are scheduledagents are scheduled Do not utilize Create link in Do not utilize Create link in
Check Event Manager SetupCheck Event Manager Setup ECX_INBOUND and ECX_INBOUND and
ECX_TRANSACTION are only ECX_TRANSACTION are only required if using EDI Gatewayrequired if using EDI Gateway
18© 2004 Solution Beacon, LLC. All Rights Reserved.
Schedule In-Bound Listeners -Start Containers
Requires GSM to be configuredRequires GSM to be configured Profile option ‘Concurrent:GSM Profile option ‘Concurrent:GSM
Enables’ should be set to ‘Y’Enables’ should be set to ‘Y’ Done through OAMDone through OAM Start Workflow Agent Listener Start Workflow Agent Listener
(required)(required)
19© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers
Navigate to Workflow ManagerNavigate to Workflow Manager Click on Service ComponentsClick on Service Components
20© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers
21© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers
Verify Deferred, Deferred Notification Verify Deferred, Deferred Notification Agent, Error, and Inbound status is Agent, Error, and Inbound status is ‘Running’‘Running’
If not, click the Workflow Agent Listener If not, click the Workflow Agent Listener Service ContainerService Container
22© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers
If status is Deactivated, click radio If status is Deactivated, click radio button next to Service, ensure Start is button next to Service, ensure Start is displayed action, click Go displayed action, click Go
Starts agent listener service components Starts agent listener service components for WF_DEFERRED, WF_ERROR, for WF_DEFERRED, WF_ERROR, WF_NOTIFICATION_IN, WF_INWF_NOTIFICATION_IN, WF_IN
23© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers
If status “sticks” on Activating (doesn’t If status “sticks” on Activating (doesn’t change to Running), then something is change to Running), then something is wrong with GSM link to concurrent wrong with GSM link to concurrent managersmanagers
Until link is fixed…..Until link is fixed…..
24© 2004 Solution Beacon, LLC. All Rights Reserved.
Schedule In-Bound Listeners – GSM Not Configured Concurrent program – Workflow Agent ListenerConcurrent program – Workflow Agent Listener
If doesn’t show in Run Requests window, If doesn’t show in Run Requests window, check program definition, may not be check program definition, may not be enabledenabled
Run a program for each queueRun a program for each queue Schedule to rerun periodicallySchedule to rerun periodically
25© 2004 Solution Beacon, LLC. All Rights Reserved.
Schedule In-Bound Listeners
Minimum listeners that must be Minimum listeners that must be scheduledscheduled WF_INWF_IN WF_DEFERREDWF_DEFERRED WF_NOTIFICATION_INWF_NOTIFICATION_IN WF_ERRORWF_ERROR
Can create Program SetCan create Program Set WF_REPLAY_IN was accidentally WF_REPLAY_IN was accidentally
required with initial 11.5.9required with initial 11.5.9
26© 2004 Solution Beacon, LLC. All Rights Reserved.
Synchronize License Statuses
Concurrent program: Synchronize Concurrent program: Synchronize Product License and Workflow BES Product License and Workflow BES LicenseLicense
Will have to be added to Request Will have to be added to Request GroupGroup
27© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Queue Cleanup Scheduled
From Concurrent Manager, verify From Concurrent Manager, verify ‘Workflow Control Cleanup’ is ‘Workflow Control Cleanup’ is scheduledscheduled
Oracle recommends every 12 Oracle recommends every 12 hourshours
28© 2004 Solution Beacon, LLC. All Rights Reserved.
Revisit System Status
Global Preferences pageGlobal Preferences page Enabled – Internal / External EventsEnabled – Internal / External Events Local Only– Internal OnlyLocal Only– Internal Only External Only – do not use this valueExternal Only – do not use this value Disabled – do not use this valueDisabled – do not use this value
29© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
Workflow Agent Ping/AcknowledgeWorkflow Agent Ping/Acknowledge Sends ping event message to each Sends ping event message to each
inbound agent on local systeminbound agent on local system Waits to receive acknowledgement Waits to receive acknowledgement
event message from each agentevent message from each agent If this workflow completes If this workflow completes
successfully, Business Event System successfully, Business Event System setup is validsetup is valid
30© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
Event Queue SummaryEvent Queue Summary Note Current Count for Inbound queuesNote Current Count for Inbound queues
31© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
Launch ProcessLaunch Process Click on Workflow Agent Ping/AcknowledgeClick on Workflow Agent Ping/Acknowledge
32© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
Make up a Item Make up a Item Key (must be Key (must be unique)unique)
Select Master Select Master Ping Process in Ping Process in Process NameProcess Name
Click OKClick OK
33© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
Starts One Master and 3 DetailsStarts One Master and 3 Details Detail for each IN queue except ERRORDetail for each IN queue except ERROR
34© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
Return to Event Queue SummaryReturn to Event Queue Summary Click on Flashlight beside any queue Click on Flashlight beside any queue
where count is higher (except Out)where count is higher (except Out) Click GoClick Go
35© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
There should be one message in IN, one in There should be one message in IN, one in DeferredDeferred
Check if count increased for Replay, if so, use Check if count increased for Replay, if so, use concurrent manager program to start itconcurrent manager program to start it Messages will stay in queue until next time Messages will stay in queue until next time
concurrent process runs for that queue, then concurrent process runs for that queue, then message will go to Replay queue and stay message will go to Replay queue and stay there until Replay concurrent process runsthere until Replay concurrent process runs
36© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works
As each message is either “consumed” (or As each message is either “consumed” (or transferred to Replay queue), detail process transferred to Replay queue), detail process for that queue completesfor that queue completes If Replay queue is being used, master If Replay queue is being used, master
process won’t complete until all messages process won’t complete until all messages have made it through the replay queuehave made it through the replay queue
37© 2004 Solution Beacon, LLC. All Rights Reserved.
Questions and Answers
KISS
Keep It Simple and Supportablesm
Thank You!
Karen [email protected] www.solutionbeacon.com