第二十四章 TCP 客户端 服务器通信 - 当前 TCP 设备

当前 TCP 设备

可以使用 %SYSTEM.TCPDevice方法返回当前 TCP 设备的 IP 地址和端口号。可以使用 方法列出这些方法，如下所示：

  DO $SYSTEM.TCPDevice.Help()

可以通过在 中指定方法名称来显示有关特定方法的信息，如以下示例所示：

  DO $SYSTEM.TCPDevice.Help("LocalAddr")

IMP>DO $SYSTEM.TCPDevice.Help("LocalAddr")
method:class的描述 LocalAddr:%SYSTEM.TCPDevice
 
LocalAddr(Format:%Integer=0)
Get local IP address of current TCP device.<br>
<br>
<b>Parameters:</b> <br>
<b>Format</b> - The format of address to be returned. If this argument is omitted the default value is 0. The value could be:<br>
<ul><li>0: in text format,  'dotted' decimal string for IPV4, colon-hex address string for IPV6.</li>
<li>1: in binary format, 4 character length for IPV4, 16 characters for IPV6.</li></ul>
<b>Return:</b> <br>
Returns the local IP address associated with the TCP device. It could be in binary or text format depends on the <b>Format</b> parameter.
For binary format the IP address is in Network order.<br>
If the current device ($IO) is not a TCP device, it gets <FUNCTION> error.<br>
If the TCP device is in 'listening' state, the IP address would be all zeros (INADDR_ANY).<br>
 

第二十二章 TCP 客户端 服务器通信 - TCP设备的OPEN和USE命令关键字

TCP设备的OPEN和USE命令关键字

可以使用位置参数(如上所述)或关键字参数。下表描述了使用和命令控制TCP设备的关键字。还有其他只能在命令中指定的关键字(本章稍后将描述)。所有关键字参数都是可选的。

设备的和USE命令关键字

第二十一章 TCP 客户端 服务器通信 - 客户端OPEN命令

客户端OPEN命令

客户端OPEN命令与服务器端OPEN命令只有一个方面的不同：第一个设备参数必须指定要连接的主机。要指定主机，需要包括客户端识别为主机的名称或Internet地址。

一旦建立连接，开就会成功。此时，可以读取或写入该设备。但是，如果连接的服务器端是另一个 IRIS进程，则在使用令将一些数据从客户端发送到服务器之前，服务器不会完成其连接端。因此，必须在发出任何读取命令之前发出写入命令。

客户端 命令的一些示例是：

   OPEN "|TCP|4":("hal":4200::$CHAR(3,4)):10

此命令在端口 4200 上打开到主机 的连接。它没有指定模式字符串。它指定了两个终止符（ 和 ），以及默认的输入和输出缓冲区大小。它指定 秒的超时。

以下命令与上一个命令相同，只是目标是 格式的显式 地址。

   OPEN "|TCP|4":("129.200.3.4":4200::$CHAR(3,4)):10

可以使用 关键字 来指定要使用的协议。

下面的命令连接到远程主机“larry”上的时间服务器，并在主输入设备上以格式打印远程主机的时间。它使用服务名，本地系统将其解析为端口号:

   OPEN "|TCP|4":("larry":"daytime":"M")
   USE "|TCP|4" 
   READ x
   USE 0
   WRITE x

第二十章 TCP 客户端 服务器通信 - 立即发送模式（Q 模式）

立即发送模式（Q 模式）

在立即发送模式下，每个 WRITE 命令都作为其自己的数据包输出。如果不使用立即发送模式，则必须包括终止符或发出命令 WRITE *–3 以输出数据包。

通过指定“Q”模式字符或(或/SEN)关键字参数进入此模式。要关闭此选项，请指定以下任一选项：

   USE TCPDEVICE:(/SEN=0)
   USE TCPDEVICE:(::"-Q")

要重新打开此选项，请指定以下任一选项：

   USE TCPDEVICE:(/SEN=1)
   USE TCPDEVICE:(::"+Q")

