WorkflowBESetup

8/7/2019 WorkflowBESetup

http://slidepdf.com/reader/full/workflowbesetup 1/37

© 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


About the Trainer

nn 25+ yrs experience in IT Industry25+ yrs experience in IT Industry

nn 12+ yrs experience Oracle Applications12+ yrs experience Oracle Applications

nn 5 yrs experience Workflow5 yrs experience Workflow

nn OAUG Board of Directors 11 years, Former PresidentOAUG Board of Directors 11 years, Former President

nn

Presenter of Training/ Presentations multiple clients,Presenter of Training/ Presentations multiple clients,conferencesconferences

nn Solution BeaconSolution Beacon is a leading provider of expert-levelresources to Government Agencies and Fortune 1000 companiesspecializing in the Oracle Applications marketplace, providingleading expertise in the following areas:

u Release 11i Upgrades/Implementationsu Oracle Apps Database Administration

u Oracle Systems Architecture

u Oracle Performance Tuning

u Oracle Workflow



3


Steps to Set up Business EventSystem

nn OptionalOptional –– Establish database links toEstablish database links to

external systemsexternal systems

uuOptionalOptional –– Enable Oracle MessageEnable Oracle MessageBroker queuesBroker queues

nn OptionalOptional –– Set up custom queuesSet up custom queues

nn RequiredRequired –– Check Business Event setupCheck Business Event setupparametersparameters



4


Steps to Set up Business EventSystem

nn RequiredRequired –– Schedule listeners for localSchedule listeners for localinbound agentsinbound agents

nn

RequiredRequired –– Schedule propagation for localSchedule propagation for localoutbound agentsoutbound agents

nn RequiredRequired –– Synchronize event andSynchronize event andsubscription license statuses with productsubscription license statuses with productlicense statuseslicense statuses

nn RequiredRequired –– Ensure WF_CONTROL queue isEnsure WF_CONTROL queue isperiodically cleaned upperiodically cleaned up

nn OptionalOptional –– change Global Preferencechange Global Preference



5


Setting up Queues

nn Each agent must have a queueEach agent must have a queue

nn Standard queues created byStandard queues created by

upgrade/installupgrade/install



6


Standard Queues/Listeners

InIn

InIn

InIn

OutOut

In /In /

OutOut

Default inbound queueDefault inbound queueWF_EVENT_TWF_EVENT_TWF_INWF_IN

Standard queue for errorStandard queue for error

handlinghandling

WF_EVENT_TWF_EVENT_TWF_ERROR WF_ERROR

Standard queue forStandard queue for

deferred subscriptiondeferred subscription

processingprocessing

WF_EVENT_TWF_EVENT_TWF_DEFERREDWF_DEFERRED

Workflow internal queueWorkflow internal queue ––

not for customer usenot for customer use

SYS.AQ$_IMS_ SYS.AQ$_IMS_

TEXT_MESSAGTEXT_MESSAGEE

WF_CONTROLWF_CONTROL

DescriptionDescriptionPayload TypePayload TypeQueue Table /Queue Table /

NameName



7


Standard Queues/Listeners

OutOut

InIn

OutOut

InIn

In /In /

OutOut

Standard outbound queueStandard outbound queue

for efor e--mail notificationsmail notifications


TEXT_MESSAGTEXT_MESSAG

EE

WF_NOTIFICA WF_NOTIFICA

TION_OUTTION_OUT

Standard inbound queue forStandard inbound queue for

ee--mail notificationmail notification

responsesresponses



EE

WF_NOTIFICA WF_NOTIFICA

TION_INTION_IN

Default outbound queue forDefault outbound queue for

JMS Text messagesJMS Text messages



EE

WF_JMS_OUTWF_JMS_OUT

Default inbound queue forDefault inbound queue for

JMS Text messagesJMS Text messages



EE

WF_JMS_INWF_JMS_IN

DescriptionDescriptionPayload TypePayload TypeQueue Table /Queue Table /

NameName



8


Standard Queues

Not currently usedNot currently usedInInWF_SMTP_0_ WF_SMTP_0_

1_QUEUE1_QUEUE

Not documentedNot documentedWF_EVENT_TWF_EVENT_TOutOutWF_REPLAY_ WF_REPLAY_

OUTOUT

Not documentedNot documentedWF_EVENT_TWF_EVENT_TInInWF_REPLAY_ WF_REPLAY_

ININ

OutOut

In / OutIn / Out

Default outboundDefault outbound

queuequeue

WF_EVENT_TWF_EVENT_TWF_OUTWF_OUT

DescriptionDescriptionPayload TypePayload TypeQueue TableQueue Table

/ Name/ Name



9


Standard Queues

