Initialization File Variables

IBM® Lotus Enterprise Integrator® (LEI) and Domino® Enterprise Connection Services (DECS) set and use certain environment variable settings in the notes.ini file. Some of these variables are set based on choices you make during the Domino® or LEI installation. You can use the notes.ini file to change these settings for DECS and LEI.

You can use the notes.ini file to adjust some aspects of LEI. For example, you can force the local machine's native character set to be overridden by adding the following line to the notes.ini file.

EINativeText=IBMCP932

The LCSTREAMFMT_IBMCP932 represents IBM® character set code page 932. For information about international character sets within LEI, see the IBM® Lotus Enterprise Integrator® for Domino® (LEI) Activities and User Guide.

For Both LEI and DECS

Environment variables used by LEI and DECS are listed as follows:

  • EITranslation
  • EICenturyBoundary
  • EINoCenturyBoundary
  • EINativeText
  • EIMaxRTEntries
  • EIConnectionPool

EITranslation

Controls text translation, allowing you to increase performance in exchange for certain assumptions about the data being accessed. Note that none of these settings affects translation between Unicode and other character sets. There are three valid numeric settings:

  • 0 = Disabled -- Do not perform translation between character sets (except Unicode). This is valid when all data being accessed is compatible with the Notes® LMBCS character set - primarily ASCII printable characters.
  • 1 = LMBCS only -- Do not perform translation between non-LMBCS (and non-Unicode) character sets. This is valid when all data being accessed, except for Notes® LMBCS data, is in compatible character sets.
  • 2 = Enabled -- Always translate between any character sets. This is the default.
Note: On System i®, EITranslation is set to 2 in the notes.ini file by the LEI installer. Do not change this setting.

In previous versions of LEI and DECS, this was named Translation or DECSTranslation, respectively.

EICenturyBoundary

This controls how to interpret the year in a text string being converted to a datetime, when the year contains only two digits. Values greater than or equal to the century boundary are considered to be in 1900s, values less than are in the 2000s. There are three ways to set this:

  • 0 -- Since all values are greater than or equal to zero, always use 1900.
  • 1-100 -- If the two-digit year is greater than or equal to this value, use 1900; otherwise use 2000.
  • 101 -- Since all values are less than 101, always use 2000.

The default setting is 50, which is the same as Notes®. This means that any two-digit year from 0-49 is in 2000, and 50-99 is in 1900.

Using the variable EINoCenturyBoundary=1 negates any use of EICenturyBoundary.

The EICenturyBoundary entry is not created during LEI or DECS installation.

EINoCenturyBoundary

When this variable is set as EINoCenturyBoundary=1, all year values are treated as 4 digit values. For example, the LC LSX statement New LCDatetime(1, 1, 4) will create a date of January 1, 0004. However, the New LCDatetime (1,1,04) will create a date of January 1, 0004, not January 1, 2004.

The EINoCenturyBoundary entry is not created during LEI or DECS installation.

Setting the variable as EINoCenturyBoundary=1 negates any use of EICenturyBoundary.

EINativeText

This allows the local machine's native character set to be overridden. There are various situations when the native character set is used within the LSX, and some external systems always consider client data to be in the native character set. Setting this value to a valid text format string replaces the character set obtained from the operating system by the LSX with the indicated character set. Appendix D lists supported character sets. Use the text that remains after removing the "LCSTREAMFMT_" prefix. For example, Code Page 932, represented by the constant LCSTREAMFMT_IBMCP932, would be set as follows:

EINativeText=IBMCP932
Note: This variable is obsolete for the Connector for DB2® on IBM® i. Beginning in release 8.0.2, LEI and DECS always use Unicode as the native character set on IBM® i.

EIMaxRTEntries

This functionality has been added to allow support for more than 128 concurrent RealTime activities. To increase the maximum number of Advanced RealTime activities that can run concurrently, add "EIRTMaxEntries=" to the notes.ini file and assign it an integer value to indicate the new upper limit. If a line already exists, edit its value to the new setting. The lower limit is 128 active activities; a value less than 128 will not change the limit below 128. If the number of activities started exceeds the specified value in the notes.ini file, the server will display a warning message and subsequent activities will not be started. An example notes.ini entry is shown as follows.

EIRTMaxEntries=175

For LEI only

When you install LEI, several variables are set in the notes.ini file. For detailed information about the notes.ini variables that pertain to LEI, see the IBM® Lotus Enterprise Integrator® for Domino® (LEI) Installation Guide supplied with LEI and at http://www.ibm.com/developerworks/lotus/documentation/lei/

Environment variables used by LEI only are listed as follows:

  • EIName
  • EIAdminServer
  • EIVersion

EIName

Specifies the name of the LEI server as found in the server document of the LEI Administrator database. This variable value is assigned when you install LEI. Example syntax is shown as follows:

EIName=HERMANM

EIAdminServer

Specifies the name of the Domino® server where the LEI Administrator is located. This variable value is assigned when you install LEI. Example syntax is shown as follows:

EIAdminServer=RALPHITE

EIVersion

Specifies the version of the LEI server, entered here by the LEI installation. Example syntax is shown as follows:

EIVersion=101006

For DECS only

Environment variables used by DECS only are listed as follows:

  • DECSPollingInterval

DECSPollingInterval

Specifies the interval at which DECS will reference the DECS Administrator configuration document.

DECSPollingInterval=5

For LC LSX only

Environment variables used by the Connectors Extensions for LotusScript® (LC LSX) only are listed as follows:

  • EIConnectionPool

EIConnectionPool

Provides syntax for configuring the connection pools as a list of comma-delimited connector names, the pool size, and an optional data source maximum. The default pool size for all connectors is 20. The optional data source maximum value indicates the limit of allowed connections to a single database. This value cannot be more than the total pool size for a given connector. For example, a DB2® pool size of 10 and a data source maximum of 5 indicates the pool will hold no more than 10 connections to DB2® and of the 10, no more than 5 will be to any one database. If you do not specify a data source maximum, it is the same as the pool size.

An example notes.ini file entry is shown as follows. This example has pooling information for the Oracle and a DB2® connectors. Respectively, the entry supports connection pools of 10 and 20 connections each. In addition, the DB2® entry indicates that no more than five connections in the pool can be to a single database.

EIConnectionPool=oracle,10,db2,20,5

For more information, see the Connection Pooling section in the Lotus® Connector LotusScript® Extensions Guide (lsxlc.nsf) supplied with Domino® and at http://www.ibm.com/developerworks/lotus/documentation/lei/