As400 Connection    ODBC Connection     Oracle Connection    
LotusNotes Connection    XML Connection    Mainframe Connection

Multi-Platform Connectivity
This is OV2Word's most powerful feature in data-merge document technology.

Take your business's document system to the next level by migrating from OfficeVision to a truly cross-platform architecture. Now you can tie together your DB2 reservoirs to ODBC, LotusNotes, Mainframe, and Oracle databases. Create a multi-platform, web-enabled document portals for your satellite offices to work from using our XML connection. 

Supplement your investment and develop real-time, on-demand reports from heterogeneous, WAN-enterprise systems with your existing application. Layout the report in MS Word, add the logic to identify the data, generate an interface pointing to the various data sources using our SDK Connection tool. 

Local Connection
Settings for the connection types are stored in the connection manager ini file. Changes in this connection file can be made through the an easy to use GUI. The Local Connection can both be configured with global settings as well as with DID specific settings. 

Local Connection Settings  
Setting  Default Description
DllPath  Empty Search path for Local Connection data retrieval DLL’s. The format is directory1;directory2 etc.
ExePath Empty Search path for Local Connection data retrieval programs (executables).

AS400 Connection
Settings for the connection types are stored in the connection manager ini file. Changes in this connection file can be made through the an easy to use GUI.

This connection can use the TCP/IP or APPC protocol to connect to an AS/400 database. 

· To use the TCP/IP connection a Winsock 1.1 (or higher) compliant TCP/IP implementation (protocol stack) must be installed and configured on the PC.

· To enable ITP to communicate with the AS/400 through APPC, your PC must be running a correctly configured PC Support or Client Access/400 compatible APPC router. PC Support’s own router complies with this as well as for example NetSoft’s router. For Windows 95 and NT the router must support the E32APPC.DLL API.

The AS/400 Connection can both be configured with global settings as well as with DID specific settings in the dm.ini file. The following listing describes the available settings.

AS/400 Connection Settings

Setting  Default Description
Protocol  TCPIP The network protocol API used for the connection. This must be either TCPIP or EHNAPPC.
 
AddressSelection Y Allow selection of the hostname or address at login time. This must be either Y or N. 
Address - The IP address or name, including an optional port number of the AS/400. Format: myhost.mydomain[:port]. The host name of the AS/400 in case of EHNAPPC.
UserId  - The UserId for the AS/400 login process. This setting is only valid for TCPIP. The optional UserId command-line parameter takes precedence. If neither is available, A login dialog box is presented to the user. Use the special value *USER to configure unified logon. If this functionality is used, the password will not be checked on the AS/400. To be able to use unified logon the deamon has to be started on the AS/400 with the option CHKPWD(*NO). 

NOTE: If a user can create a userprofile that exists on the AS/400 and uses this userprofile to log on to Windows, he or she can still have unwanted access to AS/400 data files.

Password  - The Password for the AS/400 login process. This setting is only valid for TCPIP. The optional Password command-line parameter takes precedence. If neither is available, a login dialog box is presented to the user.
LIBL Empty The library list to be set on the AS/400. It takes precedence over the library list specified in the DID file in the DID download program.
ITPLibrary Empty  The library for the AS/400 ITP/CS program objects. APPC only.

AS/400 System (Address) 
The name or address of the AS/400 host to connect to. The value that you have to enter here depends on the protocol:

TCP/IP Connection
The format used for the name of AS/400 system to connect to is:
host[:port]

Where host is the name or the dotted decimal TCP/IP address of the AS/400 and port is the optional port number or service name for a port number that the to which the AS/400 daemon is listening. The default port is 10042. You need not specify a port, unless you start the daemon on the AS/400 with another port than the default.

When you specify a host name, you must make sure that the TCP/IP name resolution process can resolve this name. TCP/IP must find the associated dotted decimal address, either by using a DNS or by using a local hosts file. 
When you specify a port name you must make sure that TCP/IP will be able to resolve the service name (i.e. find the associated port number). It usually does so by looking it up in the local services file (in the windows directory).

APPC Connection

In the router configuration, you have to define links to one or more AS/400’s in your network. Such a link is often called a Partner Logical Unit. This connection uses this Partner Logical Unit definition as the basis for communication.

ODBC Connection
Settings for the connection types are stored in the connection manager ini file. Changes in this connection file can be made through the an easy to use GUI.             
           
The ODBC Connection can be configured with global settings as well as with DID as with DID Module specific settings in the connection file. The ResetConnectionsAfterModel setting can only be used on DID level. The following listing describes the available settings.

ODBC Connection Settings

