After the InterChange Server components are installed, you are prompted to
configure InterChange Server for your environment.
Use the default values or enter values specific to your environment.
In the following sections, the information below each figure provides
descriptions of the various fields in each screen.
- Important:
- Because the values in your InterChange Server configuration (or
reconfiguration) must match the values entered during database configuration,
do not select the Default, Discard, or Apply buttons until all tabs have been
updated. For more information on completing the configuration process,
see "Completing the InterChange Server configuration".
See Appendix A, Configuration parameters for specific configuration parameter information.
Figure 6. InterChange Server Configuration tab

- Server Name--This field is populated with the InterChange
Server name that was selected during the installation process.
HA |
---|
In a high-availability environment, the server name must be identical on
each machine in the cluster. |
- Log File--The file where InterChange Server messages are
logged. You can overwrite the default location
(InterchangeSystem.log file in the
IBM\WebSphereICS directory) with STDOUT (the command prompt window
in which InterChange Server starts), or you can enter a file name of your
choice.
HA |
---|
In a high-availability environment, you must put the log file on the shared
drive. |
- Locale--A locale provides the following
information for the user environment:
- Cultural conventions according to the language and country (or territory)
- Data formats:
Date--full and abbreviated names for weekdays and months, and the
structure of the date (including date separator)
Numbers--define symbols for the thousands separator and decimal point,
and where these symbols are placed within the number
Times--define indicators for 12-hour time (such a.m. and
p.m. indicators) and the structure of the time
Monetary values--define numeric and currency symbols, and where these
symbols are placed within the monetary value
- Collation order for sorting data for the particular character code set and
language.
- String handling-- case (uppercase and lowercase) comparison,
substrings, and concatenation.
- Character encoding--the mapping from a character (a letter of the
alphabet) to a numeric value in a character code set. For example, the
ASCII character code set encodes the letter A as 65, while the
EBCIDIC character set encodes this letter as 43. The character code set
contains encodings for all characters in one or more language
alphabets.
A locale name has the following format:
11_TT.codeset
where ll is a two-character language code (usually in
lower case), TT is a two-letter country and territory
code (usually in upper case), and codeset is the name of
the associated character code set. The codeset
portion of the name is often optional. The locale is typically
installed as part of the installation of the operating system.
Figure 7. WebSphere MQ configuration screen

- Host Name--The name of the machine on which MQListener
will run.
- Note:
- The Host Name, Queue Manager Name, and Channel fields are grayed out during
the initial installation because these values must match the information
contained in each connector configuration file. The connector
configuration file values are defaulted during installation. You can
change these values after initial installation by rerunning the InterChange
Server Configuration wizard. You must also update the MQSeries section
of the connector configuration files to match this information.
- Port Number--The number of the port used by
MQSeries. Default is 1414.
- Queue Manager Name--The name of the queue manager used by
the messaging software. You can use any name, though IBM recommends
that the name match the InterChange Server name, then append
queue.manager. The name must be unique in a network,
for example, ibm.queue.manager.
HA |
---|
In a high-availability environment, the host names must be the same for
each machine in the cluster. |
- Channel--The channel used by WebSphere MQ. There is
no need to change this unless you are running WebSphere MQ for another purpose
and Channel 1 is already in use. If you need multiple channels, simply
use the next sequential channel number.
Figure 8. Database configuration screen

