This document talks about the concurrent processing in oracle applications.

It will give the step-by-step procedure of creating concurrent programs in oracle applications. All types of concurrent programs are described in detail. Concurrent programs can be scheduled to run or manually run in oracle applications. In Oracle Applications, concurrent processing simultaneously e ecutes programs running in the background with online operations to fully utili!e your hardware capacity, hence the name "Concurrent #rocessing$. %ou can write a program &called a 'concurrent program'( that runs as a concurrent process. Typically, you create concurrent programs for long)running, data)intensive tasks, such as posting a *ournal or generating a report. Concurrent Programs A concurrent program is an instance of an e ecution file, along with parameter definitions and incompatibilities. Concurrent programs use concurrent program e ecutables to locate the correct e ecution file. +everal concurrent programs may use the same e ecution file to perform their specific tasks, each having different parameter defaults and incompatibilities. Concurrent Program Executable A concurrent program e method used to e ecute Concurrent #rocessing, a standard language, a ecutable links an e ecution file or and the it with a defined concurrent program. ,nder an e ecution method may be a program written in reporting tool, or an operating system language.

An e ecution method can be a #-.+/- +tored #rocedure, an Oracle Tool such as Oracle 0eports or +/-1#lus, a spawned process, or an operating system host language. Concurrent Program Execution File A concurrent program e ecution file is an operating system file or database stored procedure which contains your application logic and can be e ecuted by either invoking it directly on the command line or by invoking a program which acts upon it. 2or e ample, you run a #ro1C program by invoking it on the command line. %ou run a +/- script by running +/-1#lus and passing the name of the +/- script without the .s3l e tension. Steps to Create a Concurrent Pro 1. Executable : The first step in creating a concurrent program in oracle applications is to create the concurrent program e ecutable. To do this, navigate to Application 4eveloper responsibility after you login to Oracle Applications. To login, you can take the help of the "Topic55 - Oracle Applications -ogin 4ocument$. To open the 6 ecutable form follow the below mentioned navigation path.

Application 4eveloper 7 Concurrent 7 6 ecutable.

Figure 1. Executable Form Navigation %ou will see the form as shown in figure 8 below.

