使用声明

本节先描述使用声明,然后提供有关如何编写该声明的详细信息:

背景知识

使用声明允许您方便地引用独立生成的部件中的数据区和函数。例如,程序可以发出使用声明来简化对数据表、库或表单组的引用,但仅当那些部件对程序部件可见时才如此。有关可视性的详细信息,请参阅对部件的引用

在大多数情况下,无论使用声明是否生效,都可以从一个部件中引用另一部件中的数据区和函数。例如,如果您正在编写程序,并且没有名为 myLib 的库部件的使用声明,则可以按照以下方式访问名为 myVar 的库变量:
  myLib.myVar
但是,如果在使用声明中包括了库名,则可以按照如下方式引用该变量:
  myVar

仅当符号 myVar 对于程序的每个全局变量和结构项来说都是唯一的时,前面的短格式引用才有效。(如果符号不是唯一的,则会发生错误。)并且,仅当局部变量或参数不同名时,符号 myVar 指的才是库中的项。(局部数据区优先于同名的程序全局数据区。)

在下列情况下,使用声明是必需的:
  • 使用给定 formGroup 部件中的任何表单的程序或库必须要有该 formGroup 部件的使用声明
  • formGroup 部件必须要有程序或库所必需的但未嵌入在 formGroup 部件中的表单的使用声明
  • 如果在 EGL 源文件的顶部(而不是完全在容器内部,即程序、页面处理程序或库)声明了一个函数,仅当出现下列情况时,该函数才能调用库函数:
    • 容器包括引用库的 use 语句
    • 在调用函数中,属性 containerContextDependent 设置为 yes

可以通过包名和/或库名来对使用声明中指定的每个名称进行限定。

在程序部件或库部件中

程序或库中的每个使用声明都必须位于任何函数外部。声明的语法如下所示:


程序或库部件中的使用声明的语法图
dataTablePartName
对程序或库可见的 dataTable 部件的名称。

对于在程序属性 msgTablePrefix 中引用的 dataTable 部件来说,使用声明中的引用不是必需的。

不能在使用声明中覆盖 dataTable 部件的属性。

有关 dataTable 部件的概述,请参阅 DataTable 部件

libraryPartName
对程序或库可见的库部件的名称。

不能在使用声明中覆盖库部件的属性。

有关库部件的概述,请参阅类型为 basicLibrary 的库部件类型为 nativeLibrary 的库部件

formGroupPartName
对程序或库可见的 formGroup 部件的名称。有关表单组的概述,请参阅 FormGroup 部件

使用给定 formGroup 部件中的任何表单的程序必须要有该 formGroup 部件的使用声明。

表单级别的属性不会被覆盖。例如,如果在表单中指定属性,如 validationBypassKeys,则表单中的值在运行时起作用。然而,如果在表单中未指定表单级别的属性,则情况如下所示:
  • EGL 运行时使用程序的使用声明中的值
  • 如果未在程序的使用声明中指定任何值,则 EGL 运行时使用表单组中的值(如果有的话)

下列属性允许您在特定程序访问表单组时更改行为。

helpGroup = no, helpGroup = yes
指定是否将 formGroup 部件用作帮助组。缺省值为 no
validationBypassKeys = [bypassKeyValue]
标识一个用户击键,该击键导致 EGL 运行时跳过输入字段验证。此属性对于保留用于快速结束程序的击键而言很有用。每个 bypassKeyValue 选项如下所示:
pfn
F 或 PF 键的名称,包括介于 1 与 24 之间(包括 1 和 24)的数字。
注: PC 键盘上的功能键通常是 f 键,如 f1,但 EGL 使用 IBM® pf 术语,所以 f1(例如)被称为 pf1。

如果要指定多个键,则用逗号来隔开它们。

helpKey = "helpKeyValue"
标识一个用户击键,该击键使 EGL 运行时向用户显示帮助表单。helpKeyValue 选项如下所示:
pfn
F 或 PF 键的名称,包括介于 1 与 24 之间(包括 1 和 24)的数字。
注: PC 键盘上的功能键通常是 f 键,如 f1,但 EGL 使用 IBM pf 术语,所以 f1(例如)被称为 pf1。
pfKeyEquate = yes, pfKeyEquate = no
指定当用户按下大编号功能键(PF13 至 PF24)时注册的击键是否与用户按下编号小于 12 的功能键时注册的击键相同。缺省值为 yes。有关详细信息,请参阅 pfKeyEquate

在 formGroup 部件中

在 formGroup 部件中,使用声明引用在表单组外部指定的表单。此类声明允许多个表单组共享同一个表单。

formGroup 部件中的使用声明语法如下所示:


formGroup 部件中的使用声明的语法图
formPartName
对表单组可见的表单部件的名称。有关表单的概述,请参阅表单部件

不能在 formGroup 部件的使用声明中覆盖表单部件的属性。

在 pageHandler 部件中

pageHandler 部件中的每个使用声明都必须位于任何函数外部。声明的语法如下所示:


pageHandler 部件中的使用声明的语法图
dataTablePartName
对 pageHandler 部件可见的 dataTable 部件的名称。

不能在使用声明中覆盖 dataTable 部件的属性。

有关 dataTable 部件的概述,请参阅 DataTable 部件

libraryPartName
对 pageHandler 部件可见的库部件的名称。

不能在使用声明中覆盖库部件的属性。

有关库部件的概述,请参阅库部件

相关参考
pfKeyEquate

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.