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

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

大纲

$ZMODE
$ZM

描述

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

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

示例

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

/// d ##class(PHA.TEST.SpecialVariables).ZMODE()
ClassMethod ZMODE()
{
	WRITE !,"当前的开放模式有: ",$PIECE($ZMODE,"\")
	WRITE !,"NLS集合为: ",$PIECE($ZMODE,"\",2)
	WRITE !,"网络编码是: ",$PIECE($ZMODE,"\",4)
}

• 终端

DHC-APP> d ##class(PHA.TEST.SpecialVariables).ZMODE()
 
当前的开放模式有: RY
NLS集合为: Latin1
网络编码是: GB18030

• 控制台

d ##class(PHA.TEST.SpecialVariables).ZMODE()

当前的开放模式有: SADY
NLS集合为: Latin1
网络编码是: RAW

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

包含JOB状态信息。

大纲

$ZJOB
$ZJ

描述

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

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

不能使用SET命令修改此特殊变量。尝试执行此操作会导致错误。

示例

以下示例以整数形式返回：

DHC-APP>WRITE $ZJOB
5

以下示例返回每个位值：

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

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

$ZIO
$ZI

描述

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

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

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

这两个值由竖线字符分隔。例如127.0.0.1 | 23。

如果当前设备不是终端：

• 如果是文件，则$ZIO包含文件的完整规范路径名。
• 如果不是文件，则$ZIO包含空字符串。

以下示例返回当前设备信息：

/// d ##class(PHA.TEST.SpecialVariables).ZIO()
ClassMethod ZIO()
{
   SET x = $CASE($ZIO,
				"TRM:":"终端",
				"CON:":"控制台",
				"":"既不是终端也不是文件")
   WRITE "当前设备是 ",x
}

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

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

大纲

$ZHOROLOG
$ZH

描述

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

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

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

示例

本示例输出当前的值。

DHC-APP>WRITE $ZHOROLOG
94657.76444

以下示例说明如何使用计时事件并进行基准测试。本示例通过100次执行对应用程序进行计时，然后找到平均运行时间。

/// d ##class(PHA.TEST.SpecialVariables).ZHOROLOG()
ClassMethod ZHOROLOG()
{
Cycletime
	SET start=$ZHOROLOG
	FOR i=1:1:100 { DO Myapp }
	SET end=$ZHOROLOG
	WRITE !,"平均运行时间是 ",(end-start)/100," 秒"
	QUIT
Myapp
	WRITE !,"执行我的申请"
	; 应用程序代码在这里
	QUIT
}

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

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

大纲

$ZERROR
$ZE 

描述

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

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

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

<error>
<error>entryref
<error> info
<error>entryref info

• 错误名称。错误名称始终以全部大写字母返回，并用尖括号括起来。它可能包含空格。
• 对发生错误的代码行的引用。它由标签名称和距该标签的行偏移量组成，后跟^和程序名称。此f紧跟在错误名称的右尖括号之后。从终端调用时，此信息没有意义，因此不会返回。对最近使用加载到例程缓冲区中的例程的引用。
• 特定于某些错误类型的附加信息(见下表)。此信息与或entryref之间用空格分隔。如果有多个组件要提供信息，则用逗号分隔。

例如，一个程序(名为zerrortest)包含以下例程(名为)，该例程试图写入fred

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

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

大纲

$ZEOS

大纲

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

在通过将设置更改为来禁用流压缩/解压缩之前，必须检查值。如果在处理压缩传入流的末尾之前发出/GZIP=0的命令，则使用会生成错误。如果尚未到达压缩传入流的末尾()，则必须发出块读取命令，直到。

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

示例

以下示例以/GZIP=1(启用压缩)开头。它执行一个循环，测试，并发出读取命令，直到。然后，它可以设置(禁用压缩)：

  OPEN dev:/GZIP=1
  READ block#length
  FOR {QUIT:$ZEOS
       READ x:10 }
  USE dev:/GZIP=0

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

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

大纲

$ZEOF

描述

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

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

Caché将设置为下列值：

• –1 文件结束
• 0 不在文件末尾

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

• 要对当前进程禁用此功能，请调用%SYSTEM.Process类的SetZEOF()方法。
• 若要在系统范围内禁用此功能，请设置类的属性，或者转到管理门户并选择“系统管理”、“配置”、“附加设置”、“兼容性(系统、配置、兼容性设置)”。查看和编辑的当前设置。此选项控制在读取顺序文件时Caché遇到意外文件结尾时的行为。当设置为“true”时，Caché设置特殊变量以指示已到达文件末尾。当设置为“false”时，Caché会发出错误。默认值为“false”。

当到达文件末尾时，读取将返回空字符串，设置和设置，而不是发出错误。

不支持MSM

第二十六章 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 

描述

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

在MSM语言模式中，特殊变量(拼写如下)有不同的用途。用于确定顺序文件读取中的文件结尾。

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

注意

$ZCHILD与的成功启动

设置$ZCHILD并不意味着已成功启动。它只表示进程已创建，参数已成功传递。

例如，如果使用生成一个不存在的例程，则和$ZCHILD都会报告作业命令成功，尽管会立即终止并显示错误。

MSM语言模式下的$ZC

MSM语言模式支持特殊变量的特殊使用。

如果使用类的方法将当前语言模式设置为MSM，则特殊变量将在顺序文件读取期间设置。这提供了与MSM 变量的兼容性。(在所有其他语言模式中，不是在文件读取过程中设置的；是的缩写，具有完全不同的功能。)

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

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

大纲

$ZB

描述

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

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

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

从基于字符的设备或文件中读取时，$ZB和都可以用于返回READ终止字符。对于基于字符的读取，这两个特殊变量非常相似，但不完全相同。对于基于块的读写（例如磁带），请使用; 不支持基于块的读取和写入操作。

文件结束行为

默认情况下，Caché通过发出错误来处理顺序文件的文件结尾；它不会设置。可以以与MSM兼容的方式配置文件结束行为。在这种情况下，遇到文件结尾时，Caché不会发出错误，而是将设置为（空字符串），并将设置为-1。

要配置文件结束处理，请转到管理门户，依次选择“系统”，“配置”，“兼容性设置”。查看和编辑SetZEOF的当前设置。设置为“true”时，Caché将

# <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(数据集就绪)。

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

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

大纲

$Y

描述

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

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

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

可以使用命令为和$Y赋值。例如，可以使用特殊的转义序列来改变物理游标位置，而不更新和的值。在这种情况下，在使用转义序列之后，使用将正确的值分配给和。

注意

NLS字符映射

国家语言支持(NLS)实用程序选项卡定义当前区域设置的和光标移动字符。

带终端I/O的

下表显示了不同字符对的影响。

和USE命令的S(ECRET)协议关闭回显。它还可以防止$Y在输入过程中被更改，因此它指示真实的光标位置。

更改垂直位置的也会更改。更改垂直位置的不会更改。例如，执行换行并递增。相比之下，执行换行符，但不会递增。

因为不会改变，所以可以向终端发送一个控制序列，而仍将反映真实的光标位置。

第二十二章 Caché 变量大全 $X 变量

包含光标的当前水平位置。

大纲

$X

描述

$X包含光标的当前水平位置。将字符写入设备时，Caché会更新$X以反映水平光标位置。

输出的每个可打印字符将$X加1。回车符()或换页符()将$X重置为0(零)。

是16位无符号整数。

• 在非UNICODE系统上，当$X的值达到65536时，它会换行为0。换句话说，如果$X为65535，则下一个输出字符将其重置为0。
• 在UNICODE系统上，在其值达到16384时换行为0(其余两位用于日语音调编码)。

可以使用set命令为和赋值。例如，可以使用特殊的转义序列来改变物理游标位置，而不更新和的值。在这种情况下，在使用转义序列之后，使用将正确的值分配给和。

注意

NLS字符映射

国家语言支持(NLS)实用程序选项卡定义当前区域设置的和光标移动字符。

带终端I/O的$X

下表显示了不同字符对的影响。

这是“IRIS数据库在医疗行业发展”系列课程的第三讲，InterSystems中国技术总监乔鹏为您介绍InterSystems IRIS独立组件。InterSystems IRIS数据平台是全球首款且唯一一款专门设计用于从医疗数据中提取价值的数据平台。

这是“IRIS数据库在医疗行业发展”系列课程的第二讲，InterSystems中国技术总监乔鹏为您介绍InterSystems IRIS强大的分析能力。InterSystems IRIS数据平台是全球首款且唯一一款专门设计用于从医疗数据中提取价值的数据平台。

这是“IRIS数据库在医疗行业发展”系列课程的第一讲，InterSystems中国技术总监乔鹏为您介绍InterSystems IRIS架构。InterSystems IRIS数据平台是全球首款且唯一一款专门设计用于从医疗数据中提取价值的数据平台。

我们不必等待SAM发布才开始规划和试用该API来监控IRIS实例。在以后的文章中，我将更深入地探讨可用的指标及其意义，并提供一些交互式仪表板的示例。首先，我将介绍一下相关背景和一些问题及答案。

IRIS（和Caché）一直在收集自身及其运行平台的数十个指标。收集这些指标来监控Caché和IRIS的方法向来有很多。我发现，很少有安装软件使用IRIS和Caché的内置解决方案。譬如，History Monitor作为性能和系统使用指标的历史数据库，已经推出很长时间了，但它没有简便方法可实时显示这些指标和仪表系统。

IRIS平台解决方案（以及整个业界）正在从仅在一些本地实例上运行的单体式应用程序过渡到“随处”部署的分布式解决方案。在许多用例中，原有的IRIS监控方案并不适用于这些新的模式。InterSystems没有做重复工作，而是将目光投向当前流行的、经过验证的监控和告警开源解决方案。

跨行业用例大多要求具备每秒接收数千或数百万条记录的能力，同时能够支持实时同步查询，例如：股票交易处理、欺诈检测、物联网应用（包括异常检测和实时OEE监控）等。Gartner将这种能力称为“HTAP”（混合事务分析处理）。Forrester等其他公司将其称为Translytics。InterSystems IRIS是功能强大、可扩展、高性能、资源高效的事务分析型数据平台，同时具备内存数据库的高性能以及传统数据库的一致性、可用性、可靠性以及低成本的特性。

本文提供了一个参考架构，作为示例说明基于 InterSystems Technologies（适用于 Caché、Ensemble、HealthShare、TrakCare 以及相关的嵌入式技术，例如 DeepSee、iKnow、Zen 和 Zen Mojo）提供的强大性能和高可用性应用。
Azure 有两种用于创建和管理资源的不同部署模型：Azure Classic 和 Azure Resource Manager。 本文中的详细信息基于 Azure Resource Manager (ARM) 模型。

Amazon Web Services (AWS) 云提供广泛的云基础设施服务，例如计算资源、存储选项和网络，这些都非常实用：按需提供，几秒内就可用，采用即付即用定价的模式。 新服务可得到快速配置，且前期无需支出大量资金。 这使得大企业、初创公司、中小型企业以及公共部门的客户可以访问他们所需的基础设施，从而快速响应不断变化的业务需求。

更新日期：2019 年 10 月 15 日

本文将描述通过ObjectScript包管理器（见https://openexchange.intersystems.com/package/ObjectScript-Package-Manager-2）运行单元测试的过程，包括测试覆盖率测量（见https://openexchange.intersystems.com/package/Test-Coverage-Tool）。

ObjectScript中的单元测试

关于在ObjectScript中编写单元测试，已经有很好的文档，因此我就不再赘述了。您可以在这里找到单元测试教程：https://docs.intersystems.com/irislatest/csp/docbook/Doc.View.cls?KEY=TUNT_preface

最好的做法是将单元测试代码单独放在源代码树中，无论它只是“/tests”还是其他名字。在InterSystems中，我们最终使用/internal/testing/unit_tests/作为我们事实上的标准，这是有意义的，因为测试是内部/非发布的，而且除了单元测试还有其他类型的测试，但这对于简单的开源项目来说可能有点复杂。您可以在我们的一些GitHub仓库中看到这种结构。

从工作流的角度来看，这在VSCode中非常简单，您只需创建目录并将类放在里面。

当您首次使用InterSystems IRIS时，通常只需安装最低安全级别的系统。您输入密码的次数会比较少，这样有利于快速了解和操作开发服务和Web应用程序。而且，最低的安全性有时更便于部署开发项目或解决方案。

然而，有时需要将项目移出开发环境，迁移到一个可能很不友好的互联网环境中。在部署到生产环境之前，需要使用最大的安全设置（即，完全锁定）对其进行测试。这就是我们在本文中将要讨论的内容。

如果想更全面地了解InterSystems Caché、Ensemble和IRIS中的DBMS安全性问题，请阅读我的另一篇文章《在生产环境中安装InterSystems Caché DBMS的相关建议》。

InterSystems IRIS中安全系统的设计概念是针对不同的类别（用户、角色、服务、资源、特权和应用程序）应用不同的安全设置。

可以为用户分配角色。用户和角色可以对资源（数据库、服务和应用程序）拥有不同的读、写和使用权限。用户和角色还可以对数据库中的SQL表拥有SQL权限。

Swift-FHIR-Iris

iOS应用程序支持将HealthKit数据导入InterSystems IRIS医疗版（或任何FHIR资源仓库库）

目录

• 演示目的
• 如何运行此演示
  • 先决条件
  • 安装Xcode
  • 打开SwiftUi
  • 配置模拟器
  • 启动InterSystems FHIR服务器
  • 在iOS应用程序上操作
• 工作原理
  • iOS
    • 如何检查健康数据的授权
    • 如何连接FHIR资源仓库
    • 如何将患者信息保存到FHIR资源仓库
    • 如何从HealthKit中提取数据
    • 如何将HealthKit数据转换为FHIR
  • 后端 (FHIR)
  • 前端
• ToDos

演示目的

目的是创建FHIR协议的端到端演示。

这里的端到端指的是从一个信息源到另一个信息源，例如iPhone。 苹果HealthKit将收集到的健康数据转换为FHIR，再发送到InterSystems IRIS 医疗版存储库。

必须通过web接口访问这些信息。

TL;DR: iPhone -> InterSystems FHIR -> web界面.

如何运行此演示

先决条件

• 客户端 (iOS)
  • Xcode 12
• 服务器和Web应用程序
  • Docker

安装 Xcode

这里没有太多要说的，打开AppStore，搜索Xcode，安装。

InterSystems 2020线上峰会第二周拉开帷幕。首日专题会议涵盖了大量精彩内容，包括38场主题各异的专题会议。我认为有必要回顾一些重大的公告和谈话要点。

索引

下文按顺序列出了数据平台上容量计划和性能系列中的所有帖子。 也列出了我的其他帖子。 我将随着该系列中新帖子的增加进行更新。

现在，InterSystems IRIS、IRIS for Health 和 IRIS Studio 的 2020.4 版发布了预览版本。由于是预览版本，因此我们渴望在下个月正式发布之前了解您对新版本的体验。

我非常高兴地宣布，InterSystems 容器注册表现在可以使用了。 这为客户访问基于容器的版本及预览提供了新的渠道。 所有的社区版镜像都可在公共存储库中找到，且无需登录。 所有完整发布的镜像（IRIS、IRIS for Health、Health Connect、System Alerting and Monitoring、InterSystems Cloud Manager）和实用程序镜像（例如，仲裁器、Web 网关和 PasswordHash）都需要登录令牌，该令牌从 WRC 帐户生成。

各位开发者们大家好！

此前，我向各位介绍了一个非常好用的运行分析监控面板，它能使消息处理过程中的关键指标可视化，例如入站/出站消息的数量和平均处理时间等。 

现在，我想用一项许多人已熟悉的工作流程，来展示一个增强型日志监视器——将警告信息作为Production中的消息来处理。我们可以通过创建路由规则来实现对告警消息的过滤和路由，并运用预先构建的组件（例如电子邮件适配器等）来发送粒度级别的通知。 

如你所知，监视和管理警告信息是确保任何应用程序平稳运行的关键。对诸如HealthShare和IRIS医疗版这样支撑医疗系统运转的一级应用程序和集成引擎来说对告警信息的处理更显得尤为重要。

让我们先来梳理一下InterSystems产品中已经附带的警告信息监视和管理工具:

• 通过名为Ens.Alert的组件，你可以使用警告处理器（Alert Processor）为Production中的各类接口配置自定义警报。
• 系统监视器（System Monitor ）能显示Production关键性能指标的实时状态。
• 日志监视管理器（Log Monitor Manager (^MONMGR) utility ）程序能根据消息日志（现在InterSystems IRIS上称messages.log，以往称cconsole.