Oracle (Plumtree)

To create an Oracle (Plumtree) SQL database service end point:

1. In the left pane of Process Administrator, select Service Endpoint.

2. On the Service Endpoints page, click Add.

3. On the Service Endpoints | Add Service Endpoint page, enter a Name for the service endpoint.

4. In the Type drop-down list, choose SQL Database.

5. In the Subtype drop-down list, choose Oracle (Plumtree).

6. Click Next.

7. On the Service Endpoints | Add Service Endpoint | Edit Service Endpoint endpoint name page, enter the enter the Properties for the SQL database service endpoint.

The Oracle (Plumtree) service endpoint properties are:

1. Host - The name of the host computer or server on which Oracle SQL resides and on which the database will be created.

2. Port - The database will use this port on the host.

3. SID - System identification for the database; also used to connect to the database. Sometimes called Oracle ID.

4. User - A user name that will be created when the database is created.

Note: Once this user name has been defined in the Process Administrator, the name cannot be changed. If a new administrative user name is necessary, create a new service endpoint that uses the new user name.

5. Password - A password that will be created for the user when the database is created.

6. Schema - This is an optional property. If the name of a schema is entered, the configuration and introspection will only work on tables of that schema. If a schema name is not entered, the schema could be changed at runtime. For example, if a table named devel.invoice is referenced in a development environment and in production a different schema name is used, production references to devel.invoice would work only if the  schema name was not entered in this field.

7. Database String - If this option is selected, the database connection information can be entered in the form of a URL. Complete the host, port, SID, user, and schema (schema is optional) fields. Then select the database string checkbox. In the database string field, enter the URL in the format jdbc:datadirect://host name:port number;SID. Enter and confirm a password for the user that will be created when the database is created.

The Oracle (Plumtree) service endpoint Advanced properties are optional:

1. Tablespace - Some database administrators divide databases into tablespaces to control and maintain table sizes. Enter the appropriate tablespace name here. Leave the field blank if there are no tablespaces and a default tablespace will be created. When the user name is created, the user creation statement references the tablespace.

2. Temporary Tablespace - The name of the temporary tablespace used by the process execution engine's database to perform temporary indexing for some access: TEMP of type TEMPORARY.

3. Profile - A profile is a set of limits on database resources. If you assign the profile to the user being created, that user cannot exceed the established limits in the profile. This allows the administrator to limit the actions of a particular Oracle user. The Oracle administrator may have different profiles set for different groups of users so that there is control over what each group is authorized to use and over which resources from the database a particular group will have.

8. On the Service Endpoints | Add Service Endpoint | Edit Service Endpoint endpoint name page, configure the following Runtime options for the SQL database service endpoint or accept the defaults:

1. Maximum Pool Size - Enter the maximum number of connections that the pool can allocate. The pool will never create more connections than this limit imposes. The default is 10.

2. Connection Idle Time (Mins) - Enter the amount of time the database connection can remain idle before the connection will be dropped. The default is 5 minutes.

3. Maximum Opened Cursors - Enter the maximum number of opened cursors allowed on the database. The default is 50. This value is related to the maximum pool size. The number of cursors is divided in between the number of maximum pool size and each connection will manage that number of cursors. For example, if you have 500 maximum opened cursors and the maximum pool size is 50, each connection can have a maximum of 10 opened cursors.

9. Click Save.