立即发送模式与模式结合使用，前者在每次写入时创建一个包，后者在创建每个包时立即发送。当这两个选项都启用时，单个数据突发的传输速度将最大化。当每个数据单元的及时传送至关重要时，例如在传输鼠标移动时，这是有用的。当两者都关闭时，一个数据包可能包含多个写入，一个传输可能包含多个数据包。这减少了网络流量并提高了整体性能。立即发送模式的默认设置为关闭。模式的默认设置为打开。

流模式(模式)

在流模式下， 不会保留数据流中的TCP消息边界。发送时，如果数据不适合消息缓冲区， 会在将数据放入缓冲区之前刷新缓冲区。

接收时，可以接收最大字符串长度的数据。所有读取都等待达到终止符或缓冲区变满的完全超时。

第十九章 TCP 客户端 服务器通信 - 数据包模式

数据包模式

如果未指定模式，则默认为数据包模式。如果流模式被禁用，则该模式默认为分组模式。

在分组模式中，只要有一些数据要返回，读取命令就会完成。数据包模式允许在输出缓冲区中构建整个TCP数据段，然后通过发出WRITE*-3或WRITE！命令。

如果在没有要发送的字符的情况下发出来启动一个发送操作，则会收到一个错误。如果发出空字符串，则会收到错误。

在分组模式下可以发送的字符串的最大长度为1024个字符。如果在未刷新缓冲区的情况下超过此限制，则会收到错误。

因为 TCP/IP 忽略长度为 的记录，所以如果在其中没有字符时刷新写入缓冲区，会收到 错误。

在服务器收到连接请求之前，从服务器到客户端的命令会在服务器上产生 错误。

回车模式(模式)

此模式修改对输入和输出的回车处理。

在输出时， 生成，而WRITE#生成。

在输入时，在启用模式的情况下，服务器尝试将相邻的和或相邻的和记录为中的单个终止符。如果和没有在彼此的短时间间隔内到达，则将它们作为单独的终结器进行处理。默认情况下，间隔为秒。

监控断开模式(模式)

此模式打开或关闭异步断开监控。通过指定模式字符或关键字参数来激活此模式。当指定时，将激活断开监视；当指定时，将停用断开监视。

当被激活时，大约每隔秒轮询一次连接。当检测到断开连接时，会发出一个错误。

第十八章 TCP 客户端 服务器通信 - 使用OPEN命令 - Supported参数

Supported 参数

parameters 参数可以是以下格式之一：

hostname

(hostname{:port{:mode{:terminators{:ibufsiz{:obufsiz{:queuesize{:keepalivetime}}}}}}})

parameters 参数中的参数如下：

• hostname - 可选 — IP 主机的名称、IPv4 协议格式的 地址或 协议格式的 地址。指定为带引号的字符串。客户端 需要主机名；对于服务器端 ，省略（由占位符冒号表示）。

• - 可选 — 如果存在，这是用于连接的 端口号。如果此端口号为空或省略，则端口号从设备名称的数字部分派生。该参数可以是十进制的端口号，也可以是服务名，提交给本地系统的TCP服务名解析器。

• - 可选——用引号括起来的字母代码字符的字符串。字母代码可以按任何顺序指定；由于 按从左到右的顺序执行字母代码，因此字母代码之间的交互在某些情况下可能决定首选顺序。默认为数据包模式。模式字符串可以由以下一个或多个字母代码组成：

  • A-接受模式。如果A处于打开状态，则在接受来自客户端作业的连接后，服务器上的初始读取将立即以零长度字符串终止。

第十七章 TCP 客户端 服务器通信 - 使用OPEN命令

使用OPEN命令

OPEN命令保留一个TCP绑定设备供使用。其语法为：

OPEN devicename:parameters:timeout:mnespace

• devicename - 一个|TCP|格式的字符串，后面跟着一些数字数字。设备名称的数字部分称为设备标识符。如果OPEN参数中没有指定端口号，则该设备标识符必须是唯一的位端口号。如果在参数中指定了端口号(这是首选的实践)，这个设备标识符可以是任何唯一的数字(最多)，只要单个作业使用的所有TCP设备名称是不同的。