Setting  Default  Description
ConnStr Empty A DSN has to be specified in this setting or the DSN setting has to be set. A standard ODBC connection string. It must at least contain a setting for the datasource name to be used, like in "DSN=MyDsn". Other settings are ODBC driver specific and can be found in the appropriate documentation for the specific ODBC driver.
CacheStats Y The ODBC Connection caches SQL statements intelligently for performance reasons. The setting may have to be set to N to work around some problems with the Lotus Notes ODBC driver using SQL Statements containing the DISTINCT keyword.
DisconnectAfterModel N Normally the connection to the data source will stay open until the connection is stopped. If you set DisconnectAfterModel to Y, this closes the connection to the data source after every model.
ResetConnectionsAfterModel N If you set ResetConnectionsAfterModel, the connection will not be stopped but the process will completely rebuild the connection for the every model thus allowing you to change for example the Userid, Password setting for the next model. This setting can only be used on DID level.
UserId Empty The userid for the database login.
Password  Empty The password for the database login.
DSN Empty Either this setting must be set or a DSN must be specified in the Connstr setting. The ODBC Data Source Name that is used.

The values specified in Connstr, UserID, Password and DSN will be combined into one connection string.

Oracle Connection
Settings for the connection types are stored in the connection manager ini file. Changes in this connection file can be made through the an easy to use GUI.

The Oracle Connection can be configured with global settings as well as with DID as with DID Module specific settings in the dm.ini file. The following listing describes the available settings.

Oracle Connection Settings

Setting  Default  Description
ConnStr Empty  One string containing user-id, password and server. The format is "userid/password@server". All three parts are optional. Forms like "userid/password" or "userid/password@server" or "@server" are most common. In the latter case, a dialog box will ask the user to enter user-id and password.
CacheStats Y The Oracle Connection caches SQL statements intelligently for performance reasons. There are currently no known reasons to set the setting to N.
DisconnectAfterModel  N Normally the connection to the database will stay open until the connection is stopped. If you set DisconnectAfterModel to Y, the process closes the connection to the database after every model.
UserId Empty The userid for the database login.
Password Empty The password for the database login.
Server Empty Oracle database to connect to.

We advise to use the UserId, Password and Server setting to specify a userid, password and server and not the Connstr setting. If a Connstr setting has been specified, it will be split into userid, password and server (if provided). Any available values specified at UserId, Password or Server will overwrite these values.

Lotus Notes Connection
Settings for the connection types are stored in the connection manager ini file. Changes in this connection file can be made through the an easy to use GUI.

The Notes Connection can be configured with global settings as well as with DID as with DID Module specific settings in the connection file. 

Lotus Notes Connection Settings

Setting  Default  Description
Server Empty  The Domino server to connect to. If not specified the local Lotus Notes database is used.
Database   Required The Notes database file (.nsf file) to use. Use a fully qualified path if the database file is not located in the Notes data directory.
Ini  Empty  The Lotus Notes/Domino notes.ini file that must be used to connect to the database. If not specified the default notes.ini file is used. For performance reasons we advise to set this option only on DID level.
Userid Empty  The Userid for the database login. Can only be set on global level. This setting is only used with ITP/Batch Server. See section below.
Password  Empty The Password for the database login. Can only be set on global level.This setting is only used with batch application. See section below.

Batch Application Environment
When you connect to a Notes/Domino database a password may be required. The dialog box that pops up for this password is not under the control of the connection, but solely under the control of Notes. This causes problem in a batch environment where one does not want any interaction to take place. In a batch environment the password should be provided to Notes automatically. 
There are two solutions in Lotus Notes/Domino as described by Lotus Corporation:

1. Circumvent the problem by using a userid that does not have a password (actually has a blank password). In this case the password is of course not needed and asked at all. Allthough this may seem a bad solution it is actually not so bad when used in a controlled batch environment with no external access. One could furthermore restrict the userid to read-only access on the databases.

2. Use the Notes Extension Manager dll, ITPNotesExtPwd.dll that is provided by ITP. This dll provides the password to Notes when it is needed. However this dll is used for all-or-nothing, i.e. when this dll is installed and registered is operated for all Notes applications on the particular machine including ITP, but also the Notes Client.

Using ITPNotesExtPwd.dll

Please follow the following steps to use the extension manager dll

1. Copy the dll from the ITP Bs directory to your notes program directory (often c:\lotus\notes).

2. Register the dll by adding the following line to notes.ini:EXTMGR_ADDINS=ITPNotesExtPwd.dll

3. Configure the password in the Connection Configuration on the global level, using the ITP Administration Program. It can both be stored encrypted or as plain text. We advise to store it encrypted.

