%SYS.Journal.Record 类有一个查询(query), List, 可以列出Journal文件中记录的数据修改历史。例如，要查询谁对global节点^QP(1,2)做过修改，可以使用如下代码。它查询Journal文件（输入参数pFilePath）中的global节点（输入参数pSearchGlobal）的操作：

大家好：我编写一个简单的连接rabbitmq的测试代码；代码如下：

InterSystems IRIS、IRIS for Health和HealthShare HealthConnect的维护版本2022.1.5 & 2023.1.4现已发布

InterSystems IRIS, InterSystems IRIS for Health 和 HealthShare Health Connect 的两个扩展维护版本现已发布。

✅ 2022.1.5

2022.1.5 版提供此前发布的任一 2022.1.x 版中的Bug修复。

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

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

✅ 2023.1.4

2023.1.4 版提供此前发布的任一2023.1.x 版中的Bug修复。

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

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

如何获得该软件

该软件以经典安装包和容器映像两种形式提供。有关可用安装程序和容器映像的完整列表，请参阅 Supported Platforms webpage.

当我们在设计一个需要重复使用的BP时候，往往需要开发一个可配置<call>的对象的组件，我们将call的target 设置为

@process.TargetConfigName

即可实现。

下面是完整代码：

各位开发者好

欢迎观看InterSystems Bilibili官方频道的最新视频 InterSystems Developers Bilibili:

⏯ Understanding the Structure of HL7 FHIR Resources

<iframe allowfullscreen="true" border="0" frameborder="no" framespacing="0" scrolling="no" src="//player.bilibili.com/player.html?aid=1953056184&bvid=BV1iC411G74J&cid=1506782787&p=1"></iframe>

了解 HL7 FHIR 资源的结构。了解如何在 HL7 FHIR 网站上查看和阅读资源的树形表示法，从而了解资源中包含的不同数据元素。此外，还可了解如何查看 XML、JSON 或 Turtle 格式的资源，以及在哪里可以找到 FHIR 资源的通用建模语言 (UML) 图。

观看新视频！

此视频帮助大家了解InterSystems如何帮助CRO来加快临床数据采集和更快地推广市场。

演讲嘉宾:

Jim Coutcher, Senior Director/Principal, Global Head of Enriched Studies, Real World Solutions, IQVIA
Qi Li, Physician Executive, InterSystems
Matt Stannard, life Sciences Advisor, InterSystems

欢迎大家来我们的 Bilibili主页观看更多视频!

2024年3月26日，InterSystems数据平台全球主管Scott Gnau发文，宣布InterSystems IRIS数据平台新增了向量搜索（vector search）功能。

本文作者为Scott Gnau，InterSystems数据平台全球主管。

2024年3月29日-3月31日，由国家卫生健康委医院管理研究所主办、《中国数字医学》杂志社有限公司承办的“2024中华医院信息网络大会（CHINC）”将在青岛国际会展中心（红岛馆）举办。InterSystems诚邀您莅临展会，我们带来了内容丰富的Demo演示，包括：InterSystems IRIS 2024.1新特性、 InterSystems IRIS矢量存储和矢量查询、InterSystems FHIR数据资产化解决方案，以及InterSystems IRIS医疗版互联互通套件解决方案。

2024 CHINC期间，InterSystems在合作伙伴东华医为展位（B3馆-A02）设立Demo演示区，即日起即可预约现场Demo咨询，欢迎点击【此处】注册预约。

这是在 IRIS 中完全运行向量搜索演示的尝试。
没有外部工具，您需要的只是终端/控制台和管理门户。
特别感谢Alvin Ryanputra作为他的软件包iris-vector-search的基础
灵感和测试数据的来源。
我的软件包基于 IRIS 2024.1 版本，需要注意您的处理器功能。

我尝试用纯 ObjectScript 编写演示。
仅描述向量的计算是在嵌入式Python中完成的
计算 2247 个记录的 384 维向量需要时间。
在我的 Docker 容器中，它正在运行 01:53:14 来完全生成它们。

然后被警告了！
所以我将这一步调整为可重入，以允许暂停向量计算。
每 50 条记录，您就会收到一次停止的提议。
该演示如下所示：

本文汇聚了与FHIR相关的内容，包括新闻资讯、线上研讨会、视频、客户案例、行业洞察等，欢迎收藏保存！

