Previous  Next          Contents  Index  Navigation  Glossary  Library

Defining Request Sets

By defining request sets, you can submit the same set of requests regularly using a single transaction. You use the Request Set window to create and edit request sets. Alternatively, you can use the Request Set wizard to create simple request sets. Refer to the user's guide for your Oracle Applications product to learn how to access the Request Set window.

Attention: Some Oracle Applications products do not allow you to create request sets. These products do not have the Request Set window available.

Organizing Requests with Stages

Request sets are divided into one or more "stages" which are linked to determine the sequence in which your requests are run. Each stage consists of one or more requests that you want to run in parallel (at the same time in any order). For example, in the simplest request set structure, all requests are assigned to one stage. This allows all of the requests to run in parallel.

To run requests in sequence, you assign requests to different stages, and then link the stages in the order you want the requests to run.

The concurrent manager allows only one stage in a request set to run at a time. When one stage is complete the following stage is submitted. A stage is not considered to be complete until all of the requests in the stage are complete. One advantage of using stages is the ability to run several requests in parallel and then move sequentially to the next stage. This allows for a more versatile and efficient request set.

Using Stage Status

Like request sets and concurrent requests, stages can complete with different statuses. Each stage can complete with a status of Success, Warning, or Error. You can use these completion statuses to structure your request set, by defining which stage will follow the current stage based on its completion status. For example, the request set in Figure 1 - 59 always begins with Stage 1. If Stage 1 were to complete with the status Warning, then the Warning link would be followed, and Stage 3 would be submitted. After Stage 3 completes, the set ends, since there are no links that may be followed.

Figure 1 - 59.

In this example, the "Standard" function calculates the status for a stage using the statuses of the requests within the stage. The Standard function sets the stage status to Success if all of the requests in a stage complete with a status of Success. If one or more requests complete with a status of Error, then the status of the stage is Error. For a stage's status to be Warning, one or more of the requests must have a status of Warning and no request may have a status of Error.

Linking of Stages

There are no restrictions on linking stages within a request set. Any stage may be linked to any other stage, including itself. Two or more links can point to the same stage. For example, Stage 1 can link to Stage 2 if the completion status of Stage 1 is Success or Warning, and link to Stage 3 if the status is Error.

Figure 1 - 60.

You determine the end of a request set by not specifying a followup stage for each completion status. You can end a request set after any stage in the request set. When any stage completes with a status that does not link to another stage, the request set ends.

You can use the linking of stages to control your request set. In previous releases you had three options: run in parallel, run sequentially, and run sequentially but abort on Error. All of these are easy to recreate using the request set wizard. You can use the Request Set Wizard button in the Request Set window to start the wizard. The wizard takes your input and creates the request set as follows:

Run in Parallel Creates one stage containing all of the requests you wish to run in parallel.
Run Sequentially Creates a separate stage containing the request or requests for each step in the sequence and link in the appropriate order.
Run Sequentially but abort on Error Sets up your sequence the same as it did for Run Sequentially, but when it links the stages, it does not enter a follow up stage as a link in the Error completion status field.

   To create a request set:

   Defining Stages

Note: If you choose this checkbox for more than one stage, the completion status of the request set will equal the completion status of the last of these stages to run within the set.

Stage Requests window

In the Stage Requests window you define which requests you want to include in the stage.

Request Parameters Window

The Request Parameters window lets you customize the parameter values of a specific request in a request set. The fields at the top of the Request Parameters window list general information about the current request set and the request for which you can customize the parameter values. The multi-row portion of the window lists the parameters for that request.

   Link Stages

  Name Success Warning Error
1 Stage-A Stage-B Stage-B  
2 Stage-B Stage-C Stage-D  
3 Stage-C      
4 Stage-D      

See Also

Using Standard Request Submission

Submitting a Request

Who Can Use a Request Set

Submitting a Request Set

         Previous  Next          Contents  Index  Navigation  Glossary  Library