第四十九章 Caché 变量大全 ^$ROUTINE 变量

提供例程信息。

第四十七章 Caché 变量大全 ^$JOB 变量

提供系统间IRIS进程(JOB)信息。

大纲

^$JOB(job_number)
^$J(job_number)

参数

• job_number 输入ObjectScript命令时创建的系统特定OBJ编号。每个活动的InterSystems IRIS进程都有一个唯一的作业号。登录到系统会启动一个作业。在UNIX®系统上，作业号是调用InterSystems IRIS时启动的子进程的PID。JOB_NUMBER必须指定为整数；不支持十六进制值。

描述

可以将^$JOB结构化系统变量用作$DATA、$ORDER和$QUERY函数的参数，以获取有关本地InterSystems IRIS系统上是否存在InterSystems IRIS作业的信息。

第四十五章 Caché 变量大全 $ZVERSION 变量

包含一个字符串，描述do命令后面的InterSystems IRIS.line的当前版本。

大纲

$ZVERSION 
$ZV

描述

$ZVERSION包含一个字符串，该字符串显示当前运行的InterSystems IRIS®Data Platform实例的版本。

以下示例返回$ZVERSION字符串：

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

包含格林威治子午线的时区偏移量。

大纲

$ZTIMEZONE
$ZTZ

描述

$ZTIMEZONE可以通过两种方式使用：

• 返回计算机的本地时区偏移量。
• 为当前进程设置本地时区偏移量。

$ZTIMEZONE包含从格林威治子午线偏移的时区（以分钟为单位）。 （格林威治子午线包括整个英国和爱尔兰。）此偏移量表示为-1440到1440范围内的有符号整数。格林威治以西的时区指定为正数；格林威治东部的时区指定为负数。 （时区必须以分钟为单位，因为并非所有时区都以小时为单位。）默认情况下，$ZTIMEZONE初始化为计算机操作系统设置的时区。

第四十一章 Caché 变量大全 $ZSTORAGE 变量

包含进程的最大可用内存。

大纲

$ZSTORAGE
$ZS

描述

$ZSTORAGE包含JOB的进程私有内存的最大内存量(以KB为单位)。此内存可用于局部变量、堆栈和其他表。此内存限制不包括例程目标代码的空间。此内存根据需要分配给进程，例如在分配数组时。

一旦将此内存分配给进程，通常在该进程退出之前不会释放它。但是，当大量内存被使用(例如，大于32MB)然后被释放时，系统间IRIS会尝试在可能的情况下将释放的内存释放回操作系统。

还可以使用$ZSTORAGE设置最大内存大小。例如，以下语句将作业的最大进程专用内存设置为524288 KB：

第三十七章 Caché 变量大全 $ZPARENT 变量

包含当前进程的父进程的ID。

大纲

$ZPARENT
$ZP

描述

$ZPARENT包含使用JOB命令创建当前进程的父进程的ID。如果当前进程不是使用JOB命令创建的，则$ZPARENT包含0(零)。

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

第三十八章 Caché 变量大全 $ZPI 变量

包含pi的值。

大纲

$ZPI

描述

$zpi包含数值常量Pi到小数点后18位的值(3.141592653589793238)。

该值经常用于三角函数，例如正弦函数$ZSIN。

第三十五章 Caché 变量大全 $ZNSPACE 变量

包含当前命名空间名称。

大纲

$ZNSPACE

描述

$ZNSPACE包含当前命名空间的名称。通过设置$ZNSPACE，可以更改当前名称空间。

要获取当前命名空间名称，请执行以下操作：

DHC-APP>SET ns=$ZNSPACE

DHC-APP>WRITE ns
DHC-APP

还可以通过调用%SYSTEM.SYS类的Namespace()方法来获取当前命名空间的名称，如下所示：

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

包含当前I/O设备打开参数。

大纲

$ZMODE
$ZM

描述

$ZMODE包含使用OPEN或USE命令为当前设备指定的参数。返回的字符串包含用于以规范形式打开当前I/O设备的参数。这些参数值由反斜杠分隔符分隔。TCP/IP IO上的开放参数(如“M”)被规范化为“PSTE”。“Y”和“K”参数值始终放在最后。

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

