第二十二章 P - R 开头的术语

程序员模式 (programmer mode)

系统

所有程序开发活动进行的模式。在程序员模式下，你从 IRIS 提示符启动程序，并且每个运行的程序结束后提示符会重新出现。程序员模式涵盖了 IRIS 环境及其所有可调用的程序，包括 SQL 开发环境。在程序员模式下，你可以创建用户随后在应用程序模式下运行的应用程序。

项目 (project)

系统

用户定义的相关源文档（如例程或类定义）列表。Visual Studio Code 使用项目来帮助组织应用程序开发。

属性 (property)

对象（Objects）

表示与类相关联的特定特性的一个数据元素。该类的每个对象包含属性的字面值或指向表示数据的另一个对象的引用。一个类的所有属性共同表示其状态。

属性排序 (property collation)

对象（Objects）

属性排序通过在属性定义中指定的排序，覆盖属性数据类型提供的默认转换。

属性方法 (property method)

对象Objects

生成的方法，用于控制属性的行为。在编译时，属性名称与其数据类型和属性行为类的行为方法连接，创建一组完整的属性方法。

公有 (public)

对象（Objects）

公有类成员可以被任何类看到和使用。

以 Q 开头的术语

查询 (query)

通用

满足指定条件的数据请求。

第二十一章 P 开头的术语

主持久超类 (primary persistent superclass)

对象（Objects）

一个类的主要持久超类决定了该类的持久行为。默认情况下，主要持久超类是超类列表中最左侧的持久超类。通常，与相同主要持久超类相关联的类的所有数据一起存储。

主卷 (primary volume)

系统

卷集中的第一个卷或唯一卷。

主设备 (principal device)

系统

与进程相关联的输入/输出设备，通常是终端或计算机键盘和显示器。对于后台进程，你可以在 JOB 命令中分配主设备，或者在系统配置编辑器中将其设置为父进程的主设备。如果不以这些方式设置设备，则后台进程的默认设备是空设备（null device）。

UNIX®: 对于交互用户，是用户输入 IRIS 的终端。它与 UNIX® 分配给该用户的主要输入设备相同。对于后台进程，主设备可以通过 JOB 命令分配，默认是 /dev/null。

优先级设置 (priority setting)

系统

在 UNIX® 中，优先级是系统级别定义作业分配系统资源和响应的顺序。

优先级 (priority)

系统

批处理作业或系统守护进程的重要性。作为平衡系统资源的一种方式，你可以调整作业或守护进程的优先级，以实现系统的最佳整体性能。

私有 (private)

对象（Objects）

私有类成员只能被该类的方法访问。方法和属性都可以是私有的。

第二十章 P 开头的术语

通过引用传递 (passing by reference)

系统

一种传递参数地址而不是值的方式。这允许访问实际的变量，使得传递给的方法、函数或例程可以更改变量的实际值。

通过值传递 (passing by value)

系统

传递参数值的一种方式。这提供了变量的副本。因此，传递给的方法、函数或例程无法更改变量的实际值。

模式匹配表 (pattern match table)

系统

内部表，用于指示 IRIS 是否将字符视为字母、标点、数字或控制字符。

权限 (permission)

系统

在资源上执行某项活动的能力说明。对于数据库资源，可用的权限有读取（Read）和写入（Write）。对于服务、应用程序或管理操作，可用的权限是使用（Use）。

持久类 (persistent class)

对象（Objects）

持久类的对象可以存储在数据库中。持久类从 %Persistent 类继承持久接口，以管理数据的存储和检索。

持久接口 (persistent interface)

对象（Objects）

持久接口是一组用于存储和检索对象的方法。

点对点链接 (point-to-point link)

通用

连接两台计算机的网络链接，一端连接一台计算机，另一端连接另一台计算机。

多态 (polymorphism)

对象（Objects）

在运行时，对重写方法的引用根据对象的类型进行分派。

第十九章 O - P 开头的术语

OID

对象（Objects）

请参见对象标识符（object identifier）。

单向外连接 (one-way outer join)

InterSystems SQL

程序员定义的连接，指定连接条件中第一个表为源表，并在输出表中包含源表的所有行，即使第二个表中没有匹配项。源表从第二个表中提取相关信息，但不会因为第二个表中缺少匹配项而牺牲自身的行。

