第四十四章 Caché 变量大全 $ZTRAP 变量

包含当前错误陷阱处理程序的名称。

大纲

$ZTRAP
$ZT

描述

$ZTRAP包含当前错误陷阱处理程序的行标签名和/或例程名。有三种方法可以设置$ZTRAP:

• SET $ZTRAP=“location”
• SET $ZTRAP=“*location”
• SET $ZTRAP=“^%ET” or “^%ETN”

在这里，位置可以指定为标签(当前例程中的行标签)、^routine(指定外部例程的开始)或label^routine(指定外部例程中的指定标签)。

第四十二章 Caché 变量大全 $ZTIMESTAMP 变量

包含协调世界时间格式的当前日期和时间。

大纲

$ZTIMESTAMP
$ZTS

描述

$ZTIMESTAMP包含协调的通用时间值形式的当前日期和时间。这是世界范围内的时间和日期标准；此值很可能与当地的时间(和日期)值不同。

$ZTIMESTAMP将日期和时间表示为以下格式的字符串：

ddddd,sssss.fff

其中ddddd是一个整数，指定自1840年12月31日起的天数；sssss是一个整数，指定自当天午夜以来的秒数，fff是一个可变的数字，指定小数秒。这种格式类似于$HOROLOG，只是$HOROLOG不包含分数秒。

假设当前日期和时间(世界协调时)如下:

第四十章 Caché 变量大全 $ZREFERENCE 变量

包含当前全局变量global引用。

大纲

$ZREFERENCE
$ZR

描述

$ZREFERENCE包含上次全局引用的名称和下标。这就是所谓裸指针。

注意：最后一个全局引用是最近访问的全局节点。通常，这是对全局的最新显式引用。但是，某些命令可能在内部使用$ORDER函数遍历全局下标(ZWRITE命令就是一个例子)，或者它们可能在内部引用其他全局脚本。发生这种情况时，$ZREFERENCE包含上次访问的全局节点，该节点可能不是为命令指定的全局节点。

第三十六章 Caché 变量大全 $ZORDER 变量

包含下一个全局节点的值。

大纲

$ZORDER
$ZO

描述

$ZORDER包含当前全局引用之后的下一个全局节点的值(在$QUERY序列中，而不是$ORDER序列中)。如果没有下一个全局节点，访问$ZORDER将导致<unfined>错误，指示$ZORDER成功访问的最后一个全局节点。

不能使用SET命令修改此特殊变量。尝试这样做会导致<SYNTAX>错误。

示例

下面的示例使用WHILE循环重复调用$ZORDER以遍历一系列下标节点：

第三十四章 Caché 变量大全 $ZNAME 变量

包含当前例程名称。

大纲

$ZNAME
$ZN

描述

$ZNAME包含在当前进程上执行的例程的名称。通常，这是ZLOAD加载的当前例程。如果当前没有执行任何例程，则$ZNAME包含空字符串。

当ZLOAD加载一个例程时，它将成为所有名称空间中当前进程的当前加载例程。因此，可以使用$ZNAME显示任何名称空间中当前加载的例程的名称，而不仅仅是加载该例程的名称空间。

例程名称区分大小写。

请注意，尝试ZLOAD例程失败会删除当前加载的例程，并将$ZNAME设置为空字符串。

不能使用SET命令修改此特殊变量。尝试这样做会导致错误。

$ZNAME值可以通过以下任何命令设置：

• ZLOAD command
• ZSAVE command
• 无参数ZREMOVE命令(设置为空字符串)
• DO command
• GOTO command with ^routine

第三十二章 Caché 变量大全 $ZJOB 变量

包含JOB状态信息。

大纲

$ZJOB
$ZJ

描述

$ZJOB包含一个数字，其中每个位代表作业状态的一个特定方面。 $ZJOB返回一个整数，该整数由设置的状态位的总和组成。例如，如果$ZJOB = 5，则表示设置了1位和4位。

要测试单个$ZJOB位设置，可以使用整数除(\)和模(#)运算符。例如，$ZJOB\x#2，其中x是位号。下表显示了位的布局(按位的位置值)、其设置和含义：

第三十章 Caché 变量大全 $ZHOROLOG 变量

包含自Caché启动以来经过的秒数。

大纲

$ZHOROLOG
$ZH

描述

$ZHOROLOG包含自最近的Caché启动以来经过的秒数。这是一个计数，与时钟变化和日期范围无关。该值表示为浮点数，表示秒和秒的分数。小数位数与平台有关。 $ZHOROLOG在此小数部分截断尾随零。

不能使用SET命令修改此特殊变量。尝试这样做会导致<SYNTAX>错误。

注意：由于Windows操作系统的限制，使Windows系统进入休眠或待机模式可能会导致$ZHOROLOG返回不可预测的值。此问题不会影响$HOROLOG或$ZTIMESTAMP值。

示例

本示例输出当前的$ZHOROLOG值。

第二十八章 Caché 变量大全 $ZEOS 变量

读取压缩流时包含流结束状态。

大纲

$ZEOS

大纲

$Zeos包含一个布尔值，该值指示是否已接收并处理传入(压缩)流的末尾。如果$Zeos=1，则已接收到压缩数据流的流结束。仅当流压缩/解压缩处于活动状态(/GZIP=1)时，$ZOS值才有意义。可以通过从OPEN或USE命令发出/GZIP命令关键字来激活流压缩/解压缩。

第二十六章 Caché 变量大全 $ZCHILD 变量

当前进程的包含最后一个子进程的ID。

DHC-APP>job ##class(PHA.TEST.SpecialVariables).ZB()

DHC-APP>w $zchild
16636
DHC-APP>job ##class(PHA.TEST.SpecialVariables).ZB()

DHC-APP>w $zchild
5412

大纲

$ZCHILD
$ZC 

描述

$ZCHILD包含当前进程使用JOB命令创建的最后一个子进程的ID。如果进程没有使用JOB创建子进程，则$ZCHILD返回0(零)。