Вы находитесь на странице: 1из 37

Oracle Applications Release 11i

Release 11.5.9 WorkFlow


Business Events – The Setups
You May Be Missing
Karen Brownfield
Kbrownfield@solutionbeacon.com

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 25+ yrs experience in IT Industry
n 12+ yrs experience Oracle Applications
n 5 yrs experience Workflow
n OAUG Board of Directors 11 years, Former President
n Presenter of Training/Presentations multiple clients,
conferences
n 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
2
© 2004 Solution Beacon, LLC. All Rights Reserved.
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

3
© 2004 Solution Beacon, LLC. All Rights Reserved.
Steps to Set up Business Event
System
n Required – Schedule listeners for local
inbound agents
n Required – Schedule propagation for local
outbound agents
n Required – Synchronize event and
subscription license statuses with product
license statuses
n Required – Ensure WF_CONTROL queue is
periodically cleaned up
n Optional – change Global Preference
4
© 2004 Solution Beacon, LLC. All Rights Reserved.
Setting up Queues

n Each agent must have a queue


n Standard queues created by
upgrade/install

5
© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues/Listeners

Queue Table / In / Payload Type Description


Name Out
WF_CONTROL Out SYS.AQ$_IMS_ Workflow internal queue –
TEXT_MESSAG not for customer use
E
WF_DEFERRED In WF_EVENT_T Standard queue for
deferred subscription
processing
WF_ERROR In WF_EVENT_T Standard queue for error
handling
WF_IN In WF_EVENT_T Default inbound queue

6
© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues/Listeners

Queue Table / In / Payload Type Description


Name Out
WF_JMS_IN In SYS.AQ$_IMS_ Default inbound queue for
TEXT_MESSAG JMS Text messages
E
WF_JMS_OUT Out SYS.AQ$_IMS_ Default outbound queue for
TEXT_MESSAG JMS Text messages
E
WF_NOTIFICA In SYS.AQ$_IMS_ Standard inbound queue for
TION_IN TEXT_MESSAG e-mail notification
E responses
WF_NOTIFICA Out SYS.AQ$_IMS_ Standard outbound queue
TION_OUT TEXT_MESSAG for e-mail notifications
E
7
© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues

Queue Table In / Out Payload Type Description


/ Name
WF_OUT Out WF_EVENT_T Default outbound
queue
WF_REPLAY_ In WF_EVENT_T Not documented
IN
WF_REPLAY_ Out WF_EVENT_T Not documented
OUT
WF_SMTP_0_ In Not currently used
1_QUEUE

8
© 2004 Solution Beacon, LLC. All Rights Reserved.
Standard Queues

n Default retention for consumed


messages – 7 days
n To change, DBMS_AQADM.Alter_Queue
procedure
n DO NOT change any other parameters
for these queues

9
© 2004 Solution Beacon, LLC. All Rights Reserved.
Enabling OMB queues

n Only Required for Oracle8i database


n Set up WF_OMB_IN and WF_OMB_OUT
queues
u Translates between standard workflow
event msg structure, WF_EVENT_T, and
structure required by OMB,
OMBAQ_TEXT_MSG.
n Assign WF_EVENT_OMB_QH as propagation
protocol

10
© 2004 Solution Beacon, LLC. All Rights Reserved.
Enabling OMB queues

n Run wfquhndos.sql to create PL/SQL


spec
n Run wfquhndob.sql to create PL/SQL
body
n Both located in $APPL_TOP/wf/sql

11
© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event Setup
Parameters

n Admin
responsibility
n Workflow |
Check Event
Manager Setup

12
© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event System
Parameters
n Verify Database Init.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
n Change values through init.ora file or ALTER SYSTEM
statement (9i)

13
© 2004 Solution Beacon, LLC. All Rights Reserved.
Check Business Event System
Parameters

n 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 In-
bound Listeners
n If Link says Edit, press Edit, click Delete

14
© 2004 Solution Beacon, LLC. All Rights Reserved.
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, LLC. All Rights Reserved.
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, 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, LLC. All Rights Reserved.
Schedule In-Bound Listeners -
Start Containers

n 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)

18
© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers

n Navigate to Workflow Manager


n Click on Service Components

19
© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers

20
© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers

n Verify Deferred, Deferred Notification Agent,


Error, and Inbound status is ‘Running’
n If not, click the Workflow Agent Listener
Service Container

21
© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers

n If status is Deactivated, click radio button


next to Service, ensure Start is displayed
action, click Go
n Starts agent listener service components for
WF_DEFERRED, WF_ERROR,
WF_NOTIFICATION_IN, WF_IN
22
© 2004 Solution Beacon, LLC. All Rights Reserved.
Start Containers

n If status “sticks” on Activating (doesn’t


change to Running), then something is wrong
with GSM link to concurrent managers
n Until link is fixed…..

23
© 2004 Solution Beacon, LLC. All Rights Reserved.
Schedule In-Bound Listeners –
GSM Not Configured
n Concurrent program – Workflow Agent Listener
u If doesn’t show in Run Requests window, check

program definition, may not be enabled


u Run a program for each queue

u Schedule to rerun periodically

24
© 2004 Solution Beacon, LLC. All Rights Reserved.
Schedule In-Bound Listeners

n Minimum listeners that must be scheduled


u WF_IN

u WF_DEFERRED

u WF_NOTIFICATION_IN

u WF_ERROR

n Can create Program Set


n WF_REPLAY_IN was accidentally required
with initial 11.5.9
25
© 2004 Solution Beacon, LLC. All Rights Reserved.
Synchronize License Statuses

n Concurrent program: Synchronize


Product License and Workflow BES
License
n Will have to be added to Request Group

26
© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Queue Cleanup
Scheduled

n From Concurrent Manager, verify


‘Workflow Control Cleanup’ is scheduled
n Oracle recommends every 12 hours

27
© 2004 Solution Beacon, LLC. All Rights Reserved.
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, LLC. 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,
Business Event System setup is valid

29
© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works

n Event Queue Summary


n Note Current Count for Inbound queues
30
© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works

n Launch Process
n Click on Workflow Agent Ping/Acknowledge

31
© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works

n Make up a Item Key


(must be unique)
n Select Master Ping
Process in Process
Name
n Click OK

32
© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works

n Starts One Master and 3 Details


u Detail for each IN queue except ERROR

33
© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works

n Return to Event Queue Summary


n Click on Flashlight beside any queue where
count is higher (except Out)
n Click Go
34
© 2004 Solution Beacon, LLC. All Rights Reserved.
Verify Event System Works

n There should be one message in IN, one in Deferred


n Check if count increased for Replay, if so, use
concurrent manager program to start it
u Messages will stay in queue until next time
concurrent process runs for that queue, then
message will go to Replay queue and stay there
until Replay concurrent process runs

35
© 2004 Solution Beacon, LLC. All Rights Reserved.
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, master
process won’t complete until all messages
have made it through the replay queue
36
© 2004 Solution Beacon, LLC. All Rights Reserved.
Questions and Answers

KISS

Keep It Simple and Supportablesm

Thank You!
Karen Brownfield
kbrownfield@solutionbeacon.com
37 www.solutionbeacon.com
© 2004 Solution Beacon, LLC. All Rights Reserved.

Вам также может понравиться