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

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

大纲

$ZEOF

描述

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

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

Caché将$ZEOF设置为下列值：

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

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

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

在本文中，我们将讨论一个我每天都会使用的应用程序，当监控 InterSystems IRIS 平台上的应用程序和集成解决方案并查找所发生的错误时，我就会用到它。

在查找用来记录 InterSystems IRIS、Ensemble 和 Caché DBMS 中对象变化的解决方案时，我发现了一篇关于使用宏进行日志记录的好文章。 受到该文章的启发，我对其介绍的项目进行了分叉，并做了相应调整以满足一些特定需求。 生成的解决方案以面板子类 %CSP.Util.Pane 的形式实现，它具有主命令窗口、“Run”（运行）按钮和已启用的命令配置。

该应用程序允许查看和编辑 global 数组、执行查询（包括 JDBC 和 ODBC）、通过电子邮件发送搜索结果（压缩的 XLS 文件）、查看和编辑对象，以及用几个简单图表来表示系统协议。

该 apptools-admin 应用程序基于 jQuery-UI、UiKit、chart.js 和 jsgrid.js。 欢迎查看源代码。

安装

仓库中详细介绍了所有安装方法。 但是，最简单的方法是使用包管理器命令：

第二十六章 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(零)。

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

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

注意

$ZCHILD与JOB的成功启动

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

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

MSM语言模式下的$ZC

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

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

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

大纲

$ZB

描述

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

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

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

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

文件结束行为

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

ClassMethod TestArr()
{
	s arrRow = [1,2,3,4,5,6,7]
	s size = arrRow.%Size() - 1
	for i = 0 : 1 : size {
		s ii = (size / size) * i // 有size运算, 就报错
		w arrRow.%Get(ii), !
	}
	q ""
}

如上，cache循环中有 size 就报错， iris不报😂

# <center> 第二十四章 Caché 变量大全 $ZA 变量

包含当前设备上最后一次读取的状态。

# 大纲

```java
$ZA
```

# 描述

`$ZA`包含当前设备上最后一次读取的状态。

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

# 注意

## `$ZA`，带终端I / O