• - 可选-一系列一个或多个设备参数，用括号括起来，用冒号()分隔。如果省略了某个参数，请为缺少的参数指定冒号分隔符。(对于服务器端OPEN，始终省略第一个参数。)。具体参数说明如下。

  如果只指定第一个参数()，可以省略括号。例如客户端。如果不指定参数，则可以省略圆括号，但必须保留冒号作为分隔符。例如:服务器端。

• - 可选- 尝试打开TCP设备的最大秒数。如果在此间隔内没有成功，它会将设置为，并将控制权返回给进程。如果成功，它会将设置为。在来自客户端的命令中包含超时可防止客户端系统在服务器忙于处理另一个客户端时尝试打开连接时挂起。服务器一次只能打开一个连接。

• - 可选-支持所有的对象脚本OPEN命令。没有用于绑定的预定义助记符空间。

第十六章 TCP 客户端/服务器通信

TCP 客户端/服务器通信

本章介绍如何使用 TCP/IP 在 IRIS 数据平台进程之间设置远程通信。

IRIS 支持两种互联网协议 ()：TCP 和 。这些 协议允许 进程与本地或远程系统上的进程通信，无论这些进程是否正在运行 。

• TCP IRIS 传输控制协议 (TCP) 绑定。在服务器和单个客户端之间建立双向连接。提供具有错误检查和纠正以及消息确认的可靠字节流数据传输。
• UDP IRIS 用户数据报协议 () 绑定。提供服务器和大量客户端之间的双向消息传输。 不是基于连接的；每次传输数据包都是一个独立的事件。为本地数据包广播和远程多播提供快速和轻量级的数据传输。本质上不如 可靠。不提供消息确认。

TCP 绑定将 连接到广泛的网络标准，这样 IRIS 用户就可以通过 命令使用底层网络协议的基本功能。

协议允许系统进行通信，即使它们使用不同类型的网络硬件。例如， 通过 连接在使用以太网的系统和使用令牌环的另一个系统之间传输消息。 控制数据传输的准确性。 或 协议在网络或 上的不同系统之间执行实际数据传输。

使用 绑定，可以创建客户端-服务器系统的客户端和服务器部分。在客户端-服务器类型的分布式数据库系统中，一个或多个客户端系统上的用户可以处理存储在另一个系统（称为服务器）上的数据库中的信息。

连接概述

第十五章 IRIS 进程之间的通信

本页介绍如何在两个或多个 IRIS 数据平台进程之间建立通信。

介绍

作业间通信 (IJC) 设备是一组特殊设备编号，可让在两个或多个 IRIS 进程之间传输信息。这些流程可以是作业流程或交互式流程。

IJC 设备成对工作。最多可以有 个 IJC 设备对。使用称为接收器的偶数设备来读取数据。使用称为发送器的奇数设备来写入数据。尝试从发送器读取或写入接收器会导致 错误。

可以向 设备发出 命令，就像向任何其他设备一样。向设备发出OPEN和USE命令后，进程可以发出：

• 向接收器设备读取命令
• 将命令写入发送器设备

一次只能有一个进程可以打开设备。

对基于 IRIS 设备表中映射的相对顺序，可以使用管理门户的配置选项查看和编辑该表。

每对设备都与一个 内存缓冲区关联。当进程向任何奇数 设备发出命令时 会将数据写入该设备对的缓冲区中。当另一个进程向该对中的偶数设备发出命令时 会从同一缓冲区读取数据。

写入的数据以先进先出的方式缓冲在内存中。如果在设备为空时发生 ，则发出该信号的进程将挂起，直到另一个进程发出相应的 信号。缓冲区已满时发生的写入将挂起，直到另一个进程从该缓冲区读取数据。

将消息写入缓冲区后，即使关闭发送器，它也会保留在那里直到被读取。多个用户可以向发射器发出 、 、 和命令，一次一个。随后的

第十四章 本地进程间通信（管道） - 用于进程间通信的 CLOSE 命令

