GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 45 -
本节描述如何使用 Setnet32 实用程序来配置 Client SDK 产品。
Setnet32 实用程序设置或修改 GBase8s 产品在运行时使用的环境变量和网络参数。环境
变量和网络参数存储在 Windows 系统注册表中，
对于您安装的每个GBase8s 客户机产品都
有效。
本节分为下列几个步骤：
l 设置环境变量
l 设置数据库服务器信息
l 设置主机信息
要设置特定于组件的环境变量，请参阅各个产品文档。
Setnet32 实用程序有下列 4 个页面：
l 环境允许您设置环境变量。
l 服务器信息允许您设置数据库服务器网络信息。
l 主机信息允许您设置主机和登录信息。
l 关于 Setnet32 提供有关 Setnet32 实用程序的信息。
设置环境变量 (Windows)
要获取有关 GBase 产品及其运行环境的信息，
客户机产品必须访问环境变量。
一些环境变
量是必需的，一些是可选的。
要设置环境变量：
1. 在包含 Client SDK 产品的文件夹中双击 Setnet32。此时将打开 GBase Setnet32 窗口。
2. 单击环境选项卡以显示环境页面，其中包含下列元素：
o GBase8s 客户机/服务器环境
选择要编辑的环境变量。
选择环境变量以后，环境变量名称会显示在变量名文本框上方。
o 编辑环境变量
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 46 -
在文本框中输入新的值、编辑现有值，或单击向下箭头选择一个值。
单击清除可将空值指定给该环境变量。作出更改以后，单击设置以保存该值。
o 保存/装入
单击从文件装入可从特定文件装入环境变量以及它们的值。然而，除非 Setnet32
实用程序已创建指定文件，否则您不能从该文件装入环境变量。（使用保存到文件
选项来创建文件。）
单击保存到文件以将您的环境变量以及它们的值保存到指定文件。
o 使用我的设置
Setnet32 条目在安装时存储在 HKEY_LOCAL_MACHINE 下面。要保存
HKEY_CURRENT_USER 中的设置并将其设为缺省注册表以修改设置，请选择使
用我的设置并单击应用。于是所有环境设置都复制到 HKEY_CURRENT_USER
中。
要还原为 HKEY_LOCAL_MACHINE 条目，请取消选择使用我的设置，并单击应
用。
使用我的设置复选框是作为 DEFAULT_USER_SETTING 存储在
HKEY_CURRENT_USER 下面的条目，它可以是 LM，代表本地机器（缺省值），
也可以是 CU，代表当前用户。
有关环境变量的更多信息，请参阅环境变量和《GBase8s SQL 指南：参考》。
有关语言环境环境变量的更多信息，请参阅《GBase8s GLS 用户指南》。
设置数据库服务器信息 (Windows)
客户机应用程序连接到 GBase8s 数据库服务器，
该数据库服务器运行在可通过网络访问的
计算机上。
要建立连接，
请使用 Setnet32 来指定 GBase8s 数据库服务器在网络上的位置，
以及要使用的网络通信协议。您必须从要使用的数据库服务器的管理员处获取此信息。
要设置数据库服务器信息：
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 47 -
1. 在包含 Client SDK 产品的文件夹中双击 Setnet32。
将打开 GBase Setnet32 窗口。
2. 单击服务器信息选项卡以显示服务器信息页面，其中包含下列元素：
o GBase8s 服务器
选择现有的 GBase8s 数据库服务器，或输入新的数据库服务器名称。
o 主机名
为您要使用的数据库服务器选择主机，或输入新主机的名称。
o 协议名称
从安装过程提供的协议列表中选择一个网络协议。
o 服务名称
指定与特定数据库服务器关联的服务名称。输入分配给主机上的数据库服务器的服务
名称或端口号。您必须从数据库服务器管理员处获取此信息。
要求： 如果您输入了服务名称，那么它必须在客户机上 Windows 安装目录的
services 文件中定义。该文件的目录为 system32\drivers\etc\services。服务定义必须与
数据库服务器主机上的定义匹配。
o 选项
输入特定于数据库服务器的选项。有关更多信息，请参阅《GBase8s 管理员指南》。
o 生成缺省服务器
将 GBASEDBTSERVER 环境变量设为当前数据库服务器的名称，使其成为缺省数据
库服务器。
o 删除服务器
设置主机信息 (Windows)
客户机应用程序只能连接到可通过网络访问的主机。您可通过指定主机参数来描述与主机
的连接。
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 48 -
要设置主机信息：
1. 在包含 Client SDK 产品的文件夹中双击 Setnet32。
此时将打开GBase Setnet32 窗口。
2. 单击主机信息选项卡以显示主机信息页面，其中包含下列元素：
o 当前主机
该字段显示以前在当前 Windows 注册表中定义的主机。选择要与其建立网络连接的
主机的名称，或者在列表上编辑或重新输入名称以定义新的主机名。
o 用户名
该字段显示当前选定的主机上某帐户的用户名。此文本框中的值是区分大小写的，该
值的最大长度为 18 个字符。
o 密码选项
选择下列一个密码选项：
在运行时询问密码
您的应用程序提示用户输入密码。
有关如何使用 sqlauth() 函数来提示输入密码并验
证密码的信息.
无密码
用户帐户没有密码。
当应用程序打开一个新的数据库时，
该应用程序不向数据库服务
器发送密码。如果数据库服务器的主机需要密码，那么连接失败，您会收到一条错误
消息。
密码
用户帐户具有的密码与密码文本框显示的加密值匹配。
当应用程序打开一个新的数据
库时，
数据库服务器将用户输入的密码与数据库服务器主机的登录密码进行比较。
如
果两个密码不同，那么用户不能通过网络连接到数据库服务器。
o 密码
该字段由密码选项激活，显示星号 (*) 代表帐户密码。启用该字段后，它接受最大长
度为 18 个字符的密码值。该值区分大小写，并且不能包含任何空格。
GBase 8s 客户机产品安装指南
南大通用数据技术股份有限公司 - 49 -
要输入新密码，请将光标放在密码文本框内，然后输入新密码。星号 (*) 代表您输入
的字符。
o 删除主机
单击删除主机，从 Windows 注册表中删除当前选定的主机名称，同时删除与该主机
关联的用户名、密码选项和密码。
有关主机参数的更多信息，请参阅《GBase8s 管理员指南》。
覆盖信息 (Windows)
您可以使用一组环境变量并调用函数 ifx_putenv 来覆盖 Setnet32 实用程序的服务器信息
和主机信息页面中输入的信息。
要使用这些环境变量，请将 GBASEDBTSERVER 环境变量设为有效的数据库服务器名
称。覆盖仅影响该数据库服务器。
Client SDK V3.1.0 支持以下 WIN32 覆盖环境变量。
有关这些环境变量的更多信息，
请参
阅 《GBase8s ESQL/C 程序员手册》。