Configuring the connector

Connectors have two types of configuration properties: standard configuration properties and connector-specific configuration properties. You must set the values of these properties before running the connector.

A connector obtains its configuration values at startup. During a run-time session, you might want to change the values of one or more connector properties. Changes to some connector configuration properties, such as AgentTraceLevel, take effect immediately. Changes to other connector properties require component restart or system restart after a change. To determine whether a property is dynamic (taking effect immediately) or static (requiring either connector component restart or system restart), refer to your integration broker's administration utility. For instance, if you are using ICS, see the Update Method column in the Connector Properties window of the System Manager.

Standard connector properties

Standard configuration properties provide information that all connectors use. See Appendix A, Standard Configuration Properties for Connectors for documentation of these properties.

Important:
Because this connector supports all integration brokers, configuration properties for all brokers are relevant to it.
Note:
Because this connector is single-threaded, it cannot take advantage of the AgentConnections property.

Connector-specific properties

Connector-specific configuration properties provide information needed by the connector at run time. Connector-specific properties also provide a way of changing static information or logic within the connector without having to recode and rebuild the connector.

Table 4 lists the connector-specific configuration properties for the connector. See the sections that follow for explanations of the properties.

Table 4. Connector-specific configuration properties

Name Possible values Default value
ApplicationPassword
PS
ApplicationUserName
PS
AppServerMachineNameOrIP

ConnectErrors
Unable to connect to destination:ORACLE not available:TNS:listener failed:Could not connect to application server:Database access is not allowed:Failed to establish MsgAPI service context for operator
disableCrossReferencing True/False Enables or disables cross referencing. The default is false, cross referencing is enabled.
PollQuantitiy 1 to 500 (maximum) 25
PortNumber
7000
PeopleToolsVersion
7.57
Priority 0-n 0
UseDefaults
false

ApplicationPassword

The Password for the connector's user account.

ApplicationUserName

The Name of the connector's user account. ApplicationUserName is the OperatorID in PeopleSoft.

AppServerMachineNameOrIP

The Machine name or IP address of the machine name.

ConnectErrors

The List of strings that cause the connector to terminate when the connection to the PeopleSoft application or database is lost. These strings are written to the connector log when the connection is lost. Additional strings can be specified; separate strings with colon (:) delimiters.

disableCrossReferencing

Turns cross referencing on and off. The default value is False, cross-referencing is enabled.

PollQuantitiy

The number of events in the database table that the connector retrieves per polling interval.

PortNumber

The Port number for Message Agent requests.

PeopleToolsVersion

The version of PeopleTools, for example, 7.52.

Priority

The priority level from 0-n, with 0 being the highest level. At each poll interval, the connector picks up events starting with the highest priority events and continuing with lower priority events until the number of events specified in the PollQuantity configuration property is met, or until there are no events in the event table. The connector currently does not decrement priority.

UseDefaults

On a Create operation, if UseDefaults is set to true or not set, the connector checks whether a valid value or a default value is provided for each isRequired business object attribute. If a value is provided, the Create succeeds; otherwise, it fails. If the parameter is set to false, the connector checks only for valid values; the Create operation fails if valid values are not provided.

Copyright IBM Corp. 1997, 2003