Connect JCA rules
Completing the Service tab

Field

Description

Select the name of the resource adapter data instance (Data-Admin-Connect-JCAAdapter class) that represents the resource adapter you want this connector rule to communicate with.

This field displays the Java classes listed under the Supported Interaction Specs section on the MetaData tab of the resource adapter instance you selected in the Adapter Name field. Select the one that this connector will use.

Select the mode of the interaction between this connector rule and the external Enterprise Information System (EIS):

• SYNC_SEND — The connector sends an input record but does not receive an output record.
• SYNC_SEND_RECEIVE — The connector sends an input record and receives an output record synchronously. This is the default behavior.
• SYNC_RECEIVE — The connector retrieves an output record.

Enter the number of milliseconds to wait for the external Enterprise Information System (EIS) to complete the adapter function before closing the connection and returning a timeout message.

Use this section to define any additional property/value pairs if the InteractionSpec implementation Java class requires properties in addition to the standard ones listed above.

Click the none button. Enter the name of the property in the pop-up window and click Save. Then enter a value for the property.

Note: The data type of the property can be either string or integer; the default is string. To specify that the data type is integer, use the following syntax when specifying the value of the custom property: $int: + [value of property]. For example: $int:538.

Use this field to override or add to the default values specified for the ConnectionSpec properties of the resource adapter data instance specified in the Adapter Name field.

Select a property of mode Value Group. Then, in the activity that calls this connector rule, set the values for the ConnectionSpec properties into this property before the activity step that calls the connector.

Specify how the Pega Platform obtains a connection for the connector rule request:

• Always create new connection — obtain a new connection from the resource adapter ConnectionFactory, which maintains a connection pool.
• Create new connection if one does not exist — attempt to obtain a connection from the property specified as the Connection Handle Property in the next field. If a reference to the connection is not cached in the property, get one from the resource adapter ConnectionFactory.
• Always re-use old connection — obtain a connection from the reference in the property specified as the Connection Handle Property. If this property contains no connection information, display an exception message.

Optional. Select a property of mode Java Object to hold on the clipboard a reference to a connection object when the request is finished. This field is required if you specify Store connection handle in the Finalize field and specify Always re-use old connection in the Initialize field.

Specify what to do with a connection when the connector rule request has finished:

• Always close connection — returns the connection object to the resource adapter's connection pool.
• Store connection handle — keeps the connection and stores a reference to the connection object in the property specified in the Connection Handle Property field.

Optional. Identify a Single Value property that can hold a status value returned by the connector. The literal value Good identifies success. You can use the standard property @baseclass.pyStatusValue.

Optional. Identify a Single Value property that can receive a text error message returned by the connector. You can use the standard property @baseclass.pyStatusMessage.

Optional. Identify a flow rule that is to be started when this connector rule is started by a flow rule but fails. The default flow rule Work-.ConnectionProblem provides one approach for handling such problems. See Handling connector exceptions.