• InterSystems IRIS医疗版互联互通套件3.0版发布：助力用户快速验证标准符合性，推动互联互通项目价值落地（2023年）
• InterSystems IRIS医疗版互联互通套件2.0版支持国内互联互通标准转换为FHIR标准，提升数据易用性（2022年）
• InterSystems发布InterSystems IRIS医疗版互联互通套件，加速医院互联互通平台建设（2021年）
• 技术总监答疑 | 我们为什么要做InterSystems IRIS医疗版互联互通套件？
• InterSystems IRIS® FHIR®加速器服务赋能医疗数据，实现轻松检索和储存（2021年）
• InterSystems加入Vulcan FHIR® 加速器™计划，将数据互操作能力扩展至生命科学领域

• 扫码看回放 | FHIR研讨会：如何有效利用数据核心资产？
• 医疗行业的生态创新：如何实现数据利用和应用创新
• 辨析互联互通测评方案新旧版，多位专家线上解读国内外互联互通标准与实践
• 报名观看 | 加速测评！InterSystems IRIS医疗版互联互通套件研讨会

InterSystems IRIS^®,InterSystems IRIS^®for Health^TM和HealthShare^®Health Connect2024.1版现已全面上市 (GA)。

发布亮点

在此版本中，您可以期待许多令人兴奋的更新，包括：

1. 在ObjectScript中使用向量Vector: 一种强大优化数据操控的能力.
2. 向量搜索Vector Search (试验性): 行业领先的高效数据检索.
3. 多卷数据库: 增强可扩展性和存储管理.
4. 快速在线备份FastOnline Backup (试验性): 优化备份流程.
5. 多种端口支持Multiple Super Server Ports: 提供网络配置的灵活性.
6. FHIR 2.0.0 支持 Smart
7. FHIR R4 对象模型生成
8. 改进了 FHIR 查询的性能
9. 删除专用 Web 服务器 (PWS)
10. 。

请通过开发者社区分享您的反馈，以便我们共同构建更好的产品。

文档

有关所有突出显示功能的详细信息可通过以下链接获得：

• InterSystems IRIS 2024.1文档、 发行说明以及已弃用和停产的技术和功能。

• InterSystems IRIS for Health 2024.1文档、 发行说明和升级清单。
• HealthShare Health Connect 2024.1文档、 发行说明和升级清单。

近来生成式大语言模型掀起了革命性的AI浪潮。生成式大语言模型是什么原理？我们怎么在业务中利用它？

一. 大语言模型的工作原理

生成式大语言模型是生成式人工智能底层的机器学习模型，是一种用于自然语言处理的深度学习模型。

人工智能、机器学习与大语言模型的关系如下图：

1.1 为什么我们称之为大语言模型？

大语言模型的“大”体现在多个方面：

• 首先，模型尺寸巨大，尤其是它的参数数量。例如GPT3有1750亿的参数；
• 其次，大语言模型是在巨大的算力基础上，基于海量语料进行训练的。例如Meta的Llama 2 的训练数据达到了两万亿个词(token);
• 再次，大语言模型是为解决通用问题，而非特定问题构建的。

1.2 大语言模型是怎么训练的？

大语言模型是事先训练好的模型。

训练时，大语言模型基于各种语料 - 人类知识库（例如Wikipedia）、公共数据集、网络爬虫数据，让模型进行“填空”练习，并经过人工编辑和“校对” 训练出来的，需要成千上万的GPU建立集群进行训练。根据Meta的信息，其Llama 2 的训练数据达到了两万亿个token，上下文长度为4096，对话上也是使用100万人类标记的数据微调。

运行时，训练产生的大语言模型可以在小的多的硬件上运行。

1.3 大语言模型的机器学习算法

冰冻三尺,非一日之寒;滴水穿石,非一日之功。生成式大语言模型能够落地经历了相当漫长的技术积累与进步。

IRIS 2024.1已经发布，它引入了诸多新特性，其中之一是JSON_TABLE。

数据表达和交换中，JSON已经是日益主流的存在。在之前的IRIS版本中，可以轻易将JSON数据以对象解析并保存到IRIS，也可以将IRIS数据使用SQL、对象等多种方式输出为JSON。对于得到的JSON序列化的数据，如果我们想通过SQL去解析，甚至进行检索和查询，就可以利用JSON_TABLE这个新特性。