用于进程间通信的 CLOSE 命令

如果使用带Q (/QUEUE) 参数代码的OPEN创建子进程，则该子进程可能会在设备上的CLOSE操作中继续存在。排队的进程间通信管道的生存能力取决于平台。在 系统上，子进程始终在后继续存在。在 系统上，进程的生存取决于进程的年龄。刚刚启动的子进程不会在操作中幸存，但是一旦子进程完全建立，它就会在 操作中幸存。

在 系统上，可以指定关闭管道命令设备时命令应等待的时间。超时默认值为 30 秒。可以通过指定命令位置参数来修改此默认值。可以通过指定可选的位置参数来覆盖命令的默认或指定超时。 “I”参数指定立即关闭（ 秒后关闭）。 语法如下：

CLOSE cpipename:"I"

使用命名管道与 进行通信

在 上，在 中使用命名管道就像使用 设备一样，但使用设备名称 。 参数如下：

OPEN "|NPIPE|3":(server:pipename)

其中是计算机名称， 是要连接到的管道的名称。

要连接到本地管道名，请使用“.” （引用的期间）作为服务器。要创建管道（作为服务器），请使用 （不含内容的引号）作为服务器名称。以下是所有有效的服务器名称：

   OPEN "|NPIPE|3":(".":"localpipe")
   OPEN "|NPIPE|3":("mother":"test")
   OPEN "|NPIPE|3":("":"info")

第十三章 本地进程间通信（管道） - 用于进程间通信的 READ 命令

用于进程间通信的 READ 命令

语法

READ:pc readargument,...

READ 从管道读取数据。

其中reargument可以是：

formatting-mode
string
variable:timeout
*variable:timeout
variable#n:timeout

将 I格式化模式参数与管道一起使用。 参数允许对命名管道发出定时READ，而不会丢失跟随在一个部分记录中的任何数据。错误。当在上使用此参数时， 会忽略消息。

默认情况下，格式化模式的值处于关闭状态。如果在没有超时的情况下在命令中包含此参数，则进程将挂起，直到有数据要处理。

退出代码

可以检索命令管道 () 进程的退出代码。必须在 之前检索此退出代码设备已关闭。它是通过%SYSTEM.Process 类的方法获得的。退出代码始终是整数值。如果退出代码不可用，该方法将返回空字符串并设置状态参数和解释，如以下示例所示：

  SET exitcode=$SYSTEM.Process.PipeExitCode(device, .status)
  IF exitcode="" {DO $SYSTEM.OBJ.DisplayError(status)}
  ELSE {WRITE "CPIPE exit code is ",exitcode } 

第十二章 本地进程间通信（管道） - OPEN 和 USE 命令关键字

OPEN 和 USE 命令关键字

以下列表描述了用于使用OPEN和命令控制进程间通信管道的关键字。

/IOTABLE[=name]

默认值：如果未指定名称，则使用设备的默认 转换表。

对应K\name\参数代码，为设备建立I/O转换表。

默认值：

与K参数代码相关。 或 /TRANSLATE= n （对于的非零值）启用设备的 转换。 如果值为零，则会禁用设备的 转换。

默认值：如果未指定名称，则使用设备的默认 操作表。

对应参数代码，为设备建立动作表。

仅限 关键字

以下列表描述了仅使用命令控制进程间通信管道的关键字。

指定要在新进程中设置的环境变量。有两种指定值的方法：

• 明确地说。例如：

/ENV=(name1:value1,name2:value2)

• 通过多维数组。例如：

 Set arr(name1)=value1
 Set arr(name2)=value2

// then later use the following in the OPEN command:
  /ENV=arr...

这些示例显示了两个环境变量，但可以有任意数量。显式列表必须括在括号中。

默认值：

对应于 参数代码，它指定应无限期地重试操作（忽略任何 条件）或直到指定的超时到期。 或 （对于n的非零值）启用参数代码，

第十一章 本地进程间通信（管道） - OPEN 命令管道示例

OPEN 命令管道示例

以下是有效的命令管道OPEN语句。

各位社区成员，大家好！