开放数据库连接 (Open Database Connectivity, ODBC)

通用

微软的开放数据库连接（ODBC）为 Windows 上的数据访问提供了一个标准接口。

基于操作系统的认证 (Operating-System–based authentication)

系统

一种认证机制，IRIS 接受已成功通过操作系统认证的用户身份。IRIS 用户账户必须与操作系统账户名称匹配。此外，认证后，用户的活动受到账户角色的限制。

OREF

对象（Objects）

请参见对象引用（object reference）。

外发锁 (outgoing lock)

系统

由本地客户端计算机上的进程对远程服务器计算机上的项目发出的锁。它也被称为客户端锁，因为本地计算机是客户端。当你从终端运行 LOCKTAB 工具或在系统操作实用工具中运行锁定工具时，此锁会在锁表显示中以发出锁定请求的进程 PID 前带有星号 (*) 显示。

第十七章 O 开头的术语

以 O 开头的术语

对象 (object)

对象（Objects）

对象是一个逻辑实体，封装了表示特定项目的所有数据以及操作这些数据的接口。

对象类 (object class)

对象（Objects）

对象类代表一个特定实体。它可以具有属性，并且可以被直接实例化。

对象代码 (object code)

系统

IRIS 编译器生成的最低级别代码。该代码实际上由解释器执行。

对象标识符 (object identifier)

对象（Objects）

对象标识符（OID）在整个数据库中唯一地标识磁盘上的一个对象。OID 在对象的生命周期内有效，如果对象被删除，OID 不能被重用。

对象模型 (object model)

对象（Objects）

对象模型描述了应用程序的需求以及其开发中使用的类层次结构。

对象引用 (object reference)

对象（Objects）

对象引用指向当前内存中的特定对象。对象引用仅在对象实例化或打开到关闭期间有效。

ObjectScript

系统

IRIS 支持的编程语言之一。

ObjectScript 查询 (ObjectScript query)

对象（Objects）

ObjectScript 查询使用 ObjectScript 代码查询数据库。

第十七章 M - N 开头的术语

方法 (method)

对象（Objects）

可以在对象上调用的操作。

挂载，已挂载 (mount, mounted)

系统

挂载数据库是指将其显式连接到一个IRIS 实例，从而使其内容立即可用。处于此状态的数据库称为已挂载。

多维属性 (multidimensional property)

对象（Objects）

多维属性像数组节点一样工作。多维属性没有任何关联的属性方法，不能使用点语法访问，也不会被投射到 SQL 或 Java。

多路链接 (multidrop link)

通用

连接两台以上计算机的网络硬件。

多重继承 (multiple inheritance)

对象（Objects）

多重继承允许一个类拥有多个超类。一个类从其每个超类继承特性和类成员。

以 N 开头的术语

命名空间 (namespace)

系统

命名空间是一个逻辑实体，提供对物理存储在数据库中的数据和代码的访问。对数据库对象的引用是通过命名空间逻辑上进行的，而不是对物理数据库位置进行引用。命名空间映射指定了全局的数据库位置，因此用户和代码只需简单地引用命名空间中的全局，而无需关心其中数据的物理位置。例如，命名空间映射允许你将来自多个数据库的对象收集到单一的命名空间中，这个命名空间作为一个单一的参考框架，就好像它们都被存储在一起一样。

有关命名空间名称的信息，请参见“配置命名空间”。

第十六章 L - M 开头的术语

锁表 (lock table)

系统

IRIS 内部的表，存储所有由进程发出的 LOCK 命令。你可以使用系统查看器查看此表。

日志文件 (log files)

系统

系统管理员目录中的文件，包含关于系统操作、错误和指标的消息。这些包括消息日志（messages.log）、系统监视器日志（SystemMonitor.log）、警报日志（alerts.log）、初始化日志（iboot.log）和日志历史记录日志（journal.log）。有关这些日志文件的信息，请参见“监控日志文件”。

逻辑格式 (logical format)

对象（Objects）

对象属性的逻辑格式是在内存中使用的格式。所有的比较和计算都是基于这种格式进行的。

登录角色 (login role)

系统

通过认证到IRIS 时与用户关联的任何角色（而不是之后关联的角色）。

