第七十二章 管理设备和助记词空间 - 定义设备

定义设备

可以在 Management Portal 的 Devices （设备） 配置设置中定义、编辑和删除设备。您输入的信息存储在 ^%IS 全局变量中。有关此全局的更多信息，请参阅 ^%IS 全局的结构。

如果在 IRIS 运行时进行设备更改，系统会提示是否要在不重新启动 IRIS 的情况下激活更改。如果同意激活更改，则新定义将立即提供给用户。

访问设备

在 Windows 系统上，必须将设备编号用于作业间通信设备和常规联锁设备。对于终端和打印机，可以使用您分配的设备助记词或设备编号。

在 UNIX 系统上，可以使用 UNIX 文件规范来引用文件，也可以设置设备编号来引用文件。

可以通过以下两种方式之一访问设备：

• 在 ^%IS 实用程序的 Device： 提示符处输入设备助记词。
• 发出 OPEN 命令并输入设备 ID 或别名。

允许用户使用 ^%IS 实用程序选择设备

如果希望基于字符的应用程序的用户以交互方式选择设备，请从应用程序中调用 ^%IS 实用程序。您可以在 允许用户指定设备 中了解有关 ^%IS 实用程序的更多信息。

要使用 ^%IS 实用程序选择设备：

1. 在 Device： 提示符处，输入设备助记词。

第七十一章 管理设备和助记词空间 - 设备 ID

可以通过数字或操作系统名称来识别设备。可以在 OPEN 命令中使用此标识符。

设备别名

可以为定义的每个 IRIS 设备定义一个或多个别名值。当用户在 OPEN 命令中指定别名时，IRIS 会将其转换为设备 ID。

IRIS 提供的默认设备 ID 适用于大多数用户。但是，某些用户可能希望覆盖这些默认值。可以通过在 Management Portal 中提供别名作为设备配置设置的一部分来实现此目的。

默认设备 ID 和助记词

当安装 IRIS 时，这些是每种设备类型的默认设备编号和助记符。

默认设备编号和助记词

但是，IRIS 还可以识别可用于定义设备的其他设备编号。下表列出了已识别的默认设备编号。

IRIS 默认设备编号

2024 年 12 月 4 日，系统警报和监视 (SAM) 已从 InterSystems 下载网站、容器注册表和文档网站移除。

InterSystems 去年宣布停止进一步开发 SAM，并同时将其标记为已弃用。InterSystems 将继续按照与超出最低支持版本窗口的产品版本相同的方式为使用此技术的现有客户提供支持。

Intersystems 发现，大多数对 SAM 提供的可观察性类型感兴趣的客户已选择将 InterSystems IRIS 指标 API 和结构化日志记录连接到其组织现有的可观察性平台，以便更全面地了解其运行平台。

如果您对 SAM 当前的使用方式或今后的使用计划有任何疑问，请联系您的客户团队或 dbpprodmgrs@intersystems.com。

第七十章 管理设备和助记词空间

设备管理实用程序

下表总结了用于管理设备的实用程序。

IRIS 设备实用程序

第六十九章 打印机 - 使用助记词空间控制设备

助记词是执行设备控制操作（如光标移动和设备属性）的 IRIS 例程。每个操作都与一个标签相关联。这些标签是 WRITE /mnemonic 命令中使用的助记词。有关 WRITE /mnemonic 语法的更多信息，请参阅本文档其他页面中每种设备类型的 WRITE 命令说明。

预定义的助记词空间

IRIS 提供下表中描述的预定义助记词空间。

预定义的助记词空间

设置默认助记词

可以在 Management Portal 中更改以下设备类型的默认助记词空间。依次选择 System Administration、Configuration （配置）、Device Settings （设备设置）、 IO Settings （IO 设置）。

第六十八章 打印机 - 在 UNIX® 上指定打印机

要在 UNIX 设备名称为 /dev/tty06 的终端上打开 I/O 设备，请输入以下命令

   OPEN "/dev/tty06"

在 UNIX 系统上，打印机由 OPEN 命令上的名称标识，并在 tty 设备上作为“字符特殊”文件处理。因此，支持的 OPEN 和 USE 命令参数与终端 I/O 相同， 而不是顺序文件 I/O 的参数。