对于一些大规模的JSON序列化数据，例如从FHIR服务器查询获得的FHIR资源Bundle，里面包含了大量数据。例如下面的FHIR查询结果，后面的示例以这个的复杂的JSON作为用例：

使用 FHIR SQL BUILDER 处理 FHIR 资源以预测患丙型肝炎疾病的概率

随着科技的发展，医疗行业也在不断的进步，人类也往往更加关注自身的健康，
通过计算机学习和处理数据集，可以预测疾病。

前提条件：使用 FHIR 和 ML的能力
首先，我们的数据集从kaggle获得，并根据患者性别、年龄、ALP或ALT转化为FHIR资源，并导入到FHIR资源库中

要导入FHIR资源库，我们可以使用以下命令：

Set sc= ##class (HS.FHIRServer.Tools.DataLoader).SubmitResourceFiles( "/usr/local/src/json/" , "FHIRSERVER" , "/csp/healthshare/fhirserver/fhir/r4" )

其中文件地址和fhir资源库URL可以根据情况进行修改。

完成导入后，下一步是配置FHIR SQL Builder，包括FHIR Analysis、转换规则和Projections

配置转换规则，这一点非常重要。它们可以获得你想要的数据，也可以省略患者的一些敏感信息，保证数据安全

配置完成后，创建一个投影，以查询数据库中的相应表

创建投影后，通过创建表或视图将表汇总成训练所需的结构

在上一篇文章中，我们了解了如何恢复存储在特定 HIS 数据库中的资源，因此今天我们将了解如何在 HIS 中添加新记录，其来源是我们在系统中收到的 FHIR 资源。

FHIR 的 CRUD 操作

FHIR 的主要功能之一是通过 Rest API 支持 CRUD 操作，这意味着任何使用 FHIR 的系统都必须提供对 GET、POST、PUT 和 DELETE 类型的 HTTP 调用的支持。在今天的文章中，我们将了解如何管理对安装 FHIR 适配器时自动配置的端点的 POST 调用。

如果我们回顾资源存储调用的 FHIR 规范，我们会发现它告诉我们，用于调用的 URL 必须遵循以下格式：

http(s)://server_url/{endpoint}/{Resource}

在我们的示例中，我们将不使用安全调用，因此我们的 URL 将如下所示：

http://localhost:52774/Adapter/r4/Patient

由于我们想要记录新患者，因此我们必须在调用正文中使用患者数据进行 POST 调用。在我们的例子中，调用格式将是 application/fhir+json，不过我们也可以使用XML格式的application/fhir+xml，不会有任何问题。

保存患者资源

02/21/24-18:32:48:515 (7568) 3 InterSystems IRIS Internal Failure

Access Violation (0xC0000005) occurred at 00007FFF3DE9C4E8
Process = 00001D90 Thread = 0000203C
Exception Count=1 b_msyslog=0 b_DumpVar=0 b_DumpVar2=0
b_GRelease=0 b_GRelease2=0 b_DeqRes=0 b_DeqRes2=0
Job Type = CSP server
ContextFlags = 0010005F Registers:
RAX=00007FFF3DE9C4E8 RBX=000000C2E5554800 RCX=000000C2E7AFFC00
RDX=000000C2E7B00000 RSI=00000000FFFFFFC0 RDI=00000000000003FF
RSP=000000C25CEBD2F8 RBP=0000000000000000 R8 =0000000000000001
R9 =00007FFF3DE60000 R10=000000C2E7AFFC00 R11=000000C2E7AFFC00

世界各地的医院和医疗系统、支付方、技术提供商和研究人员都使用InterSystems解决方案来打破互操作性障碍，简化FHIR应用程序的开发和交付工作。

SMART on FHIR 应用

纽约州健康信息网络Hixny使用InterSystems HealthShare Unified Care Record®，为美国最大的公共卫生信息交换机构Healthix开发了一个SMART on FHIR应用程序。每当临床医生查看患者记录时，该创新应用程序都会并排显示患者的社交和病史。该解决方案允许临床医生评估健康的社会决定因素，并直接从其现有的应用程序和工作流程中进行社会服务转介，从而简化互动并提高提供者的效率。HealthShare Unified Care Record 使 Hixny 能够轻松地以单一、一致的格式维护所有数据，无论其来源如何。

数据转换

FHIR 用例集： 打破数字医疗壁垒，实现高质量发展