我们很高兴推出一种全新的方式让您展示创造力和技能！ 这次，我们邀请您参加我们首次发起的视频挑战：

📹 InterSystems 技术视频挑战 📹

请在 2024 年 10 月 21 日到 11 月 10 日提交与 InterSystems IRIS 产品或服务相关的任何主题的视频。

🎁 人人有礼 + 主要奖品！

第十章 本地进程间通信（管道） - 用于进程间通信的 OPEN 命令

用于进程间通信的 OPEN 命令

OPEN命令允许程序与 IRIS 外部的进程进行通信。

OPEN Arguments

管道名称

仅命令管道— “|CPIPE|”或"" ，其中表示用户指定的唯一标识符。

程序

命令管道可以使用命令 或不使用命令 shell（直接）执行程序。在大多数情况下，首选不使用命令 shell 执行。标准管道使用命令 执行程序。

仅命令管道— 要在不使用命令 的情况下执行，请指定 。如果程序有参数，则必须使用 关键字指定它们。如果指定 或 关键字，则无需命令 即可执行程序： 、 和都是有效的语法。 可以采用单个参数、以逗号分隔的参数列表或数组。例如， 。可以使用数组指定可变数量的参数：

  SET array(1)=arg1, array(2)=arg2, array=2
  OPEN device:(/COMMAND=cmd:/ARGS=array...)

要使用命令 执行，请指定 ，并省略 和 关键字。

程序字符串包含系统上安装的程序的完整路径名。它包含要在主机系统上执行的命令名称及其参数（如果有）。对于标准管道，限制为 个字符。

第九章 本地进程间通信（管道）

本页介绍如何通过管道与 IRIS® 数据平台外部的进程建立通信。

介绍

可以通过管道在 IRIS 进程和外部 UNIX® 或 Windows 进程之间进行通信，就像在 或 操作系统级别一样。可以将输出发送到管道或从管道接收输入。管道为单向；不能同时读取和写入同一个程序。

当打开另一个程序的管道进行输出时，可以像写入顺序文件一样对其进行写入。然后程序使用编写的内容作为其输入流。当希望 进程与外部进程共享资源时，此功能特别有用。

打开 实用程序的管道

可以打开通往 IRIS 实用程序以及 或 Windows 进程的管道。在将管道用于实用程序 之前，系统管理员必须在 系统上定义管道设备。

系统管理员定义管道设备后，当运行实用程序（例如 ）时，可以使用系统管理员定义的助记符回答提示。输出会自动发送到该设备。

管道和命令管道

支持标准管道和命令管道 ()。标准管道用于相对较短的命令字符串，其中命令名称及其参数少于 256 个字符。当命令字符串长度为 个字符或更长时，使用命令管道。在这两种情况下，管道只能在 和 系统上使用。

标准管道

以下是标准管道的命令语法：

OPEN program:(parameters):timeout

因为

第八章 在 I/O 命令中指定设备 - 通过 IRIS ID 指定设备

通过 IRIS ID 指定设备

为了与其他 产品兼容并方便起见，可以通过设备编号（存储在设备表中）来引用设备。系统管理员可以使用管理门户将这些号码链接到设备。选择“系统管理” 、 “配置” 、 “设备设置” 、 “设备”以创建新设备或编辑现有设备。

系统管理员还可以将一个数字转换为另一个数字。因此，可以发出OPEN 47 ， IRIS 会将其转换为OPEN 49 。

下表显示了设备编号。

IRIS 设备编号和设备

示例

要打开假脱机程序，请发出以下命令：

OPEN 2

指定磁盘上的文件

可以使用双引号括起来的操作系统文件规范来打开磁盘文件。

Windows 文件规范具有以下格式：

文件规范具有以下格式：

/directory/name

UNIX 示例

如果 或

我们公司在和其他公司合作，需要从Cache2016的数据库中执行sql获取数据

sql的内容是调用存储过程

CALL DHCXXXXice.MKPIQuery_QueryXXXX('K007XXXX.JJR','2024-08-01','2024-08-01')

