User Registry

The parameters in the USER_REGISTRY section of the file govern InterChange Server's use of a database to store user accounts and passwords.

Note:
It is strongly recommended that a different database is used for the USER REGISTRY than that used for the REPOSITORY.

DATA_SOURCE_NAME

The name of an IBM-branded driver or DB2 JDBC type 2 driver data source where the user registry is stored. For an explanation of the JDBC URL, refer to the System Administration Guide.

Example: DATA_SOURCE_NAME =jdbc:ibm-crossworlds:oracle:// @server:1521;SID=RegistryDB

The port number in the example 1521 is the default port number for the Oracle Listener. The port number can be set by the user.

Default

There is no default value for the DATA_SOURCE_NAME parameter.

MAX_CONNECTIONS

Specifies how many database connections InterChange Server can open on behalf of the repository service. Set this parameter only if you have partitioned InterChange Server work load across database servers.

Example: MAX_CONNECTIONS = 30

Default

MAX_CONNECTIONS = 2147483647

USER_NAME

The name that InterChange Server uses to log in to the user registry. Use this parameter to specify a non-default login account.

Since it is recommended not to use the same database for the repository and the user registry this value need not be the same as in other sections of the configuration fie.

Example: USER_NAME = registry

Default

There is no default value for this parameter.

PASSWORD

The encrypted password associated with the user name chosen for the user registry.

Example: PASSWORD*=a6gefs

Important:
Do not attempt to change the encrypted password. See the Encryption for Passwords section in the System Administration Guide for more information about how password encryption works.

DB_CONNECT_RETRIES

Specifies the maximum number of times that the server will try to reconnect to the database after the connection is found to be broken. The recommended retry count is 3. If the value is set to 0, this is equivalent to switching off the database connectivity resilience.

Use the DB_CONNECT_INTERVAL parameter to specify the time to wait between retries. The recommended time is 60 seconds.

The DB_CONNECT_RETRIES parameter and the DB_CONNECT_INTERVAL parameter in this section act upon the user registry database. If database connectivity issues occur during communication between the server and the user registry database, this pair of parameters controls how often and how frequently the server will try to reconnect to that database. Failures in communication between the server and the user registry database can cause the InterChange Server to shutdown.

Note:
The DB_CONNECT_RETRIES parameter does not appear in the InterChange Server Configuration Wizard and must be altered by editing the [USER_REGISTRY] section of the InterchangeSystem.cfg using the System Manager.

Default

DB_CONNECT_RETRIES = 3

DB_CONNECT_INTERVAL

Specifies the time to wait between database connection retries. The recommended time is 60 seconds. Setting the retry interval too high will slow the system down unnecessarily.

Set this value in the InterChangeSystem.cfg file in the [USER_REGISTRY] section. The value you specify is in seconds.

Note:
The DB_CONNECT_INTERVAL parameter does not appear in the InterChange Server Configuration Wizard and must be altered by editing the [USER_REGISTRY] section of the InterchangeSystem.cfg using the System Manager.

Default

DB_CONNECT_INTERVAL = 60

Copyright IBM Corp. 1997, 2004