Managing Application Properties

You can configure Oracle Enterprise Scheduler interaction with applications by setting application properties. On the Application Properties page in Fusion Middleware Control, you can set values for properties that are defined by Oracle Enterprise Scheduler or properties specified for the application in its deployed configuration.

Oracle Enterprise Scheduler defines the following properties that you configure on the Application Properties page:

RequestFileDirectory: Specifies the directory for request and log output. The default is "{ESS_ENV:jrfServerLogPath}/ess_request/".
RequestFileDirectoryShared: Specifies a flag indicating whether the request file directory is shared. The default is "false".
PerlCommand: By default, Oracle Enterprise Scheduler uses the Java agent handler for requests in standard and extended mode. It always uses the Perl agent handler for requests in Fusion mode. To use the Perl agent handler in standard and extended request modes, you must add the PerlCommand property to the ess-config.xml file associated with the hosting application running the process job as shown in the following example.
```
<EssProperties>
   <EssProperty key="RequestFileDirectory" value="/tmp/ess/requestFileDirectory"/>
   <EssProperty key="RequestFileDirectoryShared" value="false"/>
     ...   
   <EssProperty key="PerlCommand" value="/usr/bin/perl"/>
</EssProperties>
```
You can use token substitution to specify environment dependent values like directory names.

The Oracle Enterprise Scheduler Perl agent handler requires Oracle Perl version 5.10 or later. Instructions for installing Perl to support process jobs can be found in the chapter "Configuring Perl to Support Process Jobs" in Oracle Fusion Middleware Administrator's Guide for Oracle Enterprise Scheduling Service.
EssCallbackClientSecurityPolicyURI: Specifies the security policy URI used in the WS-Security headers for web service invocations from Oracle Enterprise Scheduler for web service callbacks. The default is null.
ClusterMode: Specifies whether the server instance is in standalone or extended mode. This is a read-only and immutable property.
HostingAppPolicyStripe: An Oracle Enterprise Scheduler configuration property that is applicable only for the pre-deployed native hosting application. This property is pre-configured in the pre-deployed native hosting application to support multiple security stripes that can be leveraged by SOA and OSB applications. There is no static definition of policy stripes in the pre-deployed native hosting application's ejb-jar.xml file. The list of stripes (for additional components) can be extended dynamically using a runtime configuration MBean, Fusion Middleware Control or WLST scripts.
ServerURL: The value of this property value is a string with the following format:

http://host:port

It is used at runtime to determine the ESSWebService end point address and is published as part of the ESSWebService concrete WSDL.
CallbackServerURL: The value of this property is a string with the following format:

http://host:port

It is used at runtime to determine the end point address of Oracle Enterprise Scheduler callback web services (including EssAsyncCallbackService, and EssWsJobAsyncCallbackService). These end point addresses are published as part of the respective WSDLs.

To edit application properties:

From the navigation pane, expand the Scheduling Services folder and select the Oracle Enterprise Scheduler application.
From the Scheduling Services menu, select Configuration and then select Application Properties.

The Application Properties page displays.
In the Application dropdown field, select the application for which you want to set properties.
In the Configuration Properties section, locate the property whose value you want to change, then enter a new value in the Value column for that property.
To add a property, click the Add button.

The Add Property dialog box appears.
To delete a property, click the Delete button.
From the Type dropdown, select the new property's type.

Select ESS to choose a property defined by Oracle Enterprise Scheduler, then select the property's name from the Name dropdown. Enter the property's value in the Value text field.
Select another type to enter the name and value for another property.
Click Add to save the new property setting.
On the Application Properties page, click Apply to save application properties changes.

Job Location Properties

Oracle Enterprise Scheduler provides the means by which EJB and web service jobs can define a named abstract job location. The job location is specified by the Oracle Enterprise Scheduler SYS_logicalClusterName system property and specifies a logical cluster name (LCN). If the job definition for an EJB or web service job specifies a value for an LCN, certain environment-specific properties are specified using Oracle Enterprise Manager Fusion Middleware Control at the hosting application level rather than in the job definition. All job definitions with the same LCN share the value of the properties entered in the hosting application configuration properties using Oracle Enterprise Manager Fusion Middleware Control.

Note:

The terms "logical cluster" and "job location" can be used interchangeably.

To use the job location feature:

From the navigation pane, expand the Scheduling Services folder and select the Oracle Enterprise Scheduler application.
From the Scheduling Services menu, select Job Metadata and then select Job Definitions. Select a job definition from the Results table to open the Job Definitions Details page.
In the System Properties section, set the SYS_logicalClusterName system property to a name that you use to define the set of location related properties in the Application Properties page.
From the Scheduling Services menu, select Configuration and then select Application Properties.
Select the hosting application in the Application dropdown menu.
In the Job Location Properties section of the Applications Properties page, click the Add Job Location icon.

The Add Job Location dialog box appears.
In the Job Location field, enter the name you assigned to the SYS_logicalClusterName system property in step 3.

Fill in the values for the three fields that correspond to the properties shown in Table 3-1.

Table 3-1 Job Location Properties

Field	Property Name	Description
JNDI Provider URL	`JndiProviderUrl`	The JNDI provider for the cluster. Used with the EJB job type.
Web service endpoint base URL	`WsEndpointBaseUrl`	The host and port. Used with the web service job type.
Web service WSDL base URL	`WsWsdlBaseUrl`	The host and port of the WSDL. Used with the web service job type.

Click Add to save the new property setting.
On the Application Properties page, click Apply to save any application properties changes.

Note:

You can also delete job locations and properties by selecting them in the table and then clicking Delete Job Location or Delete Property.