在java代码中执行会报错误如下

但是通过数据库连接工具却能查询到结果

通过数据库连接工具查询到 该存储过程，可接收参数为8个

尝试  CALL DHCXXXXice.MKPIQuery_QueryXXXX('K007XXXX.JJR','2024-08-01','2024-08-01',null,null,null,null,null)

在通过java连接查询时，依然报Parameter list mismatch错误

通过jdbc连接工具依然能查出结果

第七章 在 I/O 命令中指定设备

当使用 I/O 命令OPEN 、 USE和在除正在使用的设备之外的任何设备上处理 时，必须指定一个 设备。可以根据设备类型以三种方式之一指定设备，如下表所示。

在 命令中指定设备

请注意， 和 UNIX® 处理打印机I/O 的方式不同。有关详细信息，请参阅打印机。

按设备名称指定终端和打印机

如果的 操作是针对终端（或某些平台上的打印机），则可以使用操作系统（ 或 ）应用的设备名称来指定设备。形式如下：

OPEN "device"  
USE "device"  
CLOSE "device"

其中是设备的操作系统名称，用引号引起来。设备的最大长度为 个字符。

在 系统上指定终端

要打开连接到串行通信端口的 设备，请使用以下语法指定OPEN命令：

OPEN "comn:"

第六章 主设备、当前设备、空设备

明确使用主设备

USE 0或USE $principal向进程的主体设备隐式发出OPEN命令。如果另一个进程拥有该设备，则该进程会挂在隐式上，就像它遇到任何时一样。

为该进程不拥有的任何其他设备（由于先前的命令）发出命令会产生错误。

仅当进程获取设备时，没有超时的OPEN命令才将控制权返回给进程。可以通过键盘中断命令（如 ）中断打开命令。由于保护问题或无效设备名称而无法成功的OPEN将永远挂起。当在OPEN命令中指定超时时， 将在超时到期时将控制权返回给进程。

使用主设备的选项

根据主要设备的性质，可以指定其他特定于设备的参数，这些参数对于管道（进程间通信） 、文件和终端 是不同的。例如，可以使用 连接打开主设备：

USE $principal:(::/TLS=ConfigName)

其中是同一实例中定义的 配置的名称。

空设备

如果应用程序生成不希望出现在屏幕上的无关输出，可以将该输出定向到空设备。可以通过发出带有适当参数的 命令来指定空设备（见表）。 将其视为虚拟设备。

空设备参数

后续命令立即返回空字符串。随后的WRITE命令立即返回成功。没有读取或写入实际数据。 NULL 设备完全绕过

第五章 主设备、当前设备、空设备

一个进程拥有一台设备

一次只有一个进程可以拥有一个设备，顺序文件除外。

换句话说，在进程成功向设备发出OPEN命令后，在第一个进程释放该设备之前，其他进程都无法打开该设备。进程通过以下任一方式释放设备：

• 通过显式发出CLOSE命令。

• 通过停下来。

每个进程都有一个主设备

每个 IRIS 进程都有一个主要输入设备和一个主要输出设备。默认情况下，这些是同一设备。当您登录终端并激活 时，该终端将成为主要设备。由于 IRIS 隐式向该终端发出和命令，因此可以立即向它发出和命令。 主设备是操作系统指定为主输入设备的设备。 特殊变量包含主设备的设备 。

将 命令定向到当前设备

IRIS 将输入和输出操作（包括 、 、 和命令）定向到当前设备。 特殊变量包含当前设备的设备 。当在终端上登录 时， 最初包含终端的设备名称。换句话说，登录后，主设备和当前设备是相同的。在发出USE命令后，当前的设备（ 中包含的设备）通常是执行的最后一次命令中指定的设备。

尽管可以在编程器模式下对主设备以外的设备发出和 ，但每次 IRIS 返回到>提示符时，它都会隐式发出。要继续使用 以外的设备必须发出USE在>提示符下输入的每一行中输入命令。

当主要设备成为当前的设备时

当执行以下任一操作时，主要设备将自动成为当前设备：

