Analytics 命令创建的系统变量

在通过在 Analytics 的对话框中输入信息或者运行脚本来执行某些命令时,Analytics 会自动创建系统变量。处理后续 Analytics 命令时,您可以使用这些变量和它们包含的值。

如果再次执行相同的命令,则系统变量中的值会被用更新值替换。

Analytics 系统变量列表列出 Analytics 创建的系统变量。

说明

系统变量以及它们包含的值仅在当前 Analytics 会话期间被保留下来。

显示变量的当前值

您可以使用下列任一方法显示 Analytics 项目中所有变量(包括系统变量)的名称和当前值。

  • 导航器中选择变量选项卡
  • 在命令行输入 DISPLAY VARIABLES

递增式编号的系统变量

对于在 Analytics 系统变量中包括 n 的系统变量名而言,如果在组外部执行命令,则 n 始终为 1 — 例如,TOTAL1

如果您使用一个组执行多个命令,则产生的任何系统变量都将基于创建该变量的命令的行号进行编号。一个组中的第一个命令被视为在行号 2 上。

例如:

  • 如果 TOTAL 命令是该组中的第三个命令,则结果包含在变量 TOTAL4 中。
  • 如果第二个 TOTAL 命令是该组中的第五个命令,则结果包含在变量 TOTAL6 中。

如果您需要脚本中同一系统变量的多个版本,则请创建变量组。要了解更多信息,请参考 GROUP 命令

Analytics 系统变量

下表列出了自动创建系统变量的 Analytics 命令以及分配给这些变量的值。

命令 系统变量 分配的值
输出表或文件的任何命令 WRITEn 输出表或文件中的记录数。
任何输出 Analytics 表的命令 OUTPUTFOLDER

导航器中包含输出表的 Analytics 项目文件夹的路径。

此 DOS 样式路径使用 /文件夹名称/子文件夹名称,其中,起始斜杠 (/) 表示概览选项卡中的根级别。

提示

使用 SET FOLDER 命令指定一个不同的输出文件夹或创建一个新的输出文件夹。

COUNT COUNTn 记录数量相符。

DISPLAY VERSION

Analytics 版本号使用格式 major.minor.patch

ACL_Ver_Major 当前正在运行的 Analytics 的主版本。
ACL_Ver_Minor 当前正在运行的 Analytics 的次版本。
ACL_Ver_Patch 当前正在运行的 Analytics 的补丁版本。
ACL_Ver_Type

当前正在运行的 Analytics 的版本:

  • 值 '0' 指示非 Unicode 版
  • 值 '1' 指示 Unicode 版
DUPLICATES GAPDUPn 重复项的总个数。
EVALUATE MLEn

货币单位抽样

最可能误差金额(预计错报)

记录抽样

误差上限频率(计算的偏差率上限)

UELn

货币单位抽样

误差上限金额(错报上限)

EXECUTE RETURN_CODE

使用 Execute 命令运行的外部应用程序或进程返回的代码。

返回码是由外部应用程序或进程生成并发送回 Analytics 以指示外部进程结果的数字。Analytics 不生成返回码。

典型的返回代码是与特定通知或错误消息对应的整型值。例如,返回码“0”可能意味着“操作已成功完成”。返回码“2”可能意味着“系统找不到指定的文件”。

具体返回码及其含义随外部应用程序或进程的不同而异。返回代码的列表(也称为“错误码”或“退出码”)以及它们的含义通常可在相关外部应用程序的文档中找到。返回代码的列表也可在互联网找到。

同步使用 EXECUTE 命令时会创建 RETURN_CODE 变量,但异步使用该命令时则不会创建该变量。

FUZZYDUP GAPDUPn 模糊重复组的总数量。
GAPS GAPDUPn 间隔的总数量。
SEQUENCE WRITEn 序列错误的数量。
SIZE SAMPINTn 所需的样本间隔。
SAMPSIZEn 所需的样本大小。

STATISTICS

说明

如果同时对多个域运行 STATISTICS 命令,则系统变量包含您指定的第一个域的值。

ABSn 首个指定域的绝对值。
AVERAGEn 首个指定域的平均值。
COUNTn 记录数量相符。
HIGHn

首个指定域中第 5 大的值。

第 5 大值是默认设置。使用统计信息对话框中的大/小值数选项可以更改该设置。

说明

Analytics 识别最高值时,不会排除重复值。例如,如果值按降序排列依次为 100、100、99、98,则第三大值是 99,而非 98。

LOWn

首个指定域中第 5 小的值。

第 5 小值是默认设置。使用统计信息对话框中的大/小值数选项可以更改该设置。

说明

Analytics 识别最低值时,不会排除重复值。例如,如果值按升序排列依次为 1、1、2、3,则第三小值是 2,而非 3。

MAXn 首个指定域中的最大值。
MEDIANn 首个指定域中的中位数值。
MINn 首个指定域中的最小值。
MODEn 首个指定域中最常出现的值。
Q25n 首个指定域中的第一四分位数值(下四分位值)。
Q75n 首个指定域中的第三四分位数值(上四分位值)。
RANGEn 首个指定域中的最大值与最小值之间的差。
STDDEVn 首个指定域的标准差。
TOTALn 首个指定域中值的汇总合计。
TOTAL TOTALn 首个指定域中值的汇总合计。
VERIFY WRITEn 数据有效性错误的数量。

其他系统变量

以下变量是系统生成的,而不是由命令创建的:

  • OUTPUTFOLDER当前的 Analytics 项目输出文件夹