nn Default retention for consumedDefault retention for consumed

messagesmessages –– 7 days7 days

nn To change, DBMS_AQADM.Alter_QueueTo change, DBMS_AQADM.Alter_Queueprocedureprocedure

nn DO NOT change any other parametersDO NOT change any other parameters

for these queuesfor these queues



10


Enabling OMB queues

nn Only Required for Oracle8Only Required for Oracle8ii databasedatabase

nn Set up WF_OMB_IN and WF_OMB_OUTSet up WF_OMB_IN and WF_OMB_OUT

queuesqueuesuu Translates between standard workflowTranslates between standard workflow

event msg structure, WF_EVENT_T, andevent msg structure, WF_EVENT_T, andstructure required by OMB,structure required by OMB,OMBAQ_TEXT_MSG.OMBAQ_TEXT_MSG.

nn Assign WF_EVENT_OMB_QH as propagationAssign WF_EVENT_OMB_QH as propagationprotocolprotocol



11


Enabling OMB queues

nn Run wfquhndos.sql to create PL/SQLRun wfquhndos.sql to create PL/SQL

specspec

nn Run wfquhndob.sql to create PL/SQLRun wfquhndob.sql to create PL/SQLbodybody

nn Both located in $APPL_TOP/wf/sqlBoth located in $APPL_TOP/wf/sql



12


Check Business Event SetupParameters

nn AdminAdmin

responsibilityresponsibility

nn Workflow |Workflow |Check EventCheck Event

Manager SetupManager Setup



13


Check Business Event SystemParameters

nn Verify Database Init.ora Parameters are equal orVerify Database Init.ora Parameters are equal or

greater than recommended levelsgreater than recommended levels

uu Aq_tm_processesAq_tm_processes –– monitors delay events such asmonitors delay events such as

Wait activityWait activity

uu Job_Queue_ProcessesJob_Queue_Processes –– handles propagation of handles propagation of

Business Event System event messagesBusiness Event System event messages

uu Job_Queue_Interval (8i only)Job_Queue_Interval (8i only) –– how frequentlyhow frequently

job_Queue_process wakes upjob_Queue_process wakes upnn Change values through init.ora file or ALTER SYSTEMChange values through init.ora file or ALTER SYSTEM

statement (9i)statement (9i)



14



nn Verify queues are created for standardVerify queues are created for standard

queues (Queue Name and Queuequeues (Queue Name and Queue

Created columns in Local AgentsCreated columns in Local Agentssection)section)

nn Do not use Create Link to Schedule InDo not use Create Link to Schedule In--

bound Listenersbound Listenersnn If Link says Edit, press Edit, click DeleteIf Link says Edit, press Edit, click Delete



15



nn Start outbound propagationsStart outbound propagations

uu Admin responsibilityAdmin responsibility

tt Workflow | Check Event Manager SetupWorkflow | Check Event Manager Setup

uu Click Create for all queues usedClick Create for all queues used



16



nn Start Outbound (cont)Start Outbound (cont)

uuClick CreateClick Create

uuEnter DurationEnter DurationuuEnter reschedule intervalEnter reschedule interval

uuEnter latency (how long to wait afterEnter latency (how long to wait after

all messages queued before checkingall messages queued before checkingagain)again)tt Must be > or = job_queue_intervalMust be > or = job_queue_interval



17


Schedule In-Bound Listeners

nn Verify Listeners for local inbound agentsVerify Listeners for local inbound agents

are scheduledare scheduled

uuDo not utilize Create link in Check Do not utilize Create link in Check Event Manager SetupEvent Manager Setup

uuECX_INBOUND andECX_INBOUND and

ECX_TRANSACTION are only requiredECX_TRANSACTION are only requiredif using EDI Gatewayif using EDI Gateway



18


Schedule In-Bound Listeners -Start Containers

nn Requires GSM to be configuredRequires GSM to be configured

nn Profile option ‘Concurrent:GSM Enables’ Profile option ‘Concurrent:GSM Enables’

should be set to ‘Y’ should be set to ‘Y’

nn Done through OAMDone through OAM

nn Start Workflow Agent ListenerStart Workflow Agent Listener

(required)(required)



19


Start Containers

nn Navigate to Workflow ManagerNavigate to Workflow Manager

nn Click on Service ComponentsClick on Service Components



20


Start Containers



21


Start Containers

nn Verify Deferred, Deferred Notification Agent,Verify Deferred, Deferred Notification Agent,

Error, and Inbound status is ‘Running’ Error, and Inbound status is ‘Running’

nn If not, click the Workflow Agent ListenerIf not, click the Workflow Agent ListenerService ContainerService Container



22


Start Containers