在 UNIX 上，OPEN 支持大多数终端 I/O 关键字参数，如终端 I/O 中所述。

将输出定向到打印机

可以使用 %IS 实用程序将输出定向到打印机。可以使用命令 DO ^%IS 调用 %IS 实用程序。（也可以使用 DO OUT^%IS 来指定选择的是仅输出设备。无论哪种情况，IRIS 都会返回 Device： 提示符。要指定打印机，请使用默认助记符 “|PRN|“ 或其他已配置打印机的助记符。然后，%IS 实用程序会建议 OPEN 参数;对于打印机，默认值为 “W” （只写）。可以通过按 Enter 键来接受参数 default，如以下示例所示：

%SYS>DO ^%IS
Device: |PRN|
Parameters? "W" => <RETURN>
%SYS>

这将打开指定的打印机作为当前进程的输出设备。

%IS 实用程序设置各种变量。以下是 Windows 系统上的打印机默认值。

我们已经有一段时间没有在开发者社区上发表关于嵌入式 Git 的文章了，我想借此机会更新一下今年我们完成的大量工作以及未来的工作计划。

背景信息

如果您要在 IRIS 上构建解决方案，并想要使用 Git，那就太棒了！ 只需将 VSCode 与本地 Git 仓库结合使用，并将更改推送到服务器上即可，就是这么简单。

但在以下使用场景中该怎么办：

• 您与其他开发者在共享的远程开发环境中合作，并想要避免因同时编辑同一文件而影响彼此的工作
• 您使用位于管理门户中的编辑器来实现互操作性或业务智能，并希望对您的工作直接进行源代码控制，即使在本地容器中也希望如此
• 您仍在使用 Studio 处理一些任务并且/或偶尔会再次从 VSCode 跳转回 Studio；或者您的团队还没有完全接受 VSCode，一些团队成员仍想使用 Studio，而其他人在使用 VSCode
• 您同时在同一命名空间中处理多个独立的项目，例如使用 InterSystems Package Manager 定义的多个软件包，并想仅通过一个 isfs 编辑视图使用所有软件包（而不是在多个单独的项目中使用），同时在合适的本地 git 仓库中自动跟踪更改

在以上任何情况下，您都非常需要嵌入式源代码控制。

借助 InterSystems 行业标准认证考试，您和您的团队可以获得认证，以验证您的技能并证明您拥有 InterSystems 技术方面的专业知识。 查找适合您的角色的考试！

第六十六章 打印机

打印机

本页讨论了如何在 IRIS 数据平台中配置和使用打印设备。打印机是仅物理输出设备。打印机可以是字符打印机，也可以是非字符设备，例如传真或绘图仪。

在大多数情况下，输出不会直接发送到打印机。通常，要打印的输出首先发送到逻辑假脱机设备（^SPOOL 全局）。然后，可以将 ^SPOOL 全局的内容发送到物理打印机。有关假脱机的更多详细信息，请参阅 假脱机设备。

打印机概述

请注意，Windows 和 UNIX 处理打印机 I/O 的方式不同。

• Windows 系统将打印机作为顺序 I/O 设备处理，因此遵循与顺序文件 I/O 相同的语法。但是，通过串行通信端口连接的打印机将作为终端 I/O 设备处理。
• UNIX 系统始终将打印机作为终端 I/O 设备进行处理。UNIX 将其视为 tty 设备上的 “字符特殊” 文件，因此遵循与终端 I/O 相同的语法。

在 Windows 系统上，您可以使用 %Library.Device.InstalledPrinters（） 方法返回系统上当前打印机的计数。您可以使用 %Library.Device.GetPrinters（） 方法返回系统上当前打印机的列表。

指定打印机

可以为打印机分配一个介于 256 和 2047 之间（包括 256 和 2047）的设备编号。此设备编号范围也用于终端和平面文件。

2024.3 版  InterSystems IRIS^® 数据平台、InterSystems IRIS^® for Health 和 HealthShare^® Health Connect 现已正式发布 (GA)。

版本亮点

在此版本中，您可以期待一系列激动人心的更新，包括：

