Configuring the connector

The iSeries adapter uses standard connector properties for configuration as detailed in the next section and connector-specific properties as detailed in the following section.

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.

You must set at least the following standard connector configuration properties before running the connector.

Connector-specific properties

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

Table 3 lists the connector-specific configuration properties for the connector. See the section that follows for explanations of the properties.

Table 3. Connector-specific configuration properties

Name Possible values Default value Required?
ApplicationName iSeriesAdapter None Yes
UseDefaults default value None Yes
MessageFileName BIA_iSeriesAdapter.txt BIA_iSeriesAdapter.txt No

ApplicationName

This is a unique name that must be specified for each connector.

UseDefaults

Typically, some of the input parameters to a program would be constant. So these attributes can be designed to have default values. If there is no default value and the UseDefaults property is set to true, the adapter errors out and throws a VerbProcessingFailedException. If UseDefaults is not set or set to false, and there are no default values, the adapter builds a String of length MaxLength with padded spaces for the attribute values.

MessageFileName

This is the name and path of the error message file if it is not located in the standard message location %CROSSWORLDS%\ connectors\messages. If the message file name is not in a fully qualified path, the message file is assumed to be located in the directory specified by the HOME environment variable or the startup parameter user.home. If a connector message file does not exist, the file BIA_iSeriesAdapter.txt is used as the message file.

Copyright IBM Corp. 1997, 2003