Configuring client products on Windows systems

You can use the Setnet32 utility to configure Client SDK products.

The Setnet32 utility sets or modifies environment variables and network parameters that HCL OneDB™ products use at run time. You can access the Setnet32 utility from the client products program group.

You can set the following types of information with the Setnet32 utility:
  • Environment variables. The environment variables and network parameters are stored in the Windows™ system registry and are valid for every HCL OneDB client product that you install.

    To set component-specific environment variables, see individual product documentation.

  • Database server network information. A client application connects to a database server that is running on a computer that can be reached through the network. To establish the connection, use Setnet32 to specify the location of the database server on the network and the network communications protocol to use. You must obtain this information from the administrator of the database server you want to use.
    Requirement: If you enter a service name, it must be defined on the client computer in the system32\drivers\etc\services file in the Windows installation directory. The service definition must match the definition on the database server host computer.
  • Host computer and login information. A client application can make connections only to a host computer that it can access through the network. You describe a connection to a host computer by specifying host parameters.

You can use a set of environment variables with the function call ifx_putenv to override the information that was entered in the Server Information and Host Information pages of the Setnet32 utility.

To use these environment variables, set the ONEDB_SERVER environment variable to a valid database server name. Overrides affect only that database server.

The following table lists the WIN32 override environment variables.

Table 1. WIN32 Override Environment Variables
Environment Variable Overrides the Value For
WIN32HOST The HOST network parameter
WIN32USER The USER network parameter
WIN32PASS The PASSWORD network parameter
WIN32ASKPASSATCONNECT The PASSWORD OPTION network parameter
WIN32SERVICE The SERVICE network parameter
WIN32PROTOCOL The PROTOCOL network parameter