• 首次登录。
• 发出USE 0或USE $principal

第四章 I O 输入输出简介 - Read 命令

Read 命令

该命令从当前设备读取数据。对于某些设备，以星号开头的参数返回 ASCII 数字信息；对于其他人来说，它们表示控制功能。

语法

READ variable:timeout

WRITE 命令

该命令将数据写入当前设备。对于某些设备，以星号开头的参数允许使用其 ASCII 数值写入 ASCII 字符；对于其他人来说，它们表示控制功能。对于某些设备，以 字符开头的参数指示写入该字符的次数。

语法

WRITE variable

语法允许使用在助记符空间中的 代码中定义的助记符来控制设备。助记符空间是一个 例程，必须在或命令中激活它，或者使用管理门户将其配置为设备的默认值。要了解如何定义和激活助记符空间，请参阅定义默认助记符空间。

要使用预定义的 助记符空间将光标移动到终端屏幕上的第 列第 2 行，请发出以下命令：

   WRITE /CUP(1,2)

命令

命令释放指定设备的所有权。 反转命令的效果。

语法

所需的设备名称、 号或助记符。

参数在 级别关闭设备，而不在操作系统级别关闭它。

K参数对 系统没有影响。该文件在操作系统级别关闭。

如果对主设备发出命令，则主设备将保持分配给您的进程，直到注销为止。

其他几个条件可能会影响的行为：

• 如果由于某种原因停止向设备的输出， IRIS

CPF merge(合并)

Automating Configuration of InterSystems IRIS with Configuration Merge

CPF merge通过合并一个人工编辑的merge file, 自动的配置新创建的iris instance， 或者修改已有的iris instance。适用于：

• 修改iris的系统配置(cpf文件中的内容)，比如系统参数，创建或者配置用户，角色，权限， 创建或者配置命名空间，数据库； 配置mirror, ECP连接等等。
• 操作不在cpf文件中的内容，比如 CreateApplication, CreateSSLConfig 等等， 一般是在 [Action]部分实现

Caché 和早期的IRIS版本提供了manifest功能，用来做IRIS实例的配置。 Manifest很繁琐，而且各个版本的配置中有细微的区别，非常难以管理。 如今有了CPF merge, maifest的所有功能都可以在CPF merge实现， 因此manifest在新版IRIS中也就完全被替代了。

执行merge

执行merge可以在操作系统命令行下执行， 如下面的例子

# 第2个参数可选，如果为空，自动使用系统当前的iris.cpf
$ iris merge iris /external/irismerge.conf /usr/irissys/iris.cpf

使用iris-main

iris-main是IRIS镜像的的ENTRYPOINT程序。 在Container中，ENTRYPOINT 指令允许你指定一个可执行程序或者脚本，作为容器启动后运行的主程序。这个程序会在容器启动时自动执行。

执行docker ps 命令可以看到当前container的ENTRYPOINT是什么：

hma@CNMBP23HMA demo % docker ps
CONTAINER ID   IMAGE                         COMMAND                 CREATED      STATUS      PORTS                                                               NAMES
8f31a857dc90   .../irishealth:2024.2   "/tini -- /iris-main"   3 days ago   Up 3 days   2188/tcp, 52773/tcp, 53773/tcp, 54773/tcp, 0.0.0.0:1980->1972/tcp   iris-a

hma@CNMBP23HMA demo %

把CSP.conf保存在container之外

在创建webgateway的container时，可以使用ISC_DATA_DIRECTORY=参数， 选择把CSP文保存在主机而不仅仅是container内部。如下面的例子: 使用volumnes映射了主机的./dur-wg-a目录到container的目录， 而command中的会讲webgateway的配置文件， log文件等保存在主机。

webgateway-apache:
        image: containers.intersystems.com/intersystems/webgateway-arm64:2024.1
        container_name: wg-tls
        hostname: wg-tls
        ports:
            - "8080:80"
            - "4433:443"
        volumes:
            - ./webgateway/csp:/external
            - ./dur-wg-a:/dur
        environment:
            - TZ=CST-8
            - ISC_CSP_CONF_FILE=/external/CSP-apache.conf
            - ISC_CSP_INI_FILE=/external/CSP-merge.ini
            - ISC_DATA_DIRECTORY=/dur

