oracle applications release 11 i release 11.5.9 workflow

© 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


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


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


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


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


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


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


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


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


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


Check Business Event Setup Parameters

Admin Admin responsibilityresponsibility

Workflow | Workflow | Check Event Check Event Manager SetupManager Setup


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)



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



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



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


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


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)


Start Containers

Navigate to Workflow ManagerNavigate to Workflow Manager Click on Service ComponentsClick on Service Components


Start Containers


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


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


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…..


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


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


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


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


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


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



Event Queue SummaryEvent Queue Summary Note Current Count for Inbound queuesNote Current Count for Inbound queues



Launch ProcessLaunch Process Click on Workflow Agent Ping/AcknowledgeClick on Workflow Agent Ping/Acknowledge



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



Starts One Master and 3 DetailsStarts One Master and 3 Details Detail for each IN queue except ERRORDetail for each IN queue except ERROR



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



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



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


Questions and Answers

KISS

Keep It Simple and Supportablesm

Thank You!

Karen [email protected] www.solutionbeacon.com

oracle applications release 11 i release 11.5.9 workflow

Documents