Figure 2. Executable Form Field Description i( Executable - 6nter e ecutable name here. 6nter any user friendly name. ii( Short Name - 6nter short name for your e ecutable. This is used for mapping the e ecutable with the concurrent program. ,sually e ecutable name are of 9 characters. iii( pplication - :ive the application to which the e ecutable belongs to. 6.g. you want some program to run from oracle payables then account payables should be entered as application name. iv( Description - :ive the brief description of the e ecutable in this field. v( Execution !ethod - ;ere you need to choose the appropriate e ecution method for your e ecutable. 2ollowing are the possible e ecution methods which are commonly used in oracle applications. "racle #eports ) used for the 042 reports $ost ) used for shell scripts, basically the language of the host operating system P%&S'% Stored procedure ) used to run the stored procedure through oracle applications

 S'%(%oader ) used to run the s3l loader programs S'%(Plus - used to run the anonymous #-.+/- blocks. It will get e ecuted in the same fashion as you are running on +/- #lus. )ava Stored Procedure ) The e ecution file is a <ava stored procedure. )ava Concurrent Program ) ,sed for program written in <ava. Spa*ned ) used for c or pro1c #rogram. =ainly used by standard oracle interfaces. Perl Concurrent Program ) used for programs written in C:I #erl. #e+uest Set Stage Function ) #-.+/- stored function that can be used to calculate the completion statuses of re3uest set stages. ,mmediate ) e ecution file is a program written to run as subroutine of the concurrent manager. Oracle doesn$t recommend use of this e ecutable type. !ulti-%anguage .unction ) e ecution file is an =-+ function that supports running concurrent program in multiple languages. #-.+/- +tored #rocedure, Oracle 0eports, ;ost, +/-1loader, +/-1#lus are the most commonly used e ecutable types. vi( Executable File name ) This should contain the name of the e ecutable file. In case of #-.+/- +tored procedure or <ava +tored #rocedure it should be the fully defined name of the stored procedure. vii( Subroutine Name ) This field is only used when e ecutable type is spawned or immediate. viii( Execution File Path i ( /he Stage Function Parameters button opens a window that allows you to enter parameters for the 0e3uest +et +tage 2unction. This button is only enabled when you select 0e3uest +et +tage 2unction as your 6 ecution =ethod. 2. Concurrent Program : Once you have defined the e ecutable, the second step is to define the concurrent program. To define a concurrent program, you need to open the form using the navigation path below. >avigation ) Application 4eveloper -? Concurrent -?#rogram

Figure 0. Concurrent Program Form Navigation The form would look like as shown in the figure @ below.

Figure 0. Concurrent Program Form Field Description i( Program ) :ive user friendly name for your concurrent program. This name will be displayed in 0e3uests submission screen while submitting the re3uests. ii( Short Name ) :ive short name for concurrent program. This is used within the database tables in oracle applications. It$s a common practice to have the +hort name same for the e ecutable and the concurrent program. iii( pplication ) :ive the application to which the concurrent program belongs to. 6.g you want some program to run from oracle payables then account payables should be entered as application name. iv( Description - :ive the brief description of the concurrent program. v( Executable - 6nter the short name of the e ecutable &4efined in 6 ecutables +creen( you want to attach to this concurrent program. vi( !ethod - will be defaulted once you enter e ecutable short name vii( "ptions - will be defaulted once you enter e ecutable short name

>ormally default values are given for the other fields. 2ollowing is the significance of these fields. viii( #e+uest /1pe ) Concurrent program can be associated to a predefined re3uest type so that only few concurrent managers can run the program. i ( ,ncrementor ) To be used by Oracle only. ( !%S Function - This feature allows the program to be submitted once by the user but runs it in the multiple languages. i( 2se ,n S#S ) Only when this check bo is checked the Concurrent #rogram would be available in +tandard 0e3uest +ubmission &+0+( through the re3uest group. ii( llo* Disable 3alue ) This will allow the disabled values in the value sets to be used while entering the values of the parameters in the Concurrent #rogram. iii( #un lone ) Indicates that program is incompatible with all other concurrent programs and should be run alone. iv( Enable /race ) This will enable the +/- trace for the concurrent program and will generate the trace file when concurrent program is run. Only used in development environments to check the performance of the concurrent program. v( #estart on s1stem Failure ) This option is used to indicate that concurrent program should automatically be started when concurrent manager is restored after the system failure. vi( N%S Compliant ) This bo is checked if the program allows for a user to submit re3uest of the program that will reflect a language and territory that are different from the language and territory that the users are operating in. vii( "utput Format ) 2ormat in which output should be printed. #ossible format values are ;T= #42 T6AT #+ &#ost +cript( #C-&;#$s #rinter Control -anguage( viii( S 3E ) Check to indicate that output should be automatically saved in an operating system file. i ( P#,N/ ) Bhether you want the output to be sent to printer for printing. ( Column & #o*s ) Column and 0ow length of the concurrent program output. Oracle Applications uses this information to decide the print

style. i( St1le #e+uired ) #rint +tyle ii( Printer ) A particular printer on which output should be sent. +ave the data that you have entered using CtrlC+ or 2ile 7 +ave. 4. Concurrent Program Parameters : The Drd step in defining concurrent program is to define the parameters. To do this, click on the #arameters button as shown at the bottom the form in figure @. The following screen &figure E( is displayed when you click on parameters button. This screen is used to define the parameters in the concurrent program.

Figure 5. Parameter 6indo* Field Description

i( Program ) will be defaulted from Concurrent #rogram ii( pplication ) will be defaulted from Concurrent #rogram

iii( Con.licts Domain - 6nter the parameter which will hold the value of the conflict domain of the program. iv( Securit1 7roup - This field is for ;0=+ security only. v( Se+ ) 6nter se3uence number for the parameter vi( Parameter ) name of the parameter, will be displayed in parameter entry screen vii( Description ) description about the usage of the parameter viii( Enabled ) check bo to enable or disable the parameter. 4isable a parameter when you don$t want to use it. i ( 3alue set ) enter the name of the value set which you want to use to validate the value enter in the parameter field. ( Description ) will be defaulted from value set definition i( De.ault /1pe ) choose the default type for the default value of the parameter. #ossible default types are Constant : The default value can be any literal value. Pro.ile : The default value is the current value in the user profile option defined in the 4efault Falue field. ,se the profile option name, not the end)user name. %ou do not need to include G#0O2I-6G. S'% Statement : The default value is determined by the +/statement you defined in the 4efault Falue field. Segment : The default value is the value entered in a prior segment of the same parameter window. ii( Displa1 si8e ) 6nter the field length in characters for this parameter. The user sees and fills in the field in the #arameters window of the +ubmit 0e3uests window. iii( /o9en - 2or a parameter in an Oracle 0eports program, the keyword or parameter appears here. The value is case insensitive. 2or other types of programs, you can skip this field. 0. ,ncompatible Programs 6indo* : To navigate to this form, click on the Incompatibilities button on the bottom of the form shown in figure @. This window is used for defining the incompatibilities of the concurrent program. Identify concurrent programs that should not run with your concurrent program as they might interfere with its e ecution.

Figure :. ,ncompatibilities Form Field Description i( Program ) 4efaulted from Concurrent #rograms Bindow ii( pplication ) 4efaulted from Concurrent #rograms Bindow

iii( pplication ) Application of the concurrent program which is incompatible to the defined concurrent program. iv( Name ) >ame of the concurrent program which is incompatible to the defined concurrent program. v( Scope ) ,sed to identify if concurrent program is incompatible if the program or also with its child re3uests. vi( /1pe - 6nter 4omain or :lobal. If you choose 4omain, the incompatibility is resolved at a domain-specific level. If you choose :lobal, then this concurrent program will be considered globally

incompatible with your concurrent program, regardless of which domain it is running in. 5. Session Control : To navigate to this form, click on the +ession Control button on the bottom of the form shown in figure @. This is a new functionality given in 55.E.5H to control the database session while e ecuting concurrent program using following three parameters. The form would look like as shown in figure I.

Figure ;. Session Control Form Field Description i( Consumer 7roup ) resource consumer group of the concurrent program can be specified. A resource consumer group defines a set of users who have similar resource usage re3uirements. An overall resource plan specifies how resources are distributed among the different resource consumer groups. 0esource consumer groups and resource plans provide a

method for specifying how to partition processing resources among different users. ii( #ollbac9 Segment ) 0ollback segment specified here would be used instead of the default rollback segment. If you specify a rollback segment here, your concurrent program must use the A#Is 2>4JCO>C,006>T.A2JCO==IT and 2>4JCO>C,006>T.A2J0O--KACL to use the specified rollback segment. iii( "ptimi8er mode - Optionally specify an optimi!er mode. %ou can choose A--J0OB+, 2I0+TJ0OB+, 0ules, or Choose. %ou would specify an optimi!er mode only for a custom program that may not perform well with the default cost-based optimi!er &CKO( and needs tuning. %ou can use a different optimi!er mode until your program is tuned for CKO. :. Cop1 to 6indo* : To navigate to this form, click on the Copy To button on the bottom of the form shown in figure @. This window can be used to copy the definition of the concurrent program. :ive the program name to copy the definition.

Figure <. Cop1 /o Form Field Description

i( Program ) 6nter the program name to be copied ii( Short Name ) +hort >ame of the program to be copied iii( pplication ) Application name of the concurrent program to be copied iv( ,nclude ,ncompatible programs - Check this bo incompatibilities to be copied v( ,nclude Parameters ) Check this bo copied. if you want

if you want parameters to be