上一篇文章使用人工配置的方法简单的配置了webgateway container. 接下来来介绍如何在docker-compose里做自动化部署。

先总结我们要做的事情：

1. 配置到IRIS的连接。定义连接的iris的IP地址或者DNS, 以及连接的用户名密码 以及其他的对默认值的修改。
2. 配置apache2的配置文件，保证到IRIS的HTTP请求能发送给CSP Webgateway。
3. 很多时候，用户会希望使用HTTPS访问IRIS，因此需要在apache2上支持TLS。

这些是最基本的功能。除此之外， 用户还可能会要求建立WebGateway到IRIS的TLS连接，或者在Apache2部署自己的网页等等。后面的文章会一一介绍。

配置CSP.ini

上一篇文章中，我通过Webgateway管理页面定义了Webgateway到IRIS的连接，其实是定义了webgateway的配置文件CSP.ini。 无论WebServer是什么类型，IIS，Apache, Nginx, CSP.ini的都是一样的。在Linux中， CSP.ini位于/opt/webgateway/bin目录。

InterSystems提供了一个工具叫 CSP merge。 简单的说，就是可以定义一个被合并的文件, webgateway运行时会不停的扫描这个文件，发现有内容的修改，就把修改后的配置项合并到工作中的CSP.

IRIS image下载

参考：下载Images的在线文档

在网站上获得可以下载的InterSystems的各种docker镜像。如果只是安装Community版本， 不需要注册。如果是下载安装正式的版本，需要在网站注册，然后获得Login Token登陆。

#；这一部有可能需要科学上网,否则无法正常登陆

hma@CNMBP23HMA ~ % docker login -u="hma" -p="k8zIqpoafIUaViP2BA4gCZdcC4EeKyb0svSjnyVtcWMb" containers.intersystems.com
WARNING! Using --password via the CLI is insecure. Use --password-stdin.
Login Succeeded

# pull iris image，webgateway，Passhash, arbiter, etc.
hma@CNMBP23HMA ~ % docker pull containers.intersystems.com/intersystems/healthconnect-arm64:latest-cd
hma@CNMBP23HMA ~ % docker pull containers.intersystems.com/intersystems/webgateway-arm64:latest-cd
...

我在3年前写过同样内容的文章。随着IRIS版本的更新，安装的细节有了些变化，而且，尤其是2024年以后的版本不再使用PWS(Private Web Server), 安装最新版本的IRIS通常同时要安装一个外部的Web服务器，Apache或者nginx。 另外， 大家对自动部署的需要越来越多，因此我也会在下面的内容里面包括自动部署，配置iris, 安装软件等等内容。希望给各位一个基本完整的介绍。

内容列表如下：

基础篇

• IRIS images的下载和docker run
• apache-webgateway container到iris的连接
• nginx-webgateway container到iris的连接
• iris-main和在container外保存iris数据
• 配置iris的新方法：CPF merge ...

随时更新

第三章 I O 输入输出简介 - Use 命令

Use 命令

此命令使指定设备成为当前设备，并将特殊变量$IO设置为该设备。要使用主设备以外的设备，必须首先对其发出OPEN命令；否则，将收到错误。参数的含义与OPEN命令中的相同。

语法

USE device:(args):"mnespace"

device

所需的设备名称、 号或别名。设备的最大长度为 256 个字符。

args

可选— 某些设备所需的附加信息。管道（进程间通信） 、文件和终端 的可用参数不同。

mnespace

可选— 例程的名称，包含控制助记符的定义，当将 I/O 定向到该设备时，可以与 命令一起使用。

Windows 上的使用示例

此 示例显示了用于通过 连接到远程主机上的时钟服务器的命令。它使用服务名称 ，本地系统将其解析为端口号。 命令用 模式替换 模式并关闭所有用户终止符：

在 上的使用示例

此