sqleqryc API -查询客户机连接设置

返回应用程序进程的当前连接设置。将使用连接设置类型和值来填充 sqle_conn_setting 数据结构。

授权

无

需要的连接

无

API 包含文件

sqlenv.h

API 和数据结构语法

SQL_API_RC SQL_API_FN
  sqleqryc (
        struct sqle_conn_setting * pConnectionSettings,
        unsigned short NumSettings,
        struct sqlca * pSqlca);

SQL_API_RC SQL_API_FN
  sqlgqryc (
        struct sqle_conn_setting * pConnectionSettings,
        unsigned short NumSettings,
        struct sqlca * pSqlca);

sqleqryc API 参数

pConnectionSettings: 输入/输出。指向 sqle_conn_setting 结构的指针，用于指定连接设置类型和值。用户定义 NumSettings 连接设置结构的数组，并设置此数组中每个元素的类型字段以指示五个可能的连接设置选项之一。返回时，每个元素的值字段包含指定选项的当前设置。
NumSettings: 输入。表示要返回的连接选项值数的任何整数 (从 0 到 7)。
pSqlca: 输出。指向 sqlca 结构的指针。

使用说明

可以在执行期间随时查询应用程序进程的连接设置。

如果 QUERY CLIENT 成功，那么 sqle_conn_setting 结构中的字段将包含应用程序进程的当前连接设置。如果从未调用 SET CLIENT ，那么仅当已处理 SQL 语句时，这些设置才会包含预编译选项的值; 否则，它们将包含预编译选项的缺省值。

REXX API 语法

QUERY CLIENT INTO :output

REXX API 参数

输出

包含有关应用程序进程的当前连接设置的信息的复合 REXX 主变量。在以下内容中， XXX 表示主变量名称。

XXX.1: CONNECTION 类型的当前连接设置
XXX.2: SQLRULES 的当前连接设置
XXX.3: 当前连接设置，指示发出 COMMIT 时将释放哪些连接。
XXX.4: SYNCPOINT 选项的当前连接设置。 SYNCPOINT 选项将被忽略，并且仅可用于向后兼容性。指示是否应使用事务管理器来实施两阶段落实语义，数据库管理器是否应确保在单个事务中访问多个数据库时仅更新一个数据库，或者是否不使用这两个选项。
XXX.6: 延迟 PREPARE 的当前连接设置。