--促进互联互通，改进工作流程，提高数据洞察

简介

HL7® FHIR®（快速医疗互操作性资源）是以电子方式访问、交换和管理医疗信息的国际标准。与以往的标准不同，FHIR 可让帮助行业从业者轻松构建创新应用程序，有效地收集、汇总和分析来自不同来源的各种医疗保健和管理数据。医疗机构、社保/保险公司、政府机构、生命科学公司、医疗设备制造商和医疗科技等多种主体利用 FHIR 来简化信息流、提高数据洞察力、改善临床效果和业务成果。

FHIR 基于 JSON、HTTP 和 REST 等流行的网络技术。有了 FHIR，没有医疗信息化背景的软件开发人员也能使用熟悉的开发工具和开源技术，快速、轻松地满足政府机构、临床医生、研究人员、医疗行业从业者以及各类市场主体的数据需求。

FHIR 是一种灵活、适应性强的医疗数据模型，可轻松定制，以实现各种用例的互操作性。FHIR 由称为 "资源 "的离散、可计算的数据对象组成，以实现最佳效率。通过 FHIR 资源，应用程序可以访问单个医疗记录元素，而无需检索摘要文档中包含的所有数据。

本文回顾了 FHIR 的实际应用，并提供了 InterSystems 客户如何使用 FHIR 连接不同系统、加速数字化转型和提高数据洞察力的真实案例。

FHIR 商机无限

本篇文章会介绍一个简单的示例：如何使用IRIS 2023版自带的EnsLib.SQL.Service.GenericService 和EnsLib.SQL.Operation.GenericOperation将MySQL的数据库读取出来并灌入Oracle数据库，本示例以Windows环境为例。

1. 创建SQL网关连接，连到MySQL

1.1 在windows中创建MySQL ODBC连接

1.2 在IRIS中创建ODBC SQL网关连接，连接到MySQL

系统管理 -> 配置 -> 连接 -> SQL网关连接，连接类型选择‘ODBC’，给一个连接名称，现有的DSN选择在1.1中所有建立的DSN名称，填写连接用户名和密码，然后点击下方‘连接测试’，如果出现‘连接成功’，说明此连接能够正常工作

2. 创建SQL网关连接，连到Oracle

2.1 在IRIS中创建JDBC网关连接，连接到Oracle

系统管理 -> 配置 -> 连接 -> SQL网关连接，连接类型选择‘JDBC’，给一个连接名称，填写连接用户名和密码，填写驱动器名称和要连接的Oracle数据库的URL和本地OJDBC.jar的java类路径，然后点击下方‘连接测试’，如果出现‘连接成功’，说明此连接能够正常工作

3. 创建Production组件

3.1 业务服务

医院目前即将使用iris2023.1；里面包含了%External.Messaging.KafkaClient 类，需要设置kafka的链接，发送kafka消息，然后断开链接，能否跟springboot 一样；自动配置，kafka的链接交给iris来管理，保持长链接，不要断开；直接使用%External.Messaging.KafkaClient 发送消息；

InterSystems IRIS、Health Connect和上一代的Ensemble提供了优秀的互操作架构，但即便有低代码开发能力，很多开发者还是希望能用自己的技术栈语言在InterSystems的产品上开发互操作产品。

考虑到互操作产品本身的开放性要求和各个技术栈背后庞大的生态价值，InterSystems IRIS和Health Connect提供了Production EXtension (PEX)架构，让开发者使用自己的技术栈语言来开发互操作解决方案。目前PEX支持Java、.net、Python。

这里我们介绍使用Java利用PEX进行互操作产品的开发。

一 InterSystems IRIS上使用Java开发的基础

在进入PEX主题前，需要简单介绍一下Java在InterSystems IRIS上开发的各种技术选项，因为PEX也是以这些技术选项为基础的。

想请教一下压缩和截断操作的区别？会影响业务运行吗？

InterSystems 常见问题解答

如果系统24小时没有停止，旧的日志文件将根据“日志文件删除设置”在0:30删除。

导致日志文件保留的时间早于“日志文件删除设置”的一个可能原因是存在仍处于开放状态的事务。

在这种情况下，您将能够通过搜索执行事务的进程并完成事务来删除日志文件。

下面的示例检查是否存在未完成的事务，如果存在，则输出目标文件名和日志记录信息。

（示例可以从这里下载