以 M 开头的术语

宏预处理器 (macro preprocessor)

ObjectScript

ObjectScript 编译器的一部分，将宏代码转换为可用的 ObjectScript 代码。

宏源代码 (macro source code)

ObjectScript

编写例程和方法的最高、最灵活和最宽松的代码级别。

第十五章 K - L 开头的术语

日志记录 (journaling)

系统

一种功能，系统管理员可以选择启用，导致 IRIS 在日志文件中记录所有或选定全局的更改。如果发生系统故障，可以将这些更改向前滚动。也就是说，在恢复期间，可以将整个事务重新应用到数据库。另请参见写入镜像日志记录 (Write Image Journaling)。

以 K 开头的术语

密钥分发中心 (KDC)

系统

密钥分发中心（Key Distribution Center，KDC）是 Kerberos 安装的一部分，是确保所有参与方正确认证的中央 Kerberos 服务器。具体来说，KDC 是可信第三方 Kerberos 服务器的一部分，负责生成构成票据授予票据（TGT）和服务票据（Service Ticket）基础的密钥。在 Windows 系统中，密钥分发中心是 Windows 域控制器（Domain Controller，DC）的一部分，有时也称为该名称。这两个缩写的相似性纯属巧合。

Kerberos

系统

Kerberos 是由麻省理工学院（MIT）的 Athena 项目开发的可信第三方认证系统。它通过建立一个认证信息数据库，允许对用户或应用程序（统称为主体，principals）进行认证。该数据库是安全的（因此是可信的），并且与执行认证的任何两个主体分离（这就是为什么它是第三方系统）。

第十四章 I - J 开头的术语

InterSystems IRIS 存储 (InterSystems IRIS storage)

对象（Objects）

持久对象的默认存储类型。如果你使用 IRIS 存储，则无需指定任何存储数据的细节，并且你的类会自动投射到 SQL。

InterSystems SQL

SQL

SQL 是 IRIS 的高级关系接口。SQL 完全集成了IRIS 的对象功能，共享其类字典用于表定义，并使用作为类定义的高级数据类型。

InterSystems SQL 服务器 (InterSystems SQL server)

SQL

SQL 服务器处理来自客户端应用程序的 SQL 请求，以对IRIS 数据库应用查询和更新、错误日志记录以及其他与 SQL 相关的任务。这是 ODBC 和 JDBC 驱动程序连接的服务器进程。

InterSystems SQL 存储 (InterSystems SQL storage)

对象（Objects）

SQL 存储提供了一种通过对象持久接口使用 SQL 插入、更新和检索数据的机制。如果类的存储定义指定了 %Storage.SQL 存储类并包含 SQL 映射部分，则这些类使用 SQL 存储。

输入输出转换 (I/O translation)

系统

国家语言支持设施，由一组表组成，用于在计算机的字符集和特定设备的字符集之间进行转换。另见语言配置。

InterSystems IRIS、InterSystems IRIS for Health 和 HealthShare Health Connect 的最新扩展维护版本现已发布。

✅ 2024.1.3

版本 2024.1.3 修复了 2024.1.x 上一版中的 bug，包括针对最近发布的以下提醒的修复 – 提醒：在执行特定的操作时，数据库和日志文件中引入了无效数据…。

您可以在以下页面上找到详细的变更列表和升级核对清单：

• InterSystems IRIS
• InterSystems IRIS for Health
• HealthShare Health Connect

如何获取软件

软件以经典安装包和容器镜像两种形式提供。有关可用安装程序和容器镜像的完整列表，请参阅支持的平台网页。

InterSystems IRIS 和 InterSystems IRIS for Health 的完整安装包可从本 WRC 的 InterSystems IRIS 数据平台完整套件页面获取。 HealthShare Health Connect 套件可从 WRC 的 HealthShare 完整套件页面获取。

容器镜像可通过 InterSystems 容器注册表获取。

这些版本中的所有套件和容器的编号为：

• 2024.1.3.456.0

第十三章 I 开头的术语

安装目录 (install-dir)

系统

在通用引用 IRIS 安装目录时，文档使用术语 install-dir。在示例中，文档使用 C:\MyIRIS\。章节“默认安装目录”描述了 IRIS 在所有受支持操作系统上的安装位置。