`$ZA`被实现为一系列位标志，每个位表示一条特定的信息。下表显示了可能的值、它们的含义，以及如何使用模(`#`)和整数除(`\`)运算符测试它们：

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

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

大纲

$Y

描述

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

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

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

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

注意

NLS字符映射

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

带终端I/O的$Y

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

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

下一篇： 案例: 建立只能使用SQL的用户

IRIS通过认证（Authentication）与授权（Authorization）两项机制控制外部用户对系统及应用、数据资源的可访问性。因此。如需要进行权限控制，则需要通过配置认证和授权进行。

IRIS中的认证 {#2}

认证可以验证任何试图连接到InterSystems IRIS®的用户的身份。一旦通过认证，用户就与IRIS建立了通信，从而可以使用其数据和工具。有许多不同的方法可以验证用户的身份；每种方法都称为验证机制。IRIS 通常被配置为只使用其中一种方式。 支持的认证方式

• 实例认证：通过用户名/密码对登录平台，即密码认证
• LDAP：通过第三方LDAP服务器（如Windows Active Directory ）完成认证
• 操作系统认证：建立操作系统用户-平台用户映射，使用操作系统用户登录平台
• Kerberos：使用Kerberos协议进行认证
• 代理认证：使用自定义的代码实现认证过程

系统服务与认证 {#2.1}

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

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

大纲

$X

描述

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

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

$X是16位无符号整数。

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

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

注意

NLS字符映射

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

带终端I/O的$X

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

亲爱的社区用户，大家好！

InterSystems多模型数据库竞赛 已圆满结束，感谢大家积极参加这次编程马拉松！

现在，我们来宣布此次竞赛优胜者！

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

包含当前进程的用户名。

大纲

$USERNAME

描述

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

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

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

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

通常，$username值是在连接时指定的用户名。但是，如果允许未经验证的访问，则用户终端或ODBC客户端可以连接到Caché，而无需指定用户名。在本例中，$username包含字符串“UnnownUser”。

使用JOB命令创建进程时，它继承与其父进程相同的$USERNAME和$ROLES值。

Hi, 大家好！

我们在开发者社区上发布问题的目的是获得答案。

以下是一个非常简单的准则文档，介绍如何提出问题会获得回答。

当您发布问题时，您需要填写 3 个字段：标题、正文和组。 以及标签。

Hi，大家好!

这又是一个小小的“使用说明”。

假设您需要分享一些包含源代码的东西。 如何在 DC 上完成？

Hi, 大家好！

如果您在 Microsoft Word 或 Google Docs 中准备要在 DC 发布的长帖子，那么有一个非常简单的方法可以将带格式的文本和图片一次添加到 DC 帖子中。

Hi大家好！

有时您需要在帖子中放入带格式的 ObjectScript。

为此，请将代码放入编辑器，将其选中，然后点击 ObjectScript 按钮。

在保存/预览帖子后，代码将突出显示为 ObjectScript。

请参见下面的 gif：

如果您使用 Markdown 编辑器，将代码放入两个标签的范围内就可以突出显示 ObjectScript： 

<pre><code> .... 您的代码... </code></pre>

Hi, 大家好!

截止目前，社区上已发布了大量好文章。 甚至许多问题都有非常精彩的回答 (参见统计). 感谢各位的贡献！

因此，有时值得使用搜索功能来查找回答或最佳实践，或者查找您记得已发布但找不到的帖子。

大家好！

如您所知，我们发布了 InterSystems Open Exchange — 面向 InterSystems 数据平台上的解决方案和工具的市场！

但是如何在 OE 上发布应用程序？

在开始前，我先回答几个基本问题。

生产环境要使用80端口访问服务器，采用直接部署程序的方式，是在Linux服务器上同时部署HealthConnect和Apache。类似的现在想要使用Docker技术，在一台服务器上部署了HealthConnect和Apache容器，该如何配置http.conf文件，使80端口的请求转到HealthConnect上呢？如果这种方式不可行，有没有其他方法呢？

检查Apache工作状态

确认Apache正常工作， apache的版本已经安装路径。

本文介绍InterSystems Web Gateway的安装和配置。

在2018以前的ISC产品中， InterSystems Web Gateway被称为CSP Gateway。， CSP是Cache'的页面技术。InterSystems的产品页面，Web服务等大多是CSP写成的。IRIS发布后CSP Gateway改名成Web Gateway, 但内部的配置文件，说明等等还到处可见CSP Gateway的叫法。在本文里不同的地方有这两个说法别奇怪，他们是一个东西。 IRIS通过它和外部Web服务器连接。 本文的内容适用任何ISC产品的部署，包括页面的选项Cache'. IRIS，HealthConnect, Ensemble等等。它的作用和表现是一样的。 无论您使用的是Cache',IRIS , HealthConnect还是HealthShare, 只有在生产环境中使用HTTP请求，基本上都需要使用Web Gateway。

如果需要更详细的内容，请参考在线文档：InterSystems Web Gateway

什么是Web Gateway

在数据库中，第一个模拟考试空间用作双引号，并且返回消息被转换为单引号。

1.关于本文

就像Caché模式匹配一样，正则表达式也可以在Caché中用来识别文本数据中的模式--只是表达能力更强。本文简要介绍了正则表达式，以及在Caché中如何使用它。这里提供的信息基于各种来源，最值得拜读的是Jeffrey Friedl的《掌握正则表达式》一书，当然还有Caché在线文档。本文无意讨论正则表达式的所有可能性和细节。如果你想了解更多，请参考第5章中列出的信息来源。

使用模式进行文本处理有时会变得很复杂。在处理正则表达式时，我们通常有几种实体：我们正在搜索模式的文本、模式本身（正则表达式）和匹配（文本中与模式匹配的部分）。为了便于区分这些实体，本文档中使用了以下约定。

文本样本以单色字体单独列出，不加引号。

This is a "text string" in which we want to find "something".

除非不明确，否则正文中的正则表达式会以灰色背景显示，如本例。\".*?\".

需要时用不同的颜色突出显示匹配。

这是一个"text string"，我们要在其中找到"something"。

代码样本会显示在如下的文本框里：

用Visual Studio Code来连接代码服务器后，相应的代码在Visual Studio Code的workspace里加载不出来。

# 什么是核心文件？ 它们什么时候有用？

核心文件基础知识

亲爱的社区开发者们！

本周进入 InterSystems多模型数据库竞赛的投票环节！是时候为你所认可的最佳方案投票了！

🔥 投票通道: 点击投票 🔥

如何投票？

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

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

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

大家好！

我想跟大家分享一个个人项目，该项目始于工作中的一个简单需求：“能否知道我们使用了多少个Caché许可证？”

在阅读社区的其他文章时，我发现了一篇David Loveluck写的非常棒的文章：APM——使用Caché History Monitor。

我根据David的这篇文章，开始使用Caché History Monitor并显示所有这些信息。

在面临“选择哪种很酷的技术”这个问题时，我决定使用简单而强大的CSP，这样我的客户可以认识到Caché不仅仅是MUMPS/终端。

在创建了页面以显示许可、数据库增长和CSP会话的历史记录后，我决定为System Dashboard和进程页面创建一个新设计。

我的Caché实例运行得良好。

但是，如果使用IRIS呢？