After InterChange Server components are installed, the InterChange
Server Configuration screen appears. It is at this point that you can
configure your environment for your specific needs.
The InterChange Server Configuration has the "InterChange
Server", "WebSphere MQ", "Database" and "Security"
configuration tabs. Enter values in the fields, using either the
defaults or values specific to your environment. The information below
each figure provides descriptions of the fields in each screen.
See Appendix A, InterChange Server configuration parameters for specific configuration parameter information.
The "InterChange Server" tab of the configuration wizard allows you
to change some basic properties of the server itself. Do the following
to configure the InterChange Server properties:
- Click the "InterChange Server" tab.
- Type the name of the InterChange Server instance in the Server
Name field.
- Do one of the following to set the value of the Log File
field:
- Type the value STDOUT in the field to direct InterChange Server
logging to the console.
- Type the name and path of a file in the field or click the ellipses beside
the Log File field to select a file to which InterChange Server
logging should be directed.
- Select the desired locale from the Locale list.
Figure 13 shows the "InterChange Server" tab:
Figure 13. InterChange Server configuration tab

The "WebSphere MQ" tab of the configuration wizard allows you to
change properties that specify how InterChange Server communicates with the
WebSphere MQ persistent messaging server. Do the following to configure
the WebSphere MQ properties:
- Click the WebSphere MQ tab.
- Type the name of the computer on which the WebSphere MQ server is
installed in the Host Name field.
- Type in the Port Number field the port over which WebSphere MQ
allows clients to communicate with the server.
The default port is 1414.
- Type in the Queue Manager Name field the name of the queue
manager that has been created to contain the queues on which InterChange
Server will persistently store messages for the flows it processes.
- Type in the Channel field the name of the channel over which
clients of WebSphere MQ communicate with the WebSphere MQ server. The
default value is CHANNEL1. Consult with the WebSphere MQ
administrator at the site to determine if CHANNEL1 can be used and
if not, which channel can be used.
Figure 14 shows the "WebSphere MQ" tab:
Figure 14. WebSphere MQ configuration tab

The "Database" tab of the configuration wizard allows you to change
properties that specify the databases InterChange Server uses to store
repository, event management, transaction management, and flow monitoring
data. Do the following to configure the database properties:
- Click the Database tab.
- Select the appropriate value in the Database Driver
list--either DB2, MS SQL Server(Type 4), or
Oracle(Type 4)--depending on the database vendor.
- Type the maximum number of connections you want InterChange Server to make
with the database server in the Max Connections field, or enable
the Unlimited checkbox to allow InterChange Server an unlimited
number of connections.
- Type the maximum number of pools InterChange Server should establish to
contain the database connections it caches in the Max Pools
field.
- Type the number of minutes you want a connection object to remain idle
before being returned to the database connection pool for reuse in the
Idle Timeout field.
- 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. For more information, see Installing and configuring the database server.
- 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. For more
information, see Installing and configuring the database server.
- Type the password for the user name specified in step 6d 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. For more information, see Installing and configuring the database server.
- 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. See the section Setting up ports for information on port numbers.
- Repeat step 6 in the "Transactions" pane to configure the database
connectivity for the transaction management service.
- Repeat step 6 in the "Repository" pane to configure the database
connectivity for the repository service.
- Repeat step 6 in the optional "Flow Monitoring" pane to configure
the database connectivity for the flow monitoring service.
- Note:
- Flow monitoring is not supported with the MS SQL Server (Type 4)
driver.
Do the following to change the password for the user name that InterChange
Server uses to access one of the databases:
- Click Change next to the Password field in the
"Event Management", "Transactions", "Repository", or
"Flow Monitoring" panes.
- Type the new password in the New Password field.
- Type the new password again in the Confirm New Password
field.
- Click OK.
Figure 15 shows the "Database" tab:
Figure 15. Database connectivity configuration tab

Notes:
- Flow Monitoring is not supported for MS SQL Server. If you are
using MS SQL Server as your repository database, the Flow Monitoring portion
at the bottom of this tab is disabled.
- The field called "Schema Name" in the Flow Monitoring portion of
this tab was new in release 4.2.2. If a specific value
for this field is not entered, it will default to the same value used for the
"Login" field. Valid values for this field can contain up to 30
characters from the US-ASCII character set. The name must begin with a
letter from A through Z and the first three characters cannot be
SYS. Other characters in the name can include the letters A
through Z and numbers 0 through 9. For information on the prerequisite
software needed to utilize flow monitoring, as well as detailed explanations
of flow-monitoring concepts, see the System Administration
Guide.
The Security tab of the InterChange Server Configuration Wizard gives
access to the security options. Choose between the local WBI repository
(the default) or an LDAP directory as the location for a user registry (a
secure list of user names 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 Host Name 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. For more information, see Installing and configuring the database server.
- 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. For more
information, see Installing and configuring the database server.
- 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. For more information, see Installing and configuring the database server.
- Type the maximum number of connections you want InterChange Server to make
with the database server in the Max Connections field, or enable
the Unlimited check box to allow InterChange Server an unlimited
number of connections.
- Type the port number through which clients communicate with the database
server in the Port Number field. See the section Setting up ports for information on port numbers.
- Note:
- This field is inactive if DB2 is selected as the database driver.
Do the following to change the password for the user name that InterChange
Server uses to access the database:
- Click Change next to the Password field.
- Type the old password in the Old Password field.
- Type the new password in the New Password field.
- Type the new password again in the Confirm New Password
field.
- Click OK.
Figure 16. Security configuration tab

- After all required values are entered in the InterChange Server
Configuration screen, select one of the following options before
exiting:
- Default--Places the default values for the selected
platform in the required fields.
- Discard--The Discard button remains unavailable until an
update is made in the screen.
- Apply--Verifies that all required fields, from all four
tabs, are populated and updates the InterchangeSystem.cfg
file with the new values.
- Note:
- When you select any of these options, note that the values from all
four tabs are affected. For example, if you are in the
"Database" tab and you click Apply, the values that are in
the "WebSphere MQ", "InterChange Server" and
"Security" tabs are verified and applied.
- Click Exit.