实例 (instance)

对象（Objects）

表示特定实体的类的实现。术语“实例”和“对象”可以互换使用。

实例认证 (Instance Authentication)

系统

本地认证系统：用户会被提示输入密码，输入的密码的哈希值会传递到 IRIS 服务器，并与服务器中存储的现有密码的哈希值进行比较。如果两个值相同，IRIS 将授予用户对其有权限的资源的访问权限。

此机制在管理门户中列为“密码认证”。

实例方法 (instance method)

对象（Objects）

从类的特定实例调用的方法，并执行与该实例相关的某些操作。

实例化 (instantiate)

对象（Objects）

将对象实例放入内存中，以便程序可以对其进行操作。

中间源代码 (intermediate source code)

ObjectScript

IRIS 中可用的标准三代语言（3GL）ObjectScript 源代码。中间代码由 IRIS 编译器从宏源生成。在这个阶段，所有预处理器语法（包括嵌入式 SQL）都已解析，例程仅包含纯源代码。

第十二章 I 开头的术语

以 I 开头的术语

被识别 (identified by)

对象（Objects）

当一个类在逻辑上依赖于另一个类的存在时，它就被另一个类所识别。

识别关系 (identifying relationship)

对象（Objects）

识别关系定义了两个类之间的关系，其中一个类依赖于另一个类的存在。

身份 (identity)

对象（Objects）

对象的身份或 ID 在其范围内唯一地标识该对象。

idkey

对象（Objects）

用于指定对象 ID 内容的索引。任何在 idkey 中使用的属性在对象生命周期内必须保持静态。

隐式全局引用 (implicit global reference)

系统

请参见 映射全局引用（Mapped Global Reference）。

隐含命名空间 (implied namespace)

系统

当你在扩展全局引用中使用目录或目录和系统名称时，IRIS 内部创建的命名空间。

包含文件 (include file)

ObjectScript

包含定义的文件，可在 ObjectScript 源代码编译的预处理阶段使用，以扩展宏源例程并确定是否应包含可选的代码行。它们还可以用于在多个例程中包含一段公共代码块，节省调用公共子例程的开销。

传入锁 (incoming lock)

系统

由远程客户端计算机上的进程对本地计算机上的项目发出的锁。

第十一章 F - H 开头的术语

文件流 (file stream)

对象（Objects）

文件流提供了一个接口，用于在外部文件中操作和存储大量基于文本或二进制的数据。IRIS 的流接口可以在 ObjectScript、SQL 和 Java 中用于操作文件流。

最终类 (final class)

对象（Objects）

不能被扩展或子类化的类。

最终方法 (final method)

对象（Objects）

不能被重写的方法。

最终属性 (final property)

对象（Objects）

不能被重写的属性。

外键 (foreign key)

InterSystems SQL

外键约束表中的一列指向另一表中的另一列。为第一列提供的值必须存在于第二列中。

基础 (foundation)

医疗保健（Health care）

在 InterSystems IRIS for Health™ 和 HealthShare® 中，启用了医疗保健互操作性的命名空间。

以 G 开头的术语

全局 (global)

系统

多维存储结构。全局在 IRIS 数据库中使用平衡树技术实现。

全局数据库 (globals database)

系统

IRIS 的基础逻辑和物理数据存储结构，其中所有数据都存储在称为“全局”的多重下标数组系统中。

全局目录 (global directory)

系统

包含全局数据库的目录。

第十章 E - F 开头的术语

字节序 (endian)

系统

大端字节序（big-endian）和小端字节序（little-endian）指的是系统存储多字节元素字节的顺序。IRIS 支持大端和小端系统。它还包括一个实用工具 cvendian，用于在两种字节序之间转换数据库。有关 cvendian 的详细信息，请参见“使用 cvendian 在大端和小端系统之间转换”。

企业缓存协议 (Enterprise Cache Protocol, ECP)

系统

IRIS 的内部网络系统。ECP 网络允许在包含可配置数量节点和各种硬件及软件配置的分布式数据库环境中使用 IRIS。

枚举属性 (enumerated attribute)

对象（Objects）

枚举属性允许属性值具有多选项。此类属性的值必须是预定选项之一。

独占锁 (exclusive lock)

通用