ITPNotesExtPwd.ini

Instead of storing the password in ITP’s connection configuration file (dm.ini), it can also be stored in a file with the name ITPNotesExtPwd.ini in the notes program directory, in the following format:
[Global]Notes.Password=xxx

The password can also be encrypted (format Encrypted:xxx), in which case the value should be copied from the regular connection configuration file.

The dll will first check for the availability of this file and if this file is not available it will look for the connection configuration file.

Remarks

· The EXTMGR_ADDINS line should not be the last line of notes.ini.

· If EXTMGR_ADDINS is already present in notes.ini, the name of the dll should be added to this line, using a comma as the separator.

· If the password cannot be found, none of the ini files can be found and/or the setting is blank, Notes will interactively prompt for the password anyway.

· The only way to make sure that the password is not used for other applications than ITP, is to use a separate notes.ini file for ITP. 

· It is not possible to use separate passwords for separate environment, DIDs or DID modules. Therefore it should only be configured on the global level. Configuration on other levels will be ignored.

XML Connection
Settings for the connection types are stored in the connection manager ini file. Changes in this connection file can be made through the an easy to use GUI.

The XML File Connection can be configured with global settings as well as with DID as with DID Module specific settings in the connection file. 

XML Connection Settings

Setting  Default  Description
Directory Empty The directory where the process will start looking for XML files
AllowMissingFields N When you set this key to Y or y the process will give no errors for missing fields in an entry. These fields will be filled with the default value for the corresponding type.
Encoding. Default UTF-8  Allows a different encoding to be specified. In this way files without a prolog can use an encoding different than UTF-8. Supported encodings are: UTF-8, ISO-8859-1 and ASCII.
LOCALE  ENG  With this setting you determine the style of the thousand separator and the decimal point. See the table below for the possible language codes.
LOCALE:LC_NUMERIC:thousands_sep Special With this setting you can overwrite the default style of the thousands separator (see the table below).
LOCALE:LC_NUMERIC:decimal_point Special With this setting you can overwrite the default style of the decimal point (see the table below).

Mainframe Connection
Settings for the connection types are stored in the connection manager ini file. Changes in this connection file can be made through the an easy to use GUI.

The Mainframe Connection can both be configured with global settings as with DID specific settings in the connection file. Some settings are meaningful for all types of mainframe connections. Some settings are only meaningful when using CPIC while other settings are only meaningful when using MQSeries. Using the CPI-C API for the Mainframe Connection is depreciated and will not be supported in future versions of the software.

Mainframe Connection Settings

Setting  Default  Description
Codepage 37 The code page for the mainframe data.
Disconnect Normal  Disconnect the host (end the transaction) after every entry, model or when a DID change takes place. Must be Entry, Model or Normal.
Protocol  MQS The interface type that must be used. This can be either CPI-C for CPI-C communication or MQS for MQSeries.
UserId  Empty The UserId for the host login process.
Password Empty  The password for the host login process.
     
MQSeries    
MQS.ConnectionName No Default This is either the hostname or the network address of the remote machine.
MQS.ServerChannelName No Default  This is the name of the server connection channel that will be used for the Client-Server MQI connection.
MQS.QueueManagerName  Empty The name of the queue manager on the host that manages the request queue and the reply model queue. If no queue manager is specified this setting defaults to empty, which means that the default queue manager of the host will be used.
MQS.RequestQueueName No Default  The name of the request queue.
MQS.ReplyQueueModelName Empty  The name of the model queue name that is used to dynamically create a private reply queue. If no name is specified the ReplyQueueName is taken as the model queue name.
MQS.ReplyQueueName  No Default  The name that will be used for the dynamically created reply queue. This name will be extended with the userid and a unique id. So if Client ‘John’ has set the ReplyQueueName to ‘ITP.REPLY’ the actual reply queue will be named ‘ITP.REPLY.John.<UniqueId>’.
MQS.Timeout 15000  The time (in milliseconds) that the client will wait for an answer.
     
CPIC    
SideInfo No Default The name of the CPI-C side-info entry when using external side-info. When this setting is empty, ITP will generate an internal side-info entry on the fly.
Plu No Default The SNA Partner Logical Unit name of the host. Only for internal side-info.
Tpn No Default  Transaction Program Name of the connection. Only for internal side-info.
APPCMode QPCSUPP The APPC mode for the SNA conversation. Only for internal side-info.
SvcKey Empty Key/password to use when creating a side-info entry. This setting is very rarely used.

©2003 ITSG Inc. All rights reserved.    Terms of Use    |    Privacy