示例

以下示例使用$ZMODE返回当前设备的参数：

第三十一章 Caché 变量大全 $ZIO 变量

包含有关当前终端I / O设备的信息。

$ZIO
$ZI

描述

$ZIO包含有关当前I / O设备的信息。

对于作为终端的终端设备，$ZIO包含字符串TRM:。如果当前终端设备是远程连接的，则$ZIO包含有关远程连接的信息。

对于通过TELNET连接的终端设备，$ZIO包含以下内容：host | port：

第二十九章 Caché 变量大全 $ZERROR 变量

包含上一个错误的名称和位置。

大纲

$ZERROR
$ZE 

描述

$ZERROR包含最新错误的名称，最新错误的位置（在适用的情况下）以及（对于某些错误代码而言）有关导致错误的原因的其他信息。 $ZERROR始终包含相应语言模式的最新错误。

$ZERROR值旨在错误后立即使用。由于$ZERROR值可能不会在例程调用中保留，因此希望保留$ZERROR值以供以后使用的用户应将其复制到变量中。强烈建议用户在使用后立即将$ZERROR设置为空字符串(“”)。

$ZERROR中包含的字符串可以是以下任何一种形式：

第二十七章 Caché 变量大全 $ZEOF 变量

包含指示是否已到达文件末尾的标志。

大纲

$ZEOF

描述

在每次顺序文件读取之后，Caché设置$ZEOF特殊变量以指示是否已到达文件末尾。提供此特殊变量是为了与使用$ZC设备状态检查的MSM例程兼容。

Caché将$ZEOF设置为上次使用的设备的文件状态。例如，如果从顺序文件读取，然后写入主设备，则Caché会将$ZEOF从顺序文件的文件结束状态重置为主设备状态。因此，应该在顺序文件读取之后立即检查$ZEOF值(如果需要，将其复制到变量)。

Caché将$ZEOF设置为下列值：
- –1 文件结束
- 0 不在文件末尾

要使用此功能，必须对顺序文件禁用<ENDOFFILE>错误。

第二十五章 Caché 变量大全 $ZB 变量

包含当前I / O设备的状态信息。

大纲

$ZB

描述

$ZB包含读取操作后特定于当前I / O设备的状态信息

• 从终端，顺序文件或其他基于字符的I / O设备读取时，$ZB包含读取操作的终止字符。它可以是终止符（例如），如果读取操作不需要终止符，则可以是输入数据的最后一个字符；如果需要终止符但未收到终止符，则可以是空字符串（例如，如果读取操作超时）。
• 从磁带等基于块的I / O设备读取数据时，$ZB包含I / O缓冲区中剩余的字节数。写入磁带时，$ZB还包含I / O缓冲区中的字节数。

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

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

包含光标的当前垂直位置。

大纲

$Y

描述

$Y包含光标的当前垂直位置。当字符写入设备时，Caché会更新$Y以反映垂直光标位置。

输出的每个换行符(换行符)(ASCII 10)将$Y递增1。换页符(ASCII 12)将$Y重置为0。

$Y是16位无符号整数。当其值达到65536时，$Y换行为0。换句话说，如果$Y为65535，则下一个输出字符将其重置为0。

第二十一章 Caché 变量大全 $USERNAME 变量

包含当前进程的用户名。

大纲

$USERNAME

描述

$USERNAME包含当前进程的用户名。可以采用以下两种形式之一：

• 当前用户的名称；例如：Mary。如果不允许多个安全域，则返回此值。
• 当前用户的名称和系统地址；例如：Mary@jupiter。如果允许多个安全域，则返回此值。

要允许多个安全域，请转到管理门户，选择系统管理、安全、系统安全、系统范围安全参数。选中允许多个安全域复选框。对此设置的更改将应用于新调用的进程；更改它不会影响当前进程返回的值。

不能使用set命令或new命令修改此值。但是，新的$ROLES还会堆叠当前的$username值。