- Database Driver--You can choose from DB2, Oracle (Type 4),
or MS SQL Server (Type 4) drivers.
- Important:
- Confirm that the database instance is cataloged before attempting to start
InterChange Server. See "Creating the repository database".
- Unlimited--Select this check box to disable the Max
Connections field and remove it from the
InterchangeSystem.cfg file.
- Max Connections--The maximum number of connections.
The default value is 50.
- Max Pools--The maximum number of connection pools.
The default value is 50.
- Idle Timeout--The idle timeout period. The default
value is 2.
- Do the following in the Event Management
pane to configure the database connectivity for the event management
service:
- If you chose MS SQL Server(Type 4), or Oracle(Type
4) in the Database Driver list, then type the name of the
computer on which the database server resides in the Host Name
field.
- Type the name of the database in the Database field.
Ensure that the database name you specify matches the database name that you
established when you created your database for use with the WebSphere business
integration system.
- Note:
- Names of DB2 databases must contain eight or fewer characters.
- Type the maximum number of connections you want InterChange Server to make
with the specific database server in the Max Connections field, or
enable the Unlimited checkbox to allow InterChange Server an
unlimited number of connections.
- Type the user name that should be used by InterChange
Server to log in to the specified database in the Login
field. Ensure that the database user name specified matches the ICS
database account name that you established when configuring your database for
use with the WebSphere business integration system.
- Type the password for the user name specified in step 4 in the Password field. Ensure that the
database user password specified matches the database password that you
established when configuring your database for use with the WebSphere business
integration system.
- If you chose MS SQL Server(Type 4), or Oracle(Type
4) in the Database Driver list, then you must type the port
number through which clients communicate with the database server in the
Port Number field. By default, the SQL Server listener port
number for TCP/IP is 1433 and for the Oracle Drivers it is 1521. Accept
the default port number. For more information, see the Microsoft SQL
Server documentation regarding port numbers and TCP/IP.
- For the Transactions pane, repeat steps 1 through 6 to
configure the database connectivity for the transaction management
service.
- For the Repository pane, repeat steps 1 through 6 to configure
the database connectivity for the repository service.
- For the Flow Monitoring pane, repeat steps 1 through 6 to
configure the database connectivity for the flow monitoring service.
TheSchema Name field corresponds to the name of the database
schema where the Flow Monitoring event table resides. Use this
configuration value if you wish to manage Flow Event data under a schema
different from that of the login user. For information on the
prerequisite software required to utilize flow monitoring, as well as detailed
explanations of flow-monitoring concepts, see the System Administration
Guide.
- Note:
- Upgrading to ICS creates the additional field Schema Name in the
Flow Monitoring pane. If a specific value for this field is not
entered, it will default to the same value used for the "Login" field.
Flow Monitoring is not supported for MS SQL Server. If you are using MS
SQL Server as your repository database, the Flow Monitoring section at the
bottom of this screen will be disabled. For information on the
prerequisite software required to utilize flow monitoring, as well as detailed
explanations of flow-monitoring concepts, see the System Administration
Guide.
Figure 9. Security configuration screen

The Security tab of the InterChange Server Configuration Wizard gives
access to the security options. The user can choose between the local
WBI repository (the default) or an LDAP directory as the location for a user
registry (a secure list of usernames and passwords for authorized
users). Do the following to configure the security options:
- Click the Security tab.
- In the User Registry list, select either Repository
(to use the local WBI repository) or LDAP (to use an LDAP
directory) for the location of the user registry.
- Note:
- If you are using an LDAP directory as your user registry, then none of the
remaining options are active. The advanced options for the LDAP option
are available through the System Manager.
- In the HostName field, type the name of the computer on which
the database server resides.
- Note:
- This field is inactive if DB2 is selected as the database driver.
- Type the name of the database in the Database field.
Ensure that the database name you specify matches the database name that you
established when creating your database for use with the WebSphere business
integration system.
- Type the user name that should be used by InterChange
Server to log in to the specified database in the Login
field. Ensure that the database user name you specify matches the ICS
database account name that you established when configuring your database for
use with the WebSphere business integration system.
- Type the password for the user name specified in step 5 in the Password field. Ensure that the
database user password you specify matches the database password that you
established when configuring your database for use with the WebSphere business
integration system.
- Type the port number through which clients communicate with the database
server in the Port Number field.
- Note:
- This field is inactive if DB2 is selected as the database driver.
- After all required values are entered in InterChange Server Configuration
screens, select one of the following options before exiting:
- Default--Places the default values for the installed platform in the
required fields.
- Discard--The Discard button is not available until an update is made
in the screen.
- Apply--Verifies that all required fields, on all tabs are populated
and updates the InterchangeSystem.cfg file with the new
values.
- Note:
- When you click any of these buttons, note that the values from all tabs are
updated. For example, if you are in the Database tab and you click
Apply, the values that are in the WebSphereMQ and InterChange Server tabs are
also verified and applied.
- Click Exit.
- Click Finish to exit the Installer wizard.
- Proceed to Configuring WebSphere MQ.