*注意*如果要检查的日志文件较大或日志文件较多，则执行需要时间，因此请联系我们的支持中心。

第七章 使用 SQL Search - 同义词表

同义词表

要实现同义词表，请将该表定义为扩展 iFind.Synonym 抽象类的持久类。

此类定义了两个属性：FromTerm 和 ToTerm。一对 FromTerm 和 ToTerm 属性将 ToTerm 定义为 FromTerm 的同义词。如果查询包含 FromTerm，SQL 搜索将使用 ToTerm 来扩展查询。

该查询使用此类的 GetMatch() 方法根据查询词在同义词表中搜索同义词。

在查询执行期间，SQL 搜索会检查单个单词单元或位置搜索短语是否存在任何同义词。例如，在同义词表中定义了两个同义词对（“persons”、“people”）和（“walk”、“run”）。对短语“persons walk”执行 SQL 搜索查询。如果同义词表与查询关联，则 SQL 搜索不仅返回与原始查询匹配的文档，还返回与以下任一查询匹配的文档：“people run”、“people walk”和“people run”。

但是，如果 search_items 字符串为 '"persons walk"'，则不会发生查询扩展，因为 SQL 搜索不会扩展位置短语搜索中的任何单词。位置短语本身是查询扩展的最小单位。但是，如果定义一个同义词对，如 (“persons walk”、“persons walk and run”)，SQL 搜索会将查询“persons walk”扩展为“persons walk and run”。如果 ToTerm 包含多个单词，SQL 搜索会将其视为位置短语。 ToTerm 可以是任何有效的位置短语；它可以包含 * 或 ?通配符。

注意：同义词表不能与正则表达式搜索 (search_option=4) 一起使用。

高亮

可以使用 search_items 语法突出显示返回文本中的单词。突出显示语法为：

(text,search_items,search_option)

search_items：突出显示使用与搜索相同的 search_items 语法。这允许对返回的记录使用相同的 search_items 值并突出显示这些记录中导致它们返回的字符串。这还允许使用 TestSearchString() 方法来验证突出显示的 search_items 语法。但是，由于突出显示应用于每个匹配项的每个实例，因此突出显示会忽略 search_items 字符串中的 search_items 语法 AND、OR 和 NOT 逻辑运算符。

search_option：可选的 search_option 可以是 0（默认值）或 4（正则表达式）。

可以使用以下任一方法应用突出显示：

• 选择突出显示的项目：

SELECT %iFind.Highlight(Narrative,'"visibility [1-4] mile*" AND "temp* ? degrees"') 
FROM Aviation.TestSQLSrch 
WHERE %ID %FIND search_index(NarrBasicIdx,'"visibility [1-4] mile*" AND "temp* ? degrees"',0,'en')

• 实用方法突出显示：

可以使用 %iFind.Utils.Highlight()方法来执行 SQL 搜索并对结果应用突出显示。

默认情况下，突出显示会在字符串中的适当位置插入 <b> and </b> (bold) XML 标记。默认情况下，突出显示不区分大小写。

突出显示可与任何 search_option 一起使用，包括正则表达式搜索 (search_option=4)，如以下示例所示：

  SET x="Time flies like an arrow. other stuff. Fruit flies like a banana."
  WRITE ##class(%iFind.Utils).Highlight(x,"\p{LU}(\p{L}|\s)+",4)

与单词搜索一起使用时，此方法会单独突出显示每个指定单词的每次出现。

当与位置短语搜索一起使用时，此方法会突出显示位置短语的每次出现。

作为针对数据导入处理性能和错误（锁定表已满）的衡量标准，可能需要调整常规内存堆 (gmheap) 和锁定表大小 (locksiz) 参数。

事实上，您可以使用终端和管理门户来检查当前分配了多少通用内存堆。

★终端用

// 一般メモリヒープサマリUSER> w $system .Config.SharedMemoryHeap.GetUsageSummary() 4992226 , 6029312 , 59441152

通用内存堆摘要以使用量、分配量和配置量（字节）的形式显示返回值。

使用量是分配的锁表、进程表等实际使用的量。
分配量是gmheap区域中锁表、进程表等分配的量。
配置量为gmheap(KB)+IRIS系统附加区，即当前最大可用量（实际通用内存堆区值）。

如上所述，配置数量与配置参数 gmheap 的独立值不匹配。
这是因为IRIS自动将内部使用的内存区域添加到配置参数gmheap中来配置通用内存堆区域。详情请参阅下面的文档。