1. 数据库和 WIJ 文件的扩展速度大大提高
2. 能够通过 Visual Trace 重新发送消息
3. 增强的规则管理器功能
4. 向量搜索增强功能
5. 等等。

请通过开发者社区分享您的反馈，与我们共同打造更好的产品。

文档

请访问以下链接了解所有亮点功能的详细信息：

• InterSystems IRIS 2024.3 文档、版本说明和升级检查核对清单。
• InterSystems IRIS for Health 2024.3 文档、版本说明和升级检查核对清单。
• Health Connect 2024.3 文档、版本说明和升级检查核对清单。

此外，请查看此版本的升级信息。

抢先体验计划 (EAP)

目前提供多个 EAP。 请查看此页面并注册您感兴趣的计划。

如何获取软件？

像往常一样，持续交付 (CD) 版本包含适用于所有受支持平台的经典安装包，以及 Docker 容器格式的容器镜像。

第六十五章 假脱机设备 - 列出假脱机文档

列出假脱机文档

%SPOOL 实用程序菜单 List documents 的选项 2 显示当前为运行 %SPOOL 的目录假脱机的文档列表。如果没有 Despool start-end 值，则文档尚未解散（打印）。

每个假脱机文档的描述显示在有关该文档的其余信息之后的一个或多个单独行上。

在以下示例中，用户选择了选项 2。显示屏将显示存储在后台处理程序中的两个文档。第一份记录在 8 月 30 日下午 2：23 存储，并于当天下午 2：25 打印。第二份于 3 月 4 日上午 11：39 存储，并于当天上午 11：42 打印。

第六十四章 假脱机设备 - 使用 %SPOOL 打印

使用 %SPOOL 打印

%SPOOL 实用程序菜单的选项 1 Print（打印）允许您在任何设备上打印 ^SPOOL 全局中的一个或多个文档，继续打印中断的文档，以及将单张纸张手动送入信纸质量打印机。通过将输出发送到后台处理程序，可以在输出设备打印文档时释放终端用于其他用途。

可以在完全创建后台打印文档之前或之后开始打印。如果打印机赶上新输出，则打印过程将暂停 5 秒钟，然后打印在此期间累积的所有输出。打印过程知道您何时关闭了后台打印文档，并在文档完成时完成。

当 %SPOOL 打印文档时，它会跟踪已打印的页面。它还会创建页面索引，以便可以按页码对文档进行排序，并从您选择的任何页面的顶部开始打印。

如果停止打印（例如，在终端输出期间按 Ctrl-c，或者打印机损坏），则可以稍后在最后一个部分打印的页面的顶部或文档中任何其他页面的顶部继续打印。请注意，IRIS 不会将文档开头的换页数计为页数中的页数。

%SPOOL 使用术语 despool 来表示打印。仅当文档已打印（depooled）时，Despool start-end 列和描述行中才会有值。

使用 Print 函数

1. 在 “Spool function：” 提示符下，输入 1。
2. 在“Name：”提示符下，输入 ？要显示帮助文本，请输入

InterSystems IRIS^® 数据平台、InterSystems IRIS^® for Health 和 HealthShare^® Health Connect 2025.1  的首个开发者预览版已发布到 WRC 开发者预览网站。容器可在我们的容器注册表中找到，并已添加 latest-preview 标签。

这些开发者预览版包含用于迁移到 IBM Open XL C/C++ for AIX 17.x 编译器的功能，从而在旧版编译器接近支持终止时确保与未来的 AIX 版本兼容。 此迁移侧重于 aixopenssl30 目标，支持 AIX 7.2 和 7.3 上的 SSL3。

可以在以下链接中找到初始文档：

• InterSystems IRIS 数据平台 2025.1 | 文档首页
• HealthShare Health Connect 2025.1 | 文档首页

可用性和软件包信息

此版本提供适用于所有受支持平台的经典安装包。有关完整列表，请参阅“支持的平台”文档。

安装包和预览版密钥可从 WRC 的预览版下载网站或通过评估服务网站（勾选“Show Preview Software”（显示预览软件）框）获取。

各位社区成员，大家好

🎉 2024 年已接近尾声，是时候庆祝大家的贡献了！ 请在开发者社区上查看您的个性化 2024 年回顾，了解您今年的成就、活动和影响。

