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 configuration properties provide information that all connectors use. See Appendix A, Standard Configuration Properties for Connectors for documentation of these 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 |
The Password for the connector's user account.
The Name of the connector's user account. ApplicationUserName is the OperatorID in PeopleSoft.
The Machine name or IP address of the machine name.
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.
Turns cross referencing on and off. The default value is False, cross-referencing is enabled.
The number of events in the database table that the connector retrieves per polling interval.
The Port number for Message Agent requests.
The version of PeopleTools, for example, 7.52.
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.
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.