独占锁防止其他进程查看或编辑指定的数据。

如果在打开对象时使用独占锁，当对象被打开时会获取独占锁，并在对象关闭时释放该锁。

显式引用 (explicit reference)

系统

也称为扩展引用。通过完整定义全局所在的系统和命名空间来创建的全局引用。

表达式方法 (expression method)

对象（Objects）

可以在类编译器生成的代码中内联放置的对象方法。

扩展全局引用 (extended global reference)

系统

也称为显式引用。

[toc]

第九章 D - E 开头的术语

显示格式 (display format)

对象（Objects）

属性的显示格式是用于显示和输入数据的格式。

分布式数据库 (distributed database)

系统

存储在网络中多台计算机上的数据库。当在分布式数据库环境中使用IRIS 时，位于一台计算机上的 ObjectScript 例程可以在网络中其他计算机的文件保护限制内访问全局。

DMNNET

系统

处理来自网络的传入全局请求的IRIS 进程。它是在系统状态（%SS）显示或系统操作实用工具中的进程面板上表示网络守护进程的名称。

点语法 (dot syntax)

对象（Objects）

点语法允许获取和设置属性值以及执行方法。它还允许从引用对象访问被引用和嵌入对象的属性和方法。

以 E 开头的术语.

可嵌入类 (embeddable class)

对象（Objects）

从可嵌入（序列化）类派生的对象可以在内存中独立存在，但在存储到数据库时，只作为持久对象中的数据存储。参见 %SerialObject 方法。

内嵌 HTML (embedded HTML)

ObjectScript

直接嵌入在 ObjectScript 方法或宏例程中的 HTML。内嵌 HTML 必须包含在 &html<> 语句中。

内嵌对象 (embedded object)

对象（Objects）

可嵌入类的实例。

第八章 D 开头的术语

数据集 (dataset)

通用

表示IRIS中目录名称或目录和系统名称的逻辑实体。

数据源名称 (Data Source Name, DSN)

ODBC

数据源名称标识特定服务器系统上的特定数据库。

数据类型 (data type)

对象（Objects）

属性的数据类型决定其行为、验证要求以及如何投射到 SQL 和 Java 等客户端。

数据类型类 (data type class)

对象（Objects）

数据类型是具有其 DATATYPE 类关键字设置的类，支持数据类型接口。该接口包括多个用于验证和 SQL 互操作性的操作。

DDL 导入工具 (DDL import utility)

对象（Objects）

IRIS 关系实用库中包含的一个工具，用于将 DDL 文件导入到IRIS。该工具会自动将相应的定义添加到类字典中。

深度保存 (deep save)

对象（Objects）

深度保存会保存一个对象及其引用的所有对象，如类参考内容中描述的 %Persistent.%Save 方法。

默认数据集 (default dataset)

系统

命名空间执行命令和接收任何未独立映射全局的目录。

默认启动例程 (default start routine)

系统

用户登录时自动运行的默认启动例程。

依赖关系 (dependent relationship)

对象（Objects）

定义父表每行的子表的父子关系。

第七章 C - D 开头的术语

当前设备 (current device)

系统

处理 I/O 命令的设备。当你登录时，当前设备是你的主设备，通常是你登录时使用的终端或个人计算机。

当前目录 (current directory)

通用

你当前工作的目录。

基于游标的 SQL (cursor-based SQL)

SQL

一种嵌入式 SQL 查询类型，打开一个游标来处理查询。当你的应用程序需要访问多行数据时，必须使用游标。游标像一个指针——它专注于访问和处理一行数据，然后移动到序列中的下一行。

游标 (cursor)

SQL

在多行数据中向前移动的迭代器。

自定义存储 (custom storage)

对象（Objects）

自定义存储允许你通过编写自己的存储接口方法实现来决定对象的存储结构。通常，使用自定义存储的类不会被投射到 SQL。

以 D 开头的术语

数据库 (database)

通用

IRIS.DAT 文件。它可以包含代码和数据。通过全局、包和例程映射，任何给定的数据库都可以被多个命名空间使用。

数据库缓存 (database cache)

系统

用于缓存从数据库中检索的数据的系统内存（RAM），这样相同查询的重复实例可以从内存中而不是存储中检索结果，从而提供显著的性能提升。为了获得最佳性能，数据库缓存应至少与应用程序工作负载的工作集一样大。

