概述 (DATAFILE ATTRIBUTE 命令)

DATAFILE ATTRIBUTE 使您能够定义自己的数据文件属性并将属性值分配给活动数据集。

用户定义的数据文件属性与数据文件一起保存在数据字典中。
DATAFILE ATTRIBUTE 命令立即生效，无需数据传递即可更新数据字典。
您可以使用 DISPLAY ATTRIBUTES显示数据文件和变量属性的列表。请参阅主题 DISPLAY 以获取更多信息。

基本规范

基本规范为:

ATTRIBUTE 关键字后跟等号 (=) 以及遵循变量命名规则的一个或多个属性名称，每个属性名称后跟括在括号内的带引号的属性值。

或

DELETE 关键字后跟等号 (=) 和已定义属性名称或属性数组的列表。

语法规则

关键字 ATTRIBUTE 和 DELETE 都必须后跟等号 (=)。
每个 ATTRIBUTE 关键字都必须后跟一个遵循变量命名规则的名称以及一个括在括号内的单个带引号的属性值。请参阅主题变量名称以获取更多信息。
DISPLAY DICTIONARY 或 DISPLAY ATTRIBUTES不会显示以 @ 开头的属性名称。它们只能与 DISPLAY @ATTRIBUTES一起显示。
以美元符号 ($) 开头的属性名称保留供内部使用。
所有属性值都必须加引号 (单引号或双引号) ，即使值是数字也是如此。
属性值的长度最多可以为 32,767 个字节。

示例

DATAFILE ATTRIBUTE 
  ATTRIBUTE=OriginalVersion ('1')
            CreationDate('10/28/2004')
            RevisionDate('10/29/2004').

属性数组

如果将括在方括号中的整数附加到属性名称的末尾，那么该属性将解释为属性数组。例如：

DATAFILE ATTRIBUTE
  ATTRIBUTE=FileAttribute[99]('not quite 100').

将创建99个属性 ——FileAttribute[01] FileAttribute[99 ——并将最后一个属性的值设置为“不太接近100”。

数组下标 (括在方括号中的值) 必须是大于 0 的整数。 (数组下标编号以 1 开头，而不是以 0 开头。)
如果属性数组的根名称与现有属性名称相同，那么属性数组将替换现有属性。如果没有为数组中的第一个元素指定值 (下标 [1]) ，那么原始属性值将用于该元素值。

使用 DELETE 关键字时，以下规则适用于属性数组:

如果指定 DELETE 后跟数组根名称，并且方括号中没有值，那么将删除数组中的所有属性。
如果指定 DELETE 的数组名后跟方括号中的整数值，那么将删除指定的数组元素，并且将更改数组中所有后续属性的整数值 (以数字顺序) 以反映数组元素的新顺序。

示例

DATAFILE ATTRIBUTE    
  ATTRIBUTE=RevisionDate('10/29/2004').
 DATAFILE ATTRIBUTE
   ATTRIBUTE=RevisionDate[2] ('10/21/2005').
DATAFILE ATTRIBUTE
  DELETE=RevisionDate[1]. 
DATAFILE ATTRIBUTE 
  DELETE=RevisionDate.

第一个 DATAFILE ATTRIBUTE 命令创建值为 10/29/2004 的属性 RevisionDate 。
第二个 DATAFILE ATTRIBUTE 命令创建了一个名为RevisionDate的数组属性，它取代了同名原始属性。创建两个数组元素 RevisionDate[1 保留 RevisionDate的原始值，而 RevisionDate[2 的值为10/21/2005。
第三个 DATAFILE ATTRIBUTE 命令删除 RevisionDate[1 ，之前名为 RevisionDate[2数组元素成为 RevisionDate[1 （值为 2005年10月21日）。
最后一个 DATAFILE ATTRIBUTE 命令将删除 RevisionDate 数组中的所有属性，因为它指定的数组根名称没有括在方括号中的整数值。