cbuild.kb 的例行程序


C_CheckDependencies

文件名

cbuild.kb

语法

C_CheckDependencies(VAL tablesToBeBuilt: LIST OF INTEGER, REF dependencyErrors: LIST OF STRING)

参数

tablesToBeBuilt - 要创建/移植的产品的 app ID

dependencyErrors - 相关性检查的返回状态

返回

如果由于同其他产品的某些相关性

而不能创建该产品的表,则将 dependencyError 设置为

一个说明缺乏相关性(每个字符串一条相关性)的字符串列表。

如果没有相关性问题,则将 dependencyError 设置为 $UNKNOWN。

副作用

说明

该过程确定是否可以创建或移植该产品的表,其他的产品表以该表为基础而创建/移植到一个新的版本。

调用的对话框窗体


C_GetCurrentTableVersion

文件名

cbuild.kb

语法

C_GetCurrentTableVersion(VAL applicationID: INTEGER, REF oldVersion: VERSION_REC)

参数

applicationID - 该应用程序的整数标识(用于

在 SAI_APP_PARAMS 表中进行索引)

oldVersion - 当前已创建表的版本(如果有)

返回

如果提供的 oldVersion 不正确,则返回一个更新过的 oldVersion。

副作用

说明

该过程确定是否在配置的数据库中创建表并返回表的版本。

调用的对话框窗体


C_GetGrantScripts

文件名

cbuild.kb

语法

C_GetGrantScripts(REF scriptsToRun: LIST OF STRING)

参数

scriptsToRun - 要运行的许可脚本

返回

scriptsToRun 要运行的许可脚本

副作用

说明

该过程根据当前配置的数据库平台,获取要为 TAM 表运行的许可脚本。

调用的对话框窗体


C_GetNextDropScripts

文件名

cbuild.kb

语法

C_GetNextDropScripts(REF currentScript: INTEGER, REF scriptsToRun: LIST OF STRING)

参数

currentScript - 当前正执行的脚本的索引

scriptsToRun - 要运行的脚本的列表

返回

在 currentScript 中是将要运行的下一个脚本集合的索引

在 scriptsToRun 中是将要运行的、用于配置的脚本列表

platform.

副作用

说明

提供要执行的数据库 DROP 脚本的文件名列表。自变量 currentScript 可用于跟踪已运行的脚本。在下一次调用该例行程序时,将向它提供该例行程序为 currentScript 设置时的值。如果 currentScript 接收到的值为 $UNKNOWN,则将提供第一个脚本。如果已运行所有脚步,则将 currentScript 设置为 $UNKNOWN。根据正处理的 DBMS 名称来确定相应的脚本列表。使用全局 paramRDBMS 来确定已选择和配置的 DBMS。

调用的对话框窗体


C_GetNextScripts

文件名

cbuild.kb

语法

C_GetNextScripts(VAL buildAction: INTEGER, VAL oldVersion: VERSION_REC, VAL newVersion: VERSION_REC, REF currentScript: INTEGER, REF scriptsToRun: LIST OF STRING)

参数

buildAction - 确定是否要进行移植或新建

oldVersion - 从其进行移植的旧版本

newVersion - 要向其进行移植的新版本

currentScript - 当前正执行的脚本的索引

scriptsToRun - 要运行的脚本的列表

返回

用于 currentScript 和将要运行的文件列表的新值

in scriptsToRun.

副作用

说明

提供下一步要执行的数据库脚本的文件名列表。自变量 currentScript 可用于跟踪已运行的脚本。在下一次调用该例行程序时,将向它提供该例行程序为 currentScript 设置的值。如果 currentScript 接收到的值为 $UNKNOWN,则提供第一个脚本。如果已运行所有脚步,则将 currentScript 设置为 $UNKNOWN。根据输入的参数来确定相应的脚本列表。参数指定要执行的创建操作,指定要从其进行移植和移植到(如果进行移植)的版本。使用全局 paramRDBMS 来确定已选择和配置的 DBMS。

调用的对话框窗体


C_GetRevokeScripts

文件名

cbuild.kb

语法

C_GetRevokeScripts(REF scriptsToRun: LIST OF STRING)

参数

scriptsToRun - 要运行的撤消脚本

返回

scriptsToRun 要运行的许可脚本

副作用

说明

该过程根据当前配置的数据库平台,获取要为 TAM 表运行的撤消脚本。

调用的对话框窗体


C_PostScriptExecution

文件名

cbuild.kb

语法

C_PostScriptExecution(VAL buildAction: INTEGER, VAL oldVersion: VERSION_REC, VAL newVersion: VERSION_REC, VAL currentScript: INTEGER, VAL scriptStatus: BOOLEAN, VAL wHdl: WINDOW, REF actionStatus: INTEGER)

参数

buildAction - 确定是否已进行移植或新建

oldVersion - 从其进行移植的旧版本

newVersion - 要向其进行移植的新版本

currentScript - 当前正执行的脚本的索引

scriptStatus - 以前已执行的一个或多个脚本的成功状态

wHdl - 用于在遇到错误时显示错误消息的窗口句柄

actionStatus - 正执行的操作的返回状态

返回

在 C_PostScriptExecution 中执行的操作的状态(如果有)

副作用

说明

该过程是一个挂起调出,允许在执行一个列表的数据库脚本后执行产品专用的代码。提供了输入参数来允许该例行程序知道在创建进程中执行该例行程序的位置。指定调用的例行程序刚执行的脚本的值。输出参数 actionStatus 的用途是允许例行程序异常终止该产品的创建进程。如果 actionStatus 返回值 1,则继续该产品的创建进程。如果 actionStatus 返回除 1 以外的值,则异常终止该产品的创建进程。

调用的对话框窗体


C_PreScriptExecution

文件名

cbuild.kb

语法

C_PreScriptExecution(VAL buildAction: INTEGER, VAL oldVersion: VERSION_REC, VAL newVersion: VERSION_REC, VAL currentScript: INTEGER, VAL wHdl: WINDOW, REF actionStatus: INTEGER)

参数

buildAction - 确定是否要进行移植或新建

oldVersion - 从其进行移植的旧版本

newVersion - 要向其进行移植的新版本

currentScript - 当前正执行的脚本的索引

wHdl - 用于在遇到错误时(可以使用 ReportError)

显示错误消息的窗口句柄。

actionStatus - 正执行的操作的返回状态

返回

在 TAM_PreScriptExecution 中进行的操作的状态(如果有)

副作用

说明

该过程是一个挂起调出,允许在执行一个列表的数据库脚本之前执行产品专用的代码。提供了输入参数来允许该例行程序知道在创建进程中执行该例行程序的位置。指定调用的例行程序即将执行的脚本的值。输出参数 actionStatus 的用途是允许例行程序异常终止该产品的创建进程。如果 actionStatus 返回值 1,则继续该产品的创建进程。如果 actionStatus 返回除 1 以外的值,则异常终止该产品的创建进程。

调用的对话框窗体


C_SupportMigration

文件名

cbuild.kb

语法

C_SupportMigration(VAL oldVersion: VERSION_REC, VAL newVersion: VERSION_REC, REF supportMigration: BOOLEAN)

参数

oldVersion - 从其进行移植的旧版本

newVersion - 要向其进行移植的新版本

supportMigration - 确定是否支持移植的标志

返回

如果支持移植,supportMigration 被设置成 TRUE。

副作用

说明

该过程确定是否支持将该产品的表从指定的旧版本移植到指定的新版本。

调用的对话框窗体