第六章 C 开头的术语

计算机名称 (computer name)

系统

分配给一个处理器、其外围设备及所有相关数据集的名称。这个名称在整个网络中必须唯一。另见系统名称。

并发模式 (concurrency mode)

对象（Objects）

并发模式决定在打开和保存对象时执行何种类型的锁定。IRIS 支持五种并发模式（0-4），允许你指定不锁定、原子锁定、共享锁定、共享保留锁定和独占锁定。

并发 (concurrency)

对象（Objects）

并发通过锁定机制控制数据完整性。IRIS 支持五种并发模式，从不锁定到在对象加载到内存直到保存期间持有独占锁。默认情况下，IRIS 对所有对象使用原子锁定。

并发备份 (concurrent backup)

系统

在不停止其他数据库活动的情况下进行的备份。IRIS 使用多遍方法，最大限度地减少备份对用户的影响，同时保持备份的完整性。

注意：备份期间发生的事务处理可能不会被完全记录到日志中，如果你在备份过程中清除、删除或替换当前日志文件。

配置 (configuration)

系统

IRIS 配置在启动时描述 IRIS 资源。你可以在管理门户中定义配置。可以创建多个配置，但一次只能有一个当前配置。IRIS 在启动时使用当前配置。

连接 (connection)

系统

客户端应用程序或工具与IRIS 之间的链接。每个连接在IRIS 服务器上都有一个相关的进程。

第五章 C 开头的术语

客户端应用程序 (client application)

系统

一个独立于IRIS可执行文件的可执行文件，但依赖于IRIS，例如作为数据源。这样的应用程序可以在IRIS中注册，从而作为 安全模型的一部分进行管理。客户端应用程序的用户必须使用支持的认证机制之一进行IRIS认证。

代码方法 (code method)

对象（Objects）

执行 ObjectScript 的方法。

排序规则 (collation rule)

系统

确定IRIS检索全局节点顺序的算法。IRIS内置的排序规则包括 UNICODE、ANSI 和字符串。在 ANSI 排序中，标准数字下标首先按数字顺序排列，随后所有其他按字符串顺序排列；字符串顺序是字符集中的字符顺序。字符串规则将所有下标按字符集中的字符串排序，就像 ObjectScript 的 "]" 运算符一样。

排序序列 (collation sequence)

系统

指定IRIS在必须按顺序检索节点时检索全局节点的顺序。字符集和排序规则共同构成排序序列。每个全局都与特定的排序序列相关联。

排序 (collation)

SQL

排序指定SQL在排序前如何转换数据。每种数据类型都有默认的排序类型。基于数据类型的属性使用其排序类型，除非明确定义了属性的排序类型。索引使用它们所索引的属性的排序类型，除非明确指定了索引的排序类型。

# 第四章 C 开头的术语

#### 循环引用 (circular reference)

**对象（Objects）**

在不同类中的两个属性相互引用对方的集合。只要循环引用中的两个属性都不是必需属性，`IRIS` 完全支持循环引用。如果循环引用中的两个属性都是必需属性，你将无法保存这两个类的对象。

#### 类编译器 (class compiler)

**对象（Objects）**

类编译器用于编译`IRIS` 类。你可以在 `IDE` 中使用类编译器，或者通过 ` IRIS` 对象实用库中的编译调用来使用。

#### 类定义语言 (Class Definition Language)

**对象（Objects）**

`IRIS` 的类定义语言（`CDL`）是一种基于关键字的语言，用于定义 `IRIS` 中的类。

#### 类描述符 (class descriptor)

**对象（Objects）**

包含运行时信息（方法和属性列表）的特殊类型例程，用于使用对象。

#### 类字典 (class dictionary)

**对象（Objects）**

类字典保存所有已编译类的当前类定义。`SQL` 也使用类字典来确定有效的表定义。

#### 类层次结构 (class hierarchy)

**对象（Objects）**

类层次结构显示从每个根类到其每个子类及其子类的类链。

近期有些小伙伴需要查询某张特定的表所占用的磁盘大小，可能其他小伙伴也有类似的需求。

给大家一个例子供参考。

