第二十四章 Caché 变量大全 $ZA 变量
# <center> 第二十四章 Caché 变量大全 $ZA 变量
包含当前设备上最后一次读取的状态。
# 大纲
```java
$ZA
```
# 描述
`$ZA`包含当前设备上最后一次读取的状态。
不能使用`SET`命令修改此特殊变量。尝试这样做会导致`<SYNTAX>`错误。
# 注意
## `$ZA`,带终端I / O
`$ZA`被实现为一系列位标志,每个位表示一条特定的信息。下表显示了可能的值、它们的含义,以及如何使用模(`#`)和整数除(`\`)运算符测试它们:
位 | 测试| 含义
---|---|---
0 |`$ZA#2`| `<CTRL-C>`已到达,无论是否启用中断。
1 |`$ZA\2#2`| 读取超时。
2 |`$ZA\4#2`| I/O错误。
8 |`$ZA\256#2`| Caché检测到无效的转义序列。
9 |`$ZA\512#2`| 硬件检测到奇偶校验或成帧错误。
11 |`$ZA\2048#2`| 进程已与其主设备断开连接。
12 |`$ZA\4096#2`|对于COM端口:CTS(清除发送)。从调制解调器发送到其计算机的信号,表示传输可以进行。对于TCP设备:设备在服务器模式下运行。
13 |`$ZA\8192#2`|对于COM端口:DSR(数据集就绪)。从调制解调器发送到其计算机的信号,表示调制解调器已准备好运行。对于TCP设备:设备当前处于与远程主机通话的已连接状态。
14 |`$ZA\16384#2`| 如果为真,则设置振铃。
15 |`$ZA\32768#2`| 载波检测设置为真。
16 |`$ZA\65536#2`|CE_BREAK COM端口错误状态。
17 |`$ZA\131072#2`| CE_FRAME COM端口错误状态。
18 |`$ZA\262144#2`| CE_IOE COM端口错误状态。
19 |`$ZA\524288#2`| CE_OVERRUN COM端口错误状态。
20 |`$ZA\1048576#2`| CE_RXPARITY COM端口错误状态。
21 |`$ZA\2097152#2`| CE_TXFULL COM端口错误状态。
22 |`$ZA\4194304#2`| TXHOLD通讯端口错误状态。在`ClearCommError()`返回的错误掩码中,如果下列任一字段为真,则设置为:fCtsHold、fDsrHold、fRlsdHold、fXoffHold、fXoffSent。
`24 & 25 |$ZA\16777216#4|`Caché请求DTR(数据终端就绪)设置:0 = DTR关闭。 1 = DTR =开。 2 = DTR握手。设置为(1)时,表示已准备好发送和接收数据。
尽管`$ZA`显示的许多条件都是错误,但它们不会通过捕获`$ZTRAP`来中断程序的流程。 (具有中断功能的`<CTRL-C>`会陷阱到`$ZTRAP`。)与这些错误有关的程序在每次读取后必须检查`$ZA`。
COM端口使用位12至15、24和25报告调制解调器控制引脚的状态。无论端口的Caché调制解调器控制检查是打开还是关闭,都可以执行此操作。用户可以通过设置`OPEN`或`USE`命令`portstate`参数(具体为字节8)来启用或禁用COM端口的`$ZA`错误报告。如果启用了错误报告,则端口错误状态将在位16到22中报告。
可以使用`%SYSTEM.Process`类的`DisconnectErr()`方法来检测当前进程的调制解调器断开连接。可以通过设置`Config.Miscellaneous`类的`DisconnectErr`属性来建立系统范围的默认行为。
## 带磁带I / O的$ZA
对于磁带I / O,`$ZA`中的位字段指示错误和特殊情况。在每个引用磁带设备的命令之后,Caché更新`$ZA`。
下表显示了磁带I/O的`$ZA`位的含义。请注意Trap列。字母Y表示`<MAGTAPE>`错误。如果设置了`$ZTRAP`变量,则Caché会发出相关的`$ZTRAP`错误代码。
位 | 值| 陷阱 |含义注意
---|---|---|---
0 |1| Y| 逻辑错误(读写混合),用于在读取和写入之间切换,或者关闭然后打开设备,或者发出前进空格、退格键或倒带命令。
2 |4| N| 写保护始终反映`OPEN`或`USE`只读参数的状态。此位不反映磁带的物理写保护状态(写环或写锁定),因为许多版本的UNIX®在尝试实际写入磁带之前不会通知磁带写保护。如果尝试打开不带只读参数的写保护9磁道磁带,则Caché会设置此位并以只读方式打开磁带。未出现错误。
3 |8| Y| 错误摘要错误摘要是导致Caché错误的所有条件(在Trap下标记为Y的所有条件)的逻辑或。
5 |32| N| 磁带的开始[BOT]在UNIX®系统上,该位在倒带时设置,并在打开磁带时清除。
6 |64| N| On Line
7 |128| Y|控制器或驱动器错误。
10 |1024| N|磁带结尾[EOT]在大多数UNIX®平台上不支持。
14 |16384| Y| Tape MarkCaché在遇到Read,Read Block,Forward Space或Backspace上的磁带标记时将Tape Mark位置1。这会将“错误摘要”位置1,并在“读取”,“读取标签”和“读取块”上将陷阱陷阱为`$ZTRAP`。
15 |32768| Y| 磁带未准备好
一些位指示错误条件,而另一些位指示不一定产生错误的条件。为了监视这些非错误情况,程序必须在每次磁带操作后测试`$ZA`的相应位。例如,如果程序可能写在磁带末尾之外,则它必须检查位10(磁带末尾)。
要测试某个位,请将`$ZA`除以表中该位列出的值,然后执行模2运算。例如,以下命令检查是否设置了位14(磁带标记):
```java
USE 47 IF $ZA\16384#2 {DO Endfile}
```
其中16384等于2等于14的幂,而#2表示模2运算。由于任何等于0的幂等于1,因此无需除数即可检查位0(逻辑错误)。例如:
```java
USE 47 GOTO Logerr:$ZA#2
```