tambuild.kb 例行程序


TAM_CheckDependencies

文件名

tambuild.kb

语法

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

参数

tablesToBeBuilt - 要创建/转移的产品的 app 标识

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

返回

如果由于与其它产品的一些相关性而

不能创建该产品的表,则将 dependencyError 设置为字符串列表,指示丢失的相关性(一个字符串一个相关性)字符串列表。

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

副作用

说明

该过程确定本产品表是否可以创建或转移,其它产品表根据此表正被创建/转移到新的版本。

调用的对话窗口


TAM_GetCurrentTableVersion

文件名

tambuild.kb

语法

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

参数

applicationID - 该应用程序的整数身份标识(用来索引进入 SAI_APP_PARAMS 表)

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

返回

更新的 oldVersion,如果提供的 oldVersion 不正确。

副作用

说明

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

调用的对话窗口


TAM_GetGrantScripts

文件名

tambuild.kb

语法

TAM_GetGrantScripts(REF scriptsToRun: LIST OF STRING)

参数

scriptsToRun - 要运行的授权脚本

返回

返回有授权脚本的 scriptsToRun

副作用

说明

该过程获取要运行的 TAM 表的授权脚本,该脚本以当前配置的数据库平台为基础。

调用的对话窗口


TAM_GetNextDropScripts

文件名

tambuild.kb

语法

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

参数

currentScript - 当前正在处理的脚本的索引

scriptsToRun - 要运行的脚本列表

返回

在 currentScript 中,要运行的配置平台的下一脚本集的索引

和 scriptsToRun 中,要运行的配置平台的脚本

列表。

副作用

说明

提供要排行的数据库 DROP 脚本的文件名列表。可以使用自变量 currentScript 以保持对已运行脚本的跟踪。该例行程序为 currentScript 设置的值下次调用时将提供给该例行程序。如果接收的 currentScript 的值为 $UNKNOWN,则应当提供第一个脚本。如果全部脚本已运行,currentScript 设置为 $UNKNOWN。专用脚本列表是以正在处理的 DBMS 名称为基础而确定的。全局 paramRDBMS 用来确定已选择和配置了何种 DBMS。

调用的对话窗口


TAM_GetNextScripts

文件名

tambuild.kb

语法

TAM_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 的新值和

和 scriptsToRun 中下次要运行的文件列表。

副作用

说明

提供下次要处理的数据库脚本的文件名列表。可以使用自变量 currentScript 以保持对已运行脚本的跟踪。该例行程序为 currentScript 设置的值将提供给该例行程序的下次调用。如果接收的 currentScript 的值为 $UNKNOWN,则应当提供第一个脚本。如果全部脚本已运行,currentScript 设置为 $UNKNOWN。专用脚本列表是以输入参数为基础而确定的。该参数指定要执行何种创建操作和移出移入的版本(如果执行转移)。全局 paramRDBMS 用来确定已选择和配置了何种 DBMS。

调用的对话窗口


TAM_GetRevokeScripts

文件名

tambuild.kb

语法

TAM_GetRevokeScripts(REF scriptsToRun: LIST OF STRING)

参数

scriptsToRun - 要运行的撤回脚本

返回

要运行的带有撤回脚本的 scriptsToRun

副作用

说明

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

调用的对话窗口


TAM_PostScriptExecution

文件名

tambuild.kb

语法

TAM_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 - 正在执行的操作的返回状态

返回

TAM_PostScriptExecution 中执行的操作的状态(如果有的话)

副作用

说明

该过程为暂挂过程,它允许在执行数据库脚本列表之后执行产品特定代码。提供输入参数以使该例行程序了解正在创建进程的何处执行该例行程序。该值指定刚才调用例行程序执行了哪些脚本。输出参数 actionStatus 的目的是允许该例行程序终止该产品的创建进程。如果 actionStatus 返回值 1,则继续该产品的创建。如果 actionStatus 返回 1 以外的值,则终止该产品的创建。

调用的对话窗口


TAM_PreScriptExecution

文件名

tambuild.kb

语法

TAM_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 - 用来显示错误消息的窗口句柄(如果遇到错误)

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

返回

TAM_PreScriptExecution 中执行的操作的状态(如果有的话)

副作用

说明

该过程为暂挂过程,它允许在执行数据库脚本列表之前执行产品-特定代码。提供输入参数以使该例行程序了解正在创建进程的何处执行该例行程序。该值指定调用例行程序要执行哪些脚本。输出参数 actionStatus 的目的是允许该例行程序终止该产品的创建进程。如果 actionStatus 返回值 1,则继续该产品的创建。如果 actionStatus 返回 1 以外的值,则终止该产品的创建。

调用的对话窗口


TAM_SupportMigration

文件名

tambuild.kb

语法

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

参数

oldVersion - 要从其中进行转移的旧版本

newVersion - 要转移到的新版本

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

返回

如果支持转移,则 supportMigration 设置为 TRUE。

副作用

说明

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

调用的对话窗口