应当考虑到IRIS的表底层使用global存储数据，包括表数据、索引数据和流数据（如果表中有流属性的话），因此一张表的完整占用应当包含至少上述三种global的求和，如下所示：

Class GlbUtil.GlobalSearch Extends %RegisteredObject
{



ClassMethod GetTableSize(databaseName As %String, tableName As %String) As %Integer [ SqlProc ]

{

set currentNS = $namespace
//在%SYS命名空间中用API获得数据库的文件所在的路径
zn "%SYS"
set bdDirectory = $replace(##Class(Config.Databases).

InterSystems 已更正导致在使用特定 $LIST 语法时引入无效数据库和日志记录的缺陷。 遇到此缺陷的可能性非常低，但它对操作的影响可能会很大。

受影响的产品

• InterSystems IRIS® 数据平台：2023.3、2024.1.0、2024.1.1、2024.1.2、2024.2、2024.3 版
• InterSystems IRIS® for Health：2023.3、2024.1.0、2024.1.1、2024.1.2、2024.2、2024.3 版
• HealthShare® Health Connect：2023.3.0、2024.1、2024.1.1、2024.1.2、2024.2、2024.3 版
• HealthShare® Unified Care Record and Suite：2024.2 版
• 基于上述产品的所有产品组合

该问题仅影响 Unicode 安装。

使用以下语法在 global 中向列表附加新元素时，会出现此问题：

SET $LIST(<global reference>, *+1) = value.

当此调用的结果列表超出最大字符串长度时，正确的行为是返回 <MAXSTRING> 错误。此错误会出现在 InterSystems IRIS、InterSystems IRIS for Health 和 Health Connect 2023.

🚨 计划维护公告 🚨  

由于计划中的维护，开发者社区网站可能会在2025年1月20日（星期一）期间出现短暂的停机现象。

对于由此可能带来的不便，我们深表歉意，并感谢您的理解。感谢您耐心等待，我们将努力提升我们的平台！  

第七十七章 设备特殊变量

^%IS 的更多功能

^%IS 还可用于执行以下任务：

• 右边距抑制 — 可以设置终端线，以便每当选择该设备时，都会抑制右边距问题;默认值是自动假定的。
• 自动设备选择 - 如果在调用 ^%IS 实用程序时存在变量 IOP，则实用程序会自动尝试打开该设备，而不是请求设备。如果 ^%IS 不成功，则将变量 POP 设置为 1。
• 预配置的终端 — 使用 Management Portal，可以配置不向用户请求任何设备信息的设备。

^%IS Global 的结构

^%IS 全局变量存储在 %SYS 命名空间中。它包含两个下标。第一个下标是在 Management Portal 中为设备配置的助记词名称。选择 System Administration、Configuration > Device Settings、IO Settings 以显示不同设备类型的默认助记词。第二个下标可以是 0 或 1。

第七十六章 使用 ^%IS - 示例

示例

调用 CURRENT^%IS 后，将 $X 和 $Y 设置为 DX 和 DY 以定位光标。

  DO CURRENT^%IS
  WRITE *27,*61,*DY+32,*DX+32 
  SET $X=DX,$Y=DY

IN^%IS 入场点

IN 是 ^%IS 中的一个内部入口点，可以由仅计划从设备进行 input 的例程调用。此入口点可用于确保您不选择仅输出设备，例如打印机。

%SYS> Do IN^%IS

Device: 3 
Right margin: 132= <RETURN>
[you can't read from this device] 
Device: <RETURN>  
Right margin: 80= <RETURN>
%SYS>

OUT^%IS 入口点

OUT 是 ^%IS 中的一个内部入口点，可以由仅计划向设备输出的例程调用。

Spooling

IRIS 假脱机独立于您的操作系统执行的假脱机。IRIS 中的假脱机是一种技术，可让自动将程序的输出保存在全局中，而不是立即打印。稍后可以通过将 global 的内容发送到打印机来打印输出。

助记词 SPOOL 是默认助记词。要指定假脱机，请输入 “SPOOL” 以响应 Device 提示符。然后，系统要求提供假脱机文件名和描述。

第七十五章 使用 ^%IS - OPEN 参数

OPEN 参数

默认情况下，OPEN 命令使用 ^%IS 全局中定义的设备的规范。在使用 ^%IS 时，可以通过指定其他设置来覆盖这些设置。

发出 USE 命令

运行 ^%IS 后，应用程序必须向 ^%IS 打开的设备发出 USE 命令。你可以使用变量 IO，只要你明白每次调用 ^%IS 时它的值都会发生变化。然后，后续的IRIS I/O 命令，例如 READ 和 WRITE，将引用该设备。

发出 CLOSE 命令

用户或应用程序开发人员必须关闭使用 ^%IS 实用程序打开的设备。

^%IS 助记词

^%IS 有几个功能可以简化它的使用。例如，如果想将 I/O 发送到自己的终端，只需在“设备”提示符处按 Enter 键即可。还可以使用内置的默认助记词或您自己定义的新助记词。

设备助记词

为各种设备提供助记符很有用，在某些情况下，为单个设备提供多个助记符也很有用。多个助记符允许您为设备指定不同的设备特征，并根据设备的使用方式改变特征。例如，通常用于数据输入的终端，因此具有终端的特性，可能连接了辅助打印机。通过分配不同的助记词来打开具有不同特征的同一设备，当您需要硬拷贝时，您可以将终端/打印机组合视为打印机。

默认助记词

^%IS 全局变量在安装时使用几个默认助记词进行初始化。例如，IRIS 假脱机程序有两个默认助记词，SPOOL 和 2

第七十四章 使用 ^%IS

^%IS 是一个通用的设备选择实用程序，用于基于字符的应用程序。可以使用内置的 ^%IS 实用程序来允许用户选择要将 I/O 操作定向到的设备。每当要选择设备时，应用程序都应该调用 ^%IS 实用程序。此实用程序允许用户指定要使用的设备和相应的 OPEN 命令参数，打开所选设备，然后将特定于设备的信息返回给调用程序。用户输入已在 ^%IS 全局中定义的助记词。^%IS 依赖于 Management Portal 中建立的 IO 配置默认值。

^%IS 如何运作

设备提示

当您调用 ^%IS 实用程序时，IRIS 会提示输入设备名称。可以通过以下方式之一进行响应：

• 输入所需的设备名称或 ID 号。
• 输入设备的助记词。
• 按 Enter 选择当前设备。

^%IS 响应如下：

• 如果输入设备助记词，则 ^%IS 会在 ^%IS 全局变量中找到对应的设备并打开它。
• 如果输入设备名称，则 ^%IS 会向该设备发出 OPEN 命令。
• 如果设备是 IRIS 设备 ID，则 ^%IS 会检查设备表，查看该编号是否被重新映射到另一个实际的设备编号。然后 ^%IS 为设备发出 OPEN。

其他问题

如果指定的设备是终端，则实用程序会提示您使用默认的右边距。按 Enter 键选择该边距或键入其他值。

第七十三章 管理设备和助记词空间 - 设备的解释级别

与 ^%IS 或 OPEN 命令一起使用的设备标识符最多要经过三个级别的解释。因此，如果在 ^%ISDevice： 提示符处输入助记词 47，则使用的最终设备 ID 可能会有所不同。下面介绍了这三个级别。

级别 1：%IS 实用工具级别

如果使用 ^%IS 实用程序选择设备，则使用第一级。^%IS 全局中的助记词可以与设备编号相关联。然后，^%IS 实用程序向该设备编号发出 OPEN 命令。

级别 2：OPEN 命令级别

在 OPEN 命令中，IRIS 会检查此数字是否存在于 Device panel 表的 Alias 列中。如果是这样，它会将其转换为该设备的实际设备号或名称。

注：如果想通过 ^%IS 的助记词访问该设备，请确保不要定义与设备 ID 匹配但与其他设备关联的别名。

定义默认助记词

程序员可以通过在其应用程序中使用 WRITE /mnemonic 命令来控制设备。例如，当程序员使用以下命令使用 %X364 助记词时，他们可以将光标移动到终端设备上当前行中的特定列：

  WRITE /CHA(column)

由助记词的任何特定值引起的操作由 WRITE 命令使用的助记词空间决定。助记词空间是具有定义设备操作和属性的入口点 （助记词） 的例程。

WRITE 命令使用设备的 OPEN 或 USE 命令中定义的助记词空间。