深入了解您产生的影响！ 💫

第六十二章 假脱机设备 - 查看 ^SPOOL 全局

查看 ^SPOOL 全局

与任何下标的全局变量一样，您可以通过发出 WRITE 命令来显示 spool 文件中的行，如下所示：

   WRITE "1st spool file node: ",^SPOOL(1,1),!

但是，要查看和编辑假脱机文件本身，请转到管理门户并选择 System Explorer 和 Globals。选择您当前的命名空间，找到 SPOOL 全局变量，然后单击 data。这将显示类似于以下示例的假脱机文件数据。

在下面的假脱机文件中，（！） 终止字符结束假脱机文件中的每个节点行。这些终止字符是假脱机文件的一部分，作为 $CHAR（13,10） 连接到文本字符串（Return 和 Line Feed）。

^SPOOL(1,1)=<<"First line of text"_$C(13,10)>>
^SPOOL(1,2)=<<"Second line of text"_$C(13,10)>>
^SPOOL(1,2147483647)={59605,43605{3{

在下面的假脱机文件中，没有行终止字符。两个 WRITE 命令写入一个 node 行，该行由关闭 spool 文件终止。

第六十一章 假脱机设备 - 假脱机和特殊变量

写入 ^SPOOL 时，IRIS 会不断更新 $X 并$Y特殊变量。$X 表示写入当前索引行的字符数，$Y 包含当前 OPEN 期间写入的行数。请注意，$Y 的值不一定与 node 索引相同。例如：

   /* Writing to the ^SPOOL global */
   OPEN 2:(2:3)
   USE 2
     WRITE "Hello " SET x1=$X,y1=$Y,z1=$ZA
     WRITE "world",! SET x2=$X,y2=$Y,z2=$ZA
     WRITE "Good to see you",! SET x3=$X,y3=$Y,z3=$ZA
   CLOSE 2

   /* Displaying the ^SPOOL global */
   WRITE ^SPOOL(2,3),^SPOOL(2,4)
   WRITE !,"$X=",x1," ",x2," ",x3
   WRITE !,"$Y=",y1," ",y2," ",y3
   WRITE !,"$ZA=",z1," ",z2," ",z3

在此示例中，第一个 WRITE 集 $X=6（当前列号），第二个和第三个 WRITE 都设置为 $X=0（因为行返回）。

第六十章 假脱机设备 - WRITE 命令

WRITE 命令

要将一行写入 ^SPOOL 全局变量，请发出 WRITE 命令，以行终止符字符结尾。例如

   /* Writing to the ^SPOOL global */
   OPEN 2 
   USE 2 
     WRITE "First line of text",!
     WRITE "Second line of text",!
   CLOSE 2

   /* Displaying the ^SPOOL global */
   WRITE ^SPOOL(1,1),^SPOOL(1,2)

每行都以行终止符（感叹号）结尾，并存储在单独的全局节点中。

但是，在生成单个打印行时，可能需要使用多个 WRITE 命令;如果 WRITE 不包含行终止符，则下一个 WRITE 命令将附加到同一打印行。两者都写入同一个全局节点。此行保存在缓冲区中，在发出行终止字符或关闭后台处理程序设备之前，不会写入后台处理程序全局。

第五十九章 假脱机设备

介绍

IRIS数据平台使能够将打印输出直接发送到您的打印机或屏幕，或将其保留在后台打印中以供以后打印。IRIS 假脱机独立于您的操作系统执行的假脱机。

IRIS 中的假脱机是一种技术，可让自动将程序的输出保存在 ^SPOOL 下标全局中，而不是立即打印。可以通过将 ^SPOOL 全局的内容发送到打印机来稍后打印输出。本页介绍使用此假脱机工具的两种方法：使用 ObjectScript 命令（OPEN、USE、WRITE、CLOSE）或使用 %IS 和 %SPOOL 实用程序。

打开和使用假脱机设备

要将输出发送到当前命名空间中的 spool 全局变量，请打开 spooler 并将其指定为输出设备。

假脱机程序是 IRIS 提供的预定义设备。它在设备表中被分配了设备编号 2。此设备号可用于在 OPEN、USE 和 CLOSE 命令中标识后台处理程序设备。

您可以通过 Management Portal 访问后台处理程序设备信息。依次选择 System Administration、Configuration （配置）、Device Settings （设备设置）、Devices （设备）。在这里，将找到设备 2 和名为 SPOOL 的设备。默认情况下，它们都映射到同一物理设备（设备 2），并且具有相同的 option 值。

java如何使用IRIS sdk这个方法创建MIRROR

第五十八章 File 输入 输出 - WRITE 命令

WRITE 命令

在定位的 READ 或 WRITE 之后，后续的 READ 或 WRITE 操作将按顺序进行，直到下一个带有 position 参数的 USE 命令。

WRITE 命令将数据（一次一条记录）写入作为当前设备的顺序文件。

语法

WRITE x

• x 变量 x 中的数据将作为一条记录写入顺序文件中。

CLOSE 命令

CLOSE 命令放弃对顺序文件的所有权。

如果指定的文件未打开或不存在，则 IRIS 将忽略 CLOSE 并返回而不发出错误。

语法

CLOSE file 
CLOSE file:"D" 
CLOSE file:("R":newname)

• file 文件 任何有效的文件规范，用引号括起来。指定的文件必须已打开。在 UNIX 路径名中，可以使用波形符 （~） 扩展来指示当前用户的主目录。例如：~myfile 或 ~/myfile。
• "D" 关闭并删除具有参数中指定的名称的文件。
• ("R":newname) 使用参数中指定的名称关闭文件，并将其重命名为 newname。

CLOSE-Only 命令关键字

下表描述了仅使用 CLOSE 命令控制顺序文件的关键字。

顺序文件的 CLOSE-only 命令关键字

/DELETE[=n] /DEL[=n]

0，除非文件在打开时标记为删除。

许多使用InterSystems IRIS的用户在调试代码的时候习惯使用命令行的方式，比如运行一个函数查看输出或者查看代码运行过程中保存在global中的数据等等。

对于将 InterSystems IRIS 安装在 Windows 操作系统的用户，只需要点击右下角图标选择Terminal 就可以很方便的使用。

但是对于将其安装到 Linux 或者Docker 容器中的用户，要使用命令行却不那么方便，下面我将会介绍在我们 Openexchange 中的一个应用 -- Web Terminal。

也就是说可以在网页中直接执行Terminal中的命令。

或者查看SQL执行结果：

可以在其中输入 /help ，获取更多帮助信息

安装

1. 点击进入项目下载页面，选择下载最新的版本。

2. 在任意的命名空间下导入下载的xml文件。

注意在这里选择导入文件的同时也要勾选上 “编译导入的项”

3. 之后会出现下面提示导入成功的提示

如果出现类似于下面的错误提示：

请将下载的 WebTerminal-v4.9.3.xml 文件编辑做下面修改

1 . 第1611行：修改为 

set requiredRole = "%DB_IRISSYS"

2. 第1730行：修改为

set dbPrefix = "IRIS"

重新导入就可以了。

Web Terminal 已经存在相当长一段时间了，但它存在诸多限制，并非所有功能都能正常使用。它不支持 shell，也没有诸如嵌入式 Python 支持这样的最新功能。对于那些需要编程模式的工具来说，存在一些问题。基本身份验证也不如简单的登录页面便捷，使用登录页面的话，倘若你想要改变登录应用程序的方式（比如使用单点登录，即 SSO），你还可以自行添加登录页面。

通过将最初的iris terminal 封装到一个网页表单中，利用在网络领域应用极为广泛且同样被像 Visual Studio Code（VSCode）这类工具所使用的 xterm.js，并借助 Python 施展的一些 “魔法”（这些 “魔法” 有助于实现进程间的终端交互），我们就能在网络上完整地实现终端功能了。

安装方法

在

zn "%SYS"
zpm "install iterm"

为了测试它是如何在web中工作的，可以执行 term routine，如下

现有一个数据表的数据像这样：

我们的需求是基于表中的Item列新增一个status字段，如果item的内容是第一次出现，那么status列就是New，反之显示Old,

比如，应该是下面的显示内容

在原文章的回复中， Robert Cemper给出了下面的建议

新建一个存储过程，并在SELECT查询语句中生效：

/// Return NEW for first occurance of item 
/// otherwise return OLD
Class User.ItemStat Extends %RegisteredObject
{
ClassMethod NewOld(item As %String = "") As %String [ SqlProc ]
{
    if item="" quit "?

第五十七章 File 输入 输出 - READ 命令

在定位的 READ 或 WRITE 之后，后续的 READ 或 WRITE 操作将按顺序进行，直到下一个带有 position 参数的 USE 命令。

READ 命令从当前设备读取数据，一次读取一条记录。读取超过文件末尾会导致错误。

语法

READ x#n:timeout

• x 该变量将保存从文件中读取的记录。
• n 可选 – 对于可变长度读取，为要读取的字符数，指定为整数。对于固定长度的读取，此参数将被忽略。
• timeout 超时 可选 – 在超时之前等待读取操作完成的秒数。整数值或解析为整数的变量。

timeout 参数虽然是可选的，但强烈建议使用，因为如果指定了 timeout，则 READ 的成功或失败由 $TEST 特殊变量的值指示。如果读取尝试在超时到期之前成功，则 $TEST 设置为 1;如果超时到期，则 $TEST 设置为 0。

以下示例显示了从 Windows 顺序文件中读取固定长度记录的 READ 操作。它创建一个顺序文件，将数据写入该文件，然后关闭该文件。然后，它会打开此文件以进行 4 个字符的固定长度读取 （“RF”：4）。它将 USE position 参数设置为第一条记录（记录 0）;每个读取操作都会推进此位置。FOR 循环将每个四字符的记录读取到下标变量中。

第五十六章 File 输入 输出 - USE 命令

US 命令

USE 命令使打开的顺序文件成为当前设备。可以打开多个顺序文件，但一次只能使用一个顺序文件。

语法

USE file:position

• file 文件

任何有效的文件规范，用引号括起来。指定的文件必须已打开。在 UNIX 路径名中，可以使用波形符 （~） 扩展来指示当前用户的主目录。例如：~myfile 或 ~/myfile。

• position 位置

可选 — 文件中下一个 READ 或 WRITE 的位置。position 值是一个数字表达式，其含义取决于文件的记录格式。对于固定长度的记录，position 是相对于零的绝对记录号，其中每条记录都包含在前面的 OPEN 命令中指定的字符数。对于流或可变长度记录，position 是相对于零的绝对字节位置。默认设置是从文件开头开始按顺序读取或写入记录。

可以使用 $ZSEEK 函数设置文件位置，该位置由字符数相对于顺序文件的开头、当前位置或结尾的偏移量指定。$ZPOS 特殊变量包含从顺序文件开头开始的当前字符计数位置。

USE-only 命令关键字

除了上面列出的与 OPEN 共享的命令关键字外，USE 命令还有自己的一组关键字：

顺序文件的 USE-only 命令关键字

/POSITION=n

当前文件位置。

技术支持团队在不同的项目中发现了类似中间人攻击的情况， 和各位分享一下。

我们的系统一般是安装在内网里，没有恶意的中间人攻击的风险。但是在有些医院发现了这样的情况：IT在网络中安装了某种网络监控或者嗅探的设备， 它会在通信通道中模拟其中一方，或者双方的通信节点， 以截获通信双方的网络流量。通常它不影响双方的通信，但偶尔，它会中断双方的连接， 造成业务的中断。实质上这也是一种中间人攻击的情况，只不过这是用户允许的行为，偶然出现了故障。 

我们看看以下的例子:

以下的wireshark抓包截图中， 172.18.1.131和172.18.1.145在正常的通信过程中， 忽然收到了RST消息，造成了TCP连接上的复位。

其中172.18.1.131是intersystems的health connect系统， 它在序号50134的包里面首先发送了RST，因此客户怀疑是不是Health Connect出错，中断了连接，也就把问题提交了InterSystems的技术支持。

我们的技术支持检查了各种内部日志，没有发现任何错误，咨询了InterSystems的网络专家，才发现这是个网络层的错误，也就是说： 这个RST不是Health Connect发送的， 同样， 序号50135的RST消息， 也不一定是172.18.1.145发送的，这是中间网络层的行为。

第五十五章 File 输入 输出 - 与非 InterSystems IRIS 软件的交互

与非 InterSystems IRIS 软件的交互

在 Windows 系统上，在 IRIS 中打开顺序文件以进行 “WL” 写入访问通常会阻止非 IRIS 应用程序打开顺序文件进行写入访问。同样，非 IRIS 应用程序打开顺序文件进行写入访问通常会阻止 IRIS 进程并发 “WL” 写入访问。

但是，某些非 IRIS 应用程序，包括记事本和写字板应用程序，会打开一个文件，在共享模式下复制文件，然后立即关闭它。因此， IRIS 进程仍然可以以 “WL” 模式打开文件。当这些非 IRIS 应用程序之一尝试将其副本中的更改保存到原始文件，或尝试重新打开原始文件时，将发生错误。更严重的情况可能发生如下：如果这些非 IRIS 应用程序之一打开了一个文件，然后 IRIS 打开、修改和关闭文件，然后非 `` 应用程序保存对文件的更改，两个进程所做的更改都被保存，文件数据的完整性可能会受到损害。

在 UNIX 系统上，在 IRIS 中打开一个顺序文件以进行 “WL” 写访问通常不会影响非 IRIS 应用程序的行为。您必须使用锁来可靠地限制来自非 IRIS 应用程序的写入访问。

示例

以下示例打开文件 “LUDWIG.B“ 的 ID 文件。

第五十四章 File 输入 输出 - OPEN 参数关键字

OPEN 参数关键字

下表描述了顺序文件的 OPEN 命令参数关键字：

顺序文件的 OPEN关键字参数

/PARAMS=str /PAR=str

No defaul

对应于 parameters 位置参数。（它提供了一种以与位置无关的方式指定参数字母代码字符串的方法）。

/RECORDSIZE=int /REC=int

无默认值

对应于 reclen 位置参数，该参数为固定长度记录建立记录大小。（目前仅针对 READ 操作实现。

/TERMINATOR=str /TER=str

无默认值

对应于 terminators 位置参数，该参数建立用户定义的终止符。str 是一串用户定义的记录终止符，仅适用于 Stream 模式。它们允许覆盖默认终止符：回车符、换行符和换页符。用户定义的终止符仅适用于输入，它们不会影响数据写入文件的方式（终止符作为特殊字符写入文件）。如果有多个用户定义的终止符，则会将其视为终止符列表，而不是用作单个终止符的多字符序列。

OPEN 模式锁定

当两个进程尝试打开同一个顺序文件时，第二个 OPEN 会根据第一个OPEN 使用的模式成功或失败。下表显示了使用独占 （“L”） 和非独占读取和写入模式的两个打开之间的交互。请注意，这些交互的解释取决于平台。为 Windows 操作系统和 UNIX 操作系统提供了表。

第五十三章 File 输入 输出 - OPEN模式参数

A /APPEND /APP

Append：WRITE 操作将数据附加到现有文件的末尾。默认设置是覆盖现有数据，而不是 append。

S /STREAM

流格式，回车符、换行符或换页符作为默认终止符。S、V、F 和 U 模式是互斥的。Stream record format 是默认格式。

V /VARIABLE

请勿尝试在可变长度顺序文件末尾以外的任何位置插入记录;WRITE 将使文件中的所有数据从 WRITE 之后的点开始无法访问。S、V、F 和 U 模式是互斥的。流记录 （S） 格式是默认格式。

使用转换表写入的可变长度记录（例如使用 UTF8 转换的 Unicode 数据）可能会导致存储的记录具有与输入数据不同的字符串长度。IRIS 在读取此记录时使用原始输入字符串长度。

F /FIXED /FIX

Fixed length：每条记录都是 reclen 参数中指定的长度。例如：OPEN “myfile”:(“RF”：4） USE “myfile”：0 READ x：5此示例将前 4 个字符的记录读入变量 x。这仅适用于 READ 操作（不适用于 WRITE 操作）。S、V、F 和 U 模式是互斥的。

U /UNDEFINED

未定义的长度：指定文件记录具有未定义的长度，因此 READ 操作必须指定要读取的字符数。