Registry Settings

The Microsoft® OLE DB Provider for AS/400 and VSAM uses a number of registry settings for configuration and proper operation. The configuration registry settings are located under the HKEY_LOCAL_MACHINE\Software\Microsoft\SNA OLE DB key. These registry settings include the following subkeys:

Subkey Comment
BinAsChar Registry key that indicates whether to process binary fields as character fields (default is 0, don't process binary fields as character fields).
CLIENT Stores the path to the directory where the DDMAPI.DLL and other OLE DB Provider for AS/400 and VSAM DLLs are located and the default code page to use on the PC.
CodePage Stores the path to the directory where the EBCDIC-to-ASCII character set tables are located.
Data Sources Stores information used by the OLE DB Provider for AS/400 and VSAM to enumerate data sources on different hosts.
DDM Server Stores the path to the directory where the DDMSERV.EXE is located.
Locale Lists the conversions supported by the PC and the hosts.
Trace Indicates whether internal tracing is to be enabled for the OLE DB Provider.
TraceFile This parameter is only valid if internal tracing is enabled. When configuring for tracing, the TraceFile registry setting indicates the name and path for the OLE DB trace file stored on the PC. The default value for this parameter is C:\SNA\Traces\snaoledb.trc.

Under the Data Sources subkey are subkeys for each host using the host name as the subkey. The registry settings for these parameters are normally configured using the Microsoft Management Console snap-in application

The registry keys and values under these host subkeys are as follows:

Key Data value
CCSID The CCSID on the host (default is 37, U.S. English).
CodePage The code page to use on the PC (default is 437, US ASCII). This value is only used when the SNA client is configured for custom code page conversion.
HostEnv Indicates whether the data resides on an AS/400 or a mainframe system.
Library The default AS/400 library to be accessed. This parameter is not required for mainframe access and is optional when connecting to AS/400 files.
LocalLU The name of the local LU alias configured in the SNA server.
LocalFilePath The path where the DDM host column description (HCD) files are stored on the PC.
Mode The APPC mode (must be set to a value that matches the host configuration and SNA server configuration).

Legal values for the APPC mode include QPCSUPP (5250), #INTER (interactive), #INTERSC (interactive), #BATCH (batch), #BATCHSC (batch), and custom modes. The following modes that support bidirectional LZ89 compression are also legal: #INTERC (interactive), INTERCS (interactive), BATCHC (batch), and BATCHCS (batch).

Rdb The Remote DataBase Name for OS/400. This value is only used when the database name is different from the remote LU alias configured in the SNA server.
RemoteLU The name of the remote LU alias configured in the SNA server.
UseLocalFile An integer value that determines if DDM host column description files (HCD files) are to be used when communicating with an AS/400. If this value is 1, then local HCD files will be used rather than interrogating the host system.

Note that the SNA OLE DB Management Console snap-in should be used for configuring these registry settings.