gbase数据、南大通用产品文档：GBase8agbase_get_client_version

 摘要：
返回表示客户端库版本的整数。该值的格式是XYYZZ，其中X 是主版本号，
YY 是发布级别，ZZ 是发布级别内的版本号。
 语法：
unsigned long
gbase_get_client_version(void);
 参数：
 返回值：

GBase 8a 程序员手册C API 篇


- 20 -

南大通用数据技术股份有限公司
表示GBase 客户端库版本的整数。

sword GCISessionGet (
GCIEnv *envhp,
GCIError *errhp,
GCISvcCtx **svchp,
GCIAuthInfo *authhp,
GCIText *poolName,
ub4 poolName_len,
const GCIText *tagInfo,
ub4 tagInfo_len,
GCIText **retTagInfo,
ub4 *retTagInfo_len,
boolean *found,
ub4 mode
)；

根据数据库服务名、用户名和密码，登录到一个指定的数据库服务上，并初始化相关上
下文句柄。可以使用现有连接池中的连接。

参数
输入
/输出


envhp
输入/输出
GCI 环境句柄，对于连接池和会话池，为在其中创建相应池
的环境句柄
errhp
输入/输出
错误句柄
svchp
输出
GCI 服务上下文指针的地址
authhp
输入
获取连接时要使用的身份验证信息句柄
poolName
输入

mode 为GCI_DEFAULT 时，表示连接到GBase8s 服务器
的数据库名称

mode 为GCI_SESSGET_CPOOL 时，表示连接池名称。
poolName_len 输入
poolName 的长度
tagInfo
输入
保留参数，目前不使用(仅用于和Oracle 保持兼容)
tagInfo_len
输入
保留参数，目前不使用(仅用于和Oracle 保持兼容)
retTagInfo
输出
保留参数，目前不使用(仅用于和Oracle 保持兼容)
retTagInfo_len 输出
保留参数，目前不使用(仅用于和Oracle 保持兼容)
found
输出
保留参数，目前不使用(仅用于和Oracle 保持兼容)
mode
输入
有效模式为：

GCI_DEFAULT:缺省模式

GCI_SESSGET_CPOOL:连接池模式

如果执行成功，则返回GCI_SUCCESS，否则返回GCI_ERROR。

GBase 8s GCI 接口使用指南

南大通用数据技术股份有限公司 53

有工具可用于帮助诊断使用连接管理器引起的问题。
连接管理器日志文件中包含有关服务级别协议的信息、故障转移配置的信息和状态信息。
启动连接管理器时，将显示日志文件的位置。
除了检查日志文件之外，还可以使用服务器随附的工具。可以通过以下方式监视连接管理
器的状态：

使用 onstat 命令显示可用于对问题进行故障诊断的统计信息。

使用 GBase OpenAdmin Tool (OAT) 。
确定连接管理器的状态
可以使用 onstat 实用程序来显示有关活动连接管理器实例的信息。
使用 onstat -g cmsm 命令可显示连接到服务器实例的连接管理器守护程序，
还可显示守护程
序已处理的连接数。请参阅《GBase 8s 管理员参考》 以获取有关示例的更多信息。

GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 470 -
以下代码是对单个活动连接管理器实例使用 onstat -g cmsm 命令生成的示例输出。
Connection Manager Name: argo
Hostname: argo

SLA Connections Service/Protocol Rule
oltp 9 9593/onsoctcp primary
oltp_ssl 4 9596/onsocssl primary MODE=PROXY
report 0 9594/onsoctcp SDS,HDR,RSS

Failover Configuration:

Connection Manager name Rule Timeout State
argo SDS,HDR,RSS 10 Active Arbitrator, Primary is
up
以下代码是对两个活动连接管理器实例使用 onstat -g cmsm 命令生成的示例输出。
Connection Manager Name: reynolds
Hostname: argo

SLA Connections Service/Protocol Rule
oltp 9 9593/onsoctcp primary
oltp_ssl 4 9596/onsocssl primary mode=proxy
report 0 9594/onsoctcp SDS,HDR,RSS

Connection Manager Name: stimpson
Hostname: argo

SLA Connections Service/Protocol Rule
oltp2 9 19903/onsoctcp primary
report2 0 19904/onsoctcp SDS,HDR,RSS

Failover Configuration:
Connection Manager name Rule Timeout State
argo
SDS,HDR,RSS 10 Active Arbitrator, Primary is
up
argo2
SDS,HDR,RSS 0 Primary is up

GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 471 -