nn If status is Deactivated, click radio buttonIf status is Deactivated, click radio buttonnext to Service, ensure Start is displayednext to Service, ensure Start is displayedaction, click Goaction, click Go

nn Starts agent listener service components forStarts agent listener service components forWF_DEFERRED, WF_ERROR,WF_DEFERRED, WF_ERROR,WF_NOTIFICATION_IN, WF_INWF_NOTIFICATION_IN, WF_IN



23


Start Containers

nn If status “sticks” on Activating (doesn’tIf status “sticks” on Activating (doesn’t

change to Running), then something is wrongchange to Running), then something is wrong

with GSM link to concurrent managerswith GSM link to concurrent managersnn Until link is fixed…..Until link is fixed…..



24


Schedule In-Bound Listeners –GSM Not Configured

nn Concurrent programConcurrent program –– Workflow Agent ListenerWorkflow Agent Listener

uu If doesn’t show in Run Requests window, check If doesn’t show in Run Requests window, check

program definition, may not be enabledprogram definition, may not be enabled

uu Run a program for each queueRun a program for each queue

uu Schedule to rerun periodicallySchedule to rerun periodically



25


Schedule In-Bound Listeners

nn Minimum listeners that must be scheduledMinimum listeners that must be scheduled

uu WF_INWF_IN

uu WF_DEFERREDWF_DEFERREDuu WF_NOTIFICATION_INWF_NOTIFICATION_IN

uu WF_ERROR WF_ERROR

nn

Can create Program SetCan create Program Set

nn WF_REPLAY_IN was accidentally requiredWF_REPLAY_IN was accidentally required

with initial 11.5.9with initial 11.5.9



26


Synchronize License Statuses

nn Concurrent program: SynchronizeConcurrent program: Synchronize

Product License and Workflow BESProduct License and Workflow BES

LicenseLicensenn Will have to be added to Request GroupWill have to be added to Request Group



27


Verify Queue CleanupScheduled

nn From Concurrent Manager, verifyFrom Concurrent Manager, verify

‘Workflow Control Cleanup’ is scheduled‘Workflow Control Cleanup’ is scheduled

nn Oracle recommends every 12 hoursOracle recommends every 12 hours



28


Revisit System Status

nn Global Preferences pageGlobal Preferences page

uuEnabledEnabled –– Internal / External EventsInternal / External Events

uu Local OnlyLocal Only–– Internal OnlyInternal Only

uuExternal OnlyExternal Only –– do not use this valuedo not use this value

uuDisabledDisabled –– do not use this valuedo not use this value



29


Verify Event System Works

nn Workflow Agent Ping/AcknowledgeWorkflow Agent Ping/Acknowledge

uuSends ping event message to eachSends ping event message to each

inbound agent on local systeminbound agent on local system

uuWaits to receive acknowledgementWaits to receive acknowledgement

event message from each agentevent message from each agent

nn If this workflow completes successfully,If this workflow completes successfully,Business Event System setup is validBusiness Event System setup is valid



30



nn Event Queue SummaryEvent Queue Summary

nn Note Current Count for Inbound queuesNote Current Count for Inbound queues



31



nn Launch ProcessLaunch Process

nn Click on Workflow Agent Ping/AcknowledgeClick on Workflow Agent Ping/Acknowledge



32



nn Make up a Item KeyMake up a Item Key

(must be unique)(must be unique)

nn Select Master PingSelect Master PingProcess in ProcessProcess in Process

NameName

nn Click OK Click OK



33



nn Starts One Master and 3 DetailsStarts One Master and 3 Details

uu Detail for each IN queue except ERROR Detail for each IN queue except ERROR



34



nn Return to Event Queue SummaryReturn to Event Queue Summary

nn Click on Flashlight beside any queue whereClick on Flashlight beside any queue wherecount is higher (except Out)count is higher (except Out)

nn Click GoClick Go



35



nn There should be one message in IN, one in DeferredThere should be one message in IN, one in Deferred

nn Check if count increased for Replay, if so, useCheck if count increased for Replay, if so, useconcurrent manager program to start itconcurrent manager program to start it

uu Messages will stay in queue until next timeMessages will stay in queue until next timeconcurrent process runs for that queue, thenconcurrent process runs for that queue, thenmessage will go to Replay queue and stay theremessage will go to Replay queue and stay thereuntil Replay concurrent process runsuntil Replay concurrent process runs



36



nn As each message is either “consumed” (orAs each message is either “consumed” (ortransferred to Replay queue), detail processtransferred to Replay queue), detail processfor that queue completesfor that queue completes

uu If Replay queue is being used, masterIf Replay queue is being used, masterprocess won’t complete until all messagesprocess won’t complete until all messageshave 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

WorkflowBESetup

Documents