关于gmheap

您可以使用以下命令获取锁表的使用情况：
返回值显示为可用量、用户可用量和已用量（字节）。详情请参阅这篇文章。

%SYS > w##class (SYS. Lock ).GetLockSpaceInfo() 16772624 , 16764624 , 4592

★用于管理门户

您可以从“系统操作”>“系统使用情况”>“共享内存堆使用状态”进行检查。  

Hi 开发者们，

我们非常高兴地邀请大家参加新的 InterSystems 在线编程竞赛，此次编程大赛关注于“FHIR与数字医疗互操作性”这个主题。

🏆 InterSystems编程大赛：FHIR 与数字医疗互操作性🏆

时间： 2024年1月15日至2月5日（美国东部时间）

奖金池： 14,000 美元

本文汇聚了InterSystems IRIS医疗版互联互通套件产品用例视频，共19个视频，欢迎收藏、观看！您也可以通过B站视频合集观看全部内容。

Gartner魔力象限是业内知名的分析报告，针对特定市场进行严谨、基于事实的研究后发布的魔力象限报告，可为用户提供全面视图，以便其了解在高速增长、差异化明显的市场中供应商的相对位置。在魔力象限中，供应商被定位在四个象限中：领导者（Leader）、挑战者（Challenger）、远见者（Visionary）和利基玩家（Niche Player）。

2023年年底，在 Gartner 2023年最新发布的“云数据库管理系统（Cloud DBMS）魔力象限”中，InterSystems再次荣膺“挑战者”（Challenger）称号，这是InterSystems第三次入围这一报告并得到认可（2022年“远见者”，2021年“挑战者”）。

Gartner此次评估面向包括InterSystems在内的19家云数据库管理系统供应商进行。我们相信，Gartner魔力象限“挑战者”这一定位，证明了InterSystems有能力挑战现状、推动创新，为市场提供独特的解决方案。

第十六章 调用Callout Library函数

Callout 库是一个共享库（DLL 或 SO 文件），其中包含 $ZF Callout 接口的挂钩，允许各种 $ZF 函数在运行时加载它并调用其函数。 $ZF Callout 接口提供了四种不同的接口，可用于在运行时加载 Callout 库并从该库调用函数。这些接口的主要区别在于如何识别库并将其加载到内存中：

• 使用 $ZF() 访问 iriszf 标注库描述了如何使用名为 iriszf 的特殊共享库。当该库可用时，可以通过 $ZF("funcname",args) 形式的调用来访问其函数，而无需事先加载该库或指定库名称。
• 使用 $ZF(-3) 进行简单库函数调用描述了如何通过指定库文件路径和函数名来加载库并调用函数。它使用简单，但虚拟内存中一次只能有一个库。与其他接口不同，它在调用库函数之前不需要任何初始化。
• 使用 $ZF(-5) 通过系统 ID 访问库描述了一种可用于一次有效维护和访问多个库的接口。可以同时加载和使用多个库，每个库所需的处理开销比 $ZF(-3) 少得多。内存中的库由加载库时生成的系统定义的 ID 来标识。
• 使用 $ZF(-6) 按用户索引访问库描述了处理大量标注库的最有效接口。该接口通过Global定义的索引表提供对库的访问。该索引可供 IRIS 实例中的所有进程使用，并且多个库可以同时位于内存中。每个索引库都被赋予一个唯一的、用户定义的索引号，并且可以在运行时定义和修改索引表。当库文件被重命名或重新定位时，与给定库 ID 关联的文件名可以更改，并且此更改对于按索引号加载库的应用程序来说是透明的。

使用 $ZF() 访问 iriszf 标注库

当名为 iriszf 的 Callout 库在实例的 <install_dir>/bin 目录中可用时，可以通过仅指定函数名称和参数的 $ZF 调用来调用其函数（例如，$ZF("functionName",arg1, arg2)).。无需事先加载库即可调用 iriszf 函数，并且实例中的所有进程都可以使用 iriszf 函数。

自定义 iriszf 库是通过创建标准 Callout 库、将其移动到实例的 <install_dir>/bin 目录并将其重命名为 iriszf（具体为 iriszf.dll 或 iriszf.so，具体取决于平台）来定义的。

以下是编译 simplecallout.c 示例（请参阅“创建 Callout 库”）并将其设置为 iriszf 库的步骤。这些示例假设实例在 Linux 下运行，安装在名为 /intersystems/iris 的目录中，但所有平台上的过程基本相同：

1. 编写并保存 simplecallout.c：

#define ZF_DLL
#include "iris-cdzf.h"
int AddTwoIntegers(int a, int b, int *outsum) {
  *outsum = a+b;  /* set value to be returned by $ZF function call */
  return IRIS_SUCCESS;  /* set the exit status code */
}

ZFBEGIN
  ZFENTRY("AddInt","iiP",AddTwoIntegers)
ZFEND

2. 生成Callout库文件（simplecallout.so）：

gcc -c -fPIC simplecallout.c -I /intersystems/iris/dev/iris-callin/include/ -o simplecallout.o
gcc simplecallout.o -shared -o simplecallout.so

3. 从 IRIS 终端会话中使用 $ZF(-3) 测试库：

USER>write $ZF(-3,"/mytest/simplecallout.so","AddInt",1,4)
5

4. 现在安装该库以与 $ZF() 一起使用。将 simplecallout.so 复制到 <install_dir>/bin中，并将其重命名为 iriszf.so：

cp simplecallout.so /intersystems/iris/bin/iriszf.so

5. 确认可以从 IRIS 会话中使用 $ZF() 调用代码：

USER>write $zf("AddInt",1,4)
5

iriszf 库在首次使用时加载一次，并且永远不会卸载。它完全独立于本章前面描述的其他 $ZF 加载和卸载操作。

注意：静态链接库 $ZF Callout Interface 的早期版本允许将代码静态链接到 InterSystems 内核并使用 $ZF() 进行调用。不再支持静态链接，但 irisz 库提供相同的功能，无需重新链接内核。

第十五章 创建Callout Library - 处理 UNIX 信号处理错误

处理 UNIX 信号处理错误

在 UNIX 及相关操作系统下运行时，如果进程收到信号，某些系统调用可能会失败，最常见的是打开、读取、写入、关闭、ioctl 和暂停。如果函数使用任何这些系统调用，代码必须能够区分真正的错误、Ctrl-C 和应重新启动的调用。

以下函数允许检查异步事件并在 $ZF 中设置新的警报处理程序。函数声明包含在 iris-cdzf.h 中：

sigrtclr()

int sigrtclr(); — 清除重试标志。应在使用 sigrtchk() 之前调用一次。

dzfalarm()

int dzfalarm(); — 建立新的 `SIGALRM 处理程序。

进入 $ZF 时，会自动保存先前的处理程序。退出时会自动恢复。用户程序不应改变任何其他信号的处理。

sigrtchk()

int sigrtchk(); — 检查异步事件。每当以下系统调用之一失败时就应该调用：open、close、read、write、ioctl、pause 或进程收到信号时失败的任何调用。它返回一个代码，指示用户应采取的操作：

• -1 — 不是信号。检查 I/O 错误。查看 errno 变量的内容。
• 0 — 其他信号。从中断点重新开始操作。
• 1 — SIGINT/SIGTERM。使用 SIGTERM“return 0”退出 $ZF。这些信号被适当地捕获。

用于控制某些设备的典型 $ZF 函数将使用类似于以下伪代码的逻辑：

if ((fd = open(DEV_NAME, DEV_MODE)) < 0) {
    Set some flags
    Call zferror
    return 0;
}

如果进程收到信号，open 系统调用可能会失败。通常这种情况不是错误，应该重新启动操作。但是，根据信号，可能会采取其他操作。因此，为了考虑所有可能性，请考虑使用以下代码：

sigrtclr();
while (TRUE) {
    if (sigrtchk() == 1) return 1 or 0;
    if ((fd = open(DEV_NAME, DEV_MODE)) < 0) {
        switch (sigrtchk()) {
             case -1:
                /* This is probably a real device error */
                Set some flags
                Call zferror
                return 0;
            case 0:
                /* A innocuous signal was received. Restart. */
                continue;
            case 1:
                /* Someone is trying to terminate the job. */
                Do cleanup work
                return 1 or 0;
        }
    }
    else break;
}
/*
Code to handle the normal situation:
open() system call succeeded
*/

注意：记住：错误处理代码绝不能改变信号的处理，除非调用 dzfalarm() 来建立新的 SIGALRM 处理程序。