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 configuration properties provide information that all connectors use. See Appendix A, Standard configuration properties for connectors for documentation of these properties.
You must set at least the following standard connector configuration properties before running the connector.
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 1 lists the connector-specific configuration properties for the connector. See the section that follows for explanations of the properties.
Table 1. 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 |
This is a unique name that must be specified for each connector.
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.
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.