第四十一章 终端输入 输出 - 协议终止符

协议终止符

OPEN 和 USE 协议定义了哪些 READ 输入字符、控制序列和击键被视为隐式终止符。这四种协议是 I（图像模式）、N（正常模式（默认））、R（读取行调用模式）和 T（终止符模式）：

• I（图像模式）接受所有 256 个八位字符作为数据，不将任何字符视为 READ 输入终止符或命令行编辑字符。因此，您应该在图像模式下仅使用单个字符或固定长度的READ操作。如果没有定义终止字符，普通的READ会导致错误。
• N（普通模式）和 C（CRT 模式）接受除以下六种字符之外的所有字符作为数据：ASCII 3、8、10、13、21 和 127。其中两种字符：ASCII 10（换行符）和 13（回车符）终止 READ 并提交输入。 ASCII 3 ( Ctrl-C ) 丢弃输入并发出如果启用 BREAK，则会出现错误。 ASCII 8（退格）和 127（删除）执行单字符退格擦除，然后继续读取。 ASCII 21 执行多字符退格，擦除所有先前的字符，然后继续读取。
• R（读取行调用模式）接受除以下 20 种以外的所有字符作为数据：ASCII 1 到 8、10 到 14、16、18、21、23、24、27 和 127。 ASCII 10（换行）和 13（回车） return) 终止 READ 并提交输入。 ASCII 3 ( Ctrl-C ) 丢弃输入并发出如果启用了 BREAK。其他字符执行以下命令行编辑功能：

1   ^A = beginning of line
2   ^B = back word
3   ^C = interrupt
4   ^D = delete current character
5   ^E = end of line
6   ^F = forward word
7   ^G = delete to beginning of word ("wipe word backward")
8   ^H = BS = destructive backspace
9   ^I = HT = horizontal tab (echoed as a SPACE)
10  ^J = LF = end of input
11  ^K = VT = forward character
12  ^L = FF = erase to end of line
13  ^M = CR = end of input (same as LF)
14  ^N = recall next input line
16  ^P = recall previous input line
18  ^R = back char (reverse)
21  ^U = erase to start of line
23  ^W = delete to end of word "gobble word forward")
24  ^X = erase entire line
27  ESC lead character for arrow and function keys
127 DEL = destructive backspace (same as BS)

• T（终止符模式）接受除 65 个控制字符之外的所有字符作为数据：ASCII 0 到 31 和 ASCII 127 到 159。这些字符中的大多数被视为 READ 终止字符。这包括制表符 (ASCII 9)，它在所有其他协议中被视为数据字符。一些字符被视为命令行控制字符： ASCII 3 ( Ctrl-C ) 丢弃输入并发出如果启用了 BREAK。 ASCII 8（退格）和 127（删除）执行单字符退格擦除，然后继续读取。 ASCII 21 ( Ctrl-U ) 和 ASCII 24 ( Ctrl-X ) 执行多字符退格，擦除所有先前的字符，然后继续 READ。 ASCII 27 是转义字符。
• IT（图像模式 + 终止符模式）接受除 65 个控制字符之外的所有字符作为数据：ASCII 0 到 31和 ASCII 127 到 159。它将所有控制字符视为 READ 终止符。

在任何这些模式中，都可以使用terminator参数显式指定其他终止符。由于图像模式通常用于位流数据，因此通常避免指定任何字符作为终止符。

第四十章 终端输入 输出 - 用于OPEN和USE的字母代码协议

用于OPEN和USE的字母代码协议

特殊情况或终端可能需要不同的协议。使用协议字母代码参数（或相应的关键字参数），可以更改 IRIS 与终端通信的规则。协议对正常读取和单字符读取的影响是一样的。

禁用所有特殊协议的正常模式足以满足大多数终端 I/O 的需要。在正常模式下，IRIS 会回显每个传入的 ASCII 字符，并将其发送回以显示在终端上。 Return或有效的转义序列结束READ命令。

对终端发出OPEN会关闭所有先前的协议，除非您使用 + 和 - 选项。

下表描述了有效的协议字符及其效果。

用于开放和使用的字母代码协议

协议字符串示例

以下一系列示例展示了协议字符串的功能。以下每个 USE 命令都建立在前面的 USE 命令建立的协议之上：

   USE 0:(80:"BP" )

字母代码 BP 打开 B 和 P 协议。此示例启用中断 (B) 并告诉 InterSystems IRIS 将终端视为打印设备 (P)。

   USE 0:(80:"P")

当它跟在上例中的USE命令之后时，该命令使 P 协议保持有效，但关闭 B 协议。

   USE 0:(80:"+R" )

+R 打开读行调用，不影响其他协议设置。

   USE 0:(80:"")

空字符串关闭所有协议。然而，P 或 C 协议仍然有效。

   USE 0:(80)

省略协议参数会使协议和显式终止符保持不变。

第四十章 终端输入 输出 - OPEN 和 USE 命令的关键字参数

OPEN 和 USE 命令的关键字参数

下表描述了使用OPEN和USE命令控制终端设备的关键字参数。对于每个关键字，该表列出了OPEN和USE相应的字母代码协议。有关使用这些协议的其他信息可以在字母代码协议表中找到。

终端设备的 OPEN 和 USE 关键字参数

测试 OPEN 命令是否成功

要确定OPEN命令是否成功，您的代码应测试$TEST和/或$ZE 。仅当使用超时参数指定OPEN命令时才会设置$TEST 。一个仅当Ctrl-C中断OPEN命令时才会发生错误。因此，代码不得依赖于错误。

第三十九章 终端输入 输出 - terminator

terminator

第三个位置参数：最多八个字符的字符串，其中任何一个都将终止READ 。这些终止符是协议中内置终止符的补充。请参阅使用终止符结束 I/O 操作。

portstate

第 4 个位置参数：按位置顺序最多包含 8 个字节的字符串，用于控制 COM 端口状态。端口状态字节如下（字节从1开始按从左到右的顺序编号）：

以下示例显示 COM 端口状态字符串：

  OPEN "COM2":(:::" 0801x0")

字符串值为： 空白（不断开端口）； 0（不使用调制解调器控制）； 8（八个数据位）； 0（无奇偶校验）； 1（一个停止位）； X（使用Xon/Xoff流量控制）； 0（禁用 DTR）；默认值（禁用 $ZA 错误报告）。

Disconnect参数通过降低 DTR 信号两秒然后恢复来在调制解调器控制的端口上执行挂断。断开连接不会关闭端口；断开连接后，您可以再次拨出，而无需重新打开 COM 设备。

调制解调器控制参数决定 IRIS 如何响应 RLSD（接收线路信号检测器）引脚（也称为 DCD（数据载波检测））的状态。如果线路受调制解调器控制（调制解调器控制=1）IRIS 会监视 RLSD 的状态，并生成一个如果在载体不存在时发出READ命令，则会出现错误。当载波不存在时发出WRITE命令时，IIRIS 不会生成错误。这是因为在建立连接之前必须能够将拨号命令发送到调制解调器。 IRIS 调制解调器控制可以随时启用 (1) 或禁用 (0)。建议在向调制解调器发送命令时禁用调制解调器控制，然后在检测到运营商并建立连接后启用调制解调器控制。

DTR 设置参数用于控制从连接的调制解调器登录。如果 DTR 设置为 0（零），则 DTR 控制信号关闭，调制解调器无法与计算机通信。这可以防止发生拨入连接。如果 DTR 设置为 1（一），则 DTR 控制信号打开，调制解调器可以与计算机通信。可以发生拨入连接。如果将 DTR 配置为关闭 (0)，则必须使用OPEN命令或USE命令将其设置为打开 (1)，才能使用连接的调制解调器拨出。在大多数情况下，当使用零调制解调器电缆直接连接到终端设备或串行打印机时，DTR 设置并不重要。这是因为零调制解调器电缆应强制 DTR 控制引脚打开。

$ZA 错误报告参数允许将调制解调器控制引脚的状态报告给$ZA特殊变量。无论 COM 端口的调制解调器控制字节设置如何，都可以完成此检查。如果启用 $ZA 错误报告，则可以通过调用 Windows ClearCommError() 函数来清除 COM 端口错误。端口错误状态在$ZA位 16 到 22 中报告。有关$ZA位值的表，请参阅《 ObjectScript 参考》中的$ZA 。

baud

第 5 个位置参数：一个整数值，指定所需的 COM 端口波特率。支持以下波特率：110、300、600、1200、4800、9600、14400、19200、38400、56000、57600、115200、128000、256000。

第三十八章 终端输入 输出 - USER命令

USER命令

使指定终端成为当前设备。在编程器模式下，同一行代码上的所有后续 I/O 命令都引用该设备。在应用程序模式下，您在USE命令中命名的设备将一直保留为当前设备，直到下一个USE命令为止。

USE 语法

USE命令采用以下参数：

USE terminal:(margin:protocols:terminator):"mnespace"

终端参数可以是一个表达式，其值为终端设备的名称。零 (0) 是该进程的主要设备。 $IO是当前设备。终端的最大长度为 256 个字符。

参数由冒号 (:) 分隔。如果省略参数，则必须指定冒号。命令或其参数列表不得以冒号结束。

可选参数列表包含在括号中，可以包含margin 、 protocols和terminator参数。可以将可选的margin 、 ports和terminator参数指定为位置参数（按所示顺序），或使用语法 /KEYWORD=value 指定为关键字参数。关键字参数可以按任意顺序指定；由于 IRIS 按从左到右的顺序执行参数，因此在某些情况下，参数之间的交互可能决定首选顺序。可以在同一参数列表中混合位置参数和关键字参数。如果指定多个参数，则需要使用括号。

要使用USE命令指定 COM 端口状态和波特率，请使用适当的关键字参数。

在参数列表（或占位符冒号，如果未指定参数列表）后面，可以指定一个可选的mnespace参数，该参数标识一个 ObjectScript 例程，其中定义了与WRITE /mnemonic一起使用的控制助记符。

OPEN 和 USE 命令的位置参数

以下位置参数可用于OPEN和USE命令。\可以在OPEN或USE命令中为设备设置这些参数，或者采用管理门户中配置的默认值。这些参数是位置参数；如果省略参数，则必须包含其前面的冒号作为占位符。

margin

第一个位置参数：一个整数值，指定右边距（以及每行的字符数）。 1 到 255 之间的值设置输出的右边距；任何其他值都会禁用右边距。空字符串使边距设置保持不变。在Windows平台上，不能使用“:n”来控制使用的打印边距。 IRIS 会忽略此类符号。代码如“|PRN| :121” 被忽略。要控制打印机宽度，请发送适合该打印机的控制字符。该符号在其他平台上也适用。

各种终端类型的默认边距在管理门户中定义。选择系统管理、配置、设备设置、设备子类型。当您单击每个列出的设备子类型的“编辑”时，它会显示“右边距：默认”选项。

protocols

第二个位置参数：用引号括起来的一串字母代码字符（例如“BNFU”），其中每个字母启用终端的通信规则之一。字母代码不区分大小写。字母代码可以在任何顺序；由于 IRIS 按从左到右的顺序执行它们，因此字母代码之间的交互在某些情况下可能会指定首选顺序。有关字母代码表，请参阅字母代码协议。

前面的加号或减号会影响协议，如下所示：

• 前面没有加号或减号：新字符串替换先前的协议字符串。
• 加号 (+) 位于字母代码字符串之前：新字符串中的协议将添加到先前的协议字符串中。
• 字母代码字符串前加减号 (-)：新字符串中的协议被关闭，但其他协议仍然有效。

用于打开和关闭协议的 + 和 – 选项在 DSM-11 兼容模式下不可用。

第三十七章 终端输入 输出 - $ZB 显示结束读取的内容

$ZB 显示结束读取的内容

$ZB显示当前设备上最后一次READ操作结束的字符序列或事件。不能设置$ZB ；每次执行READ时，IRIS 都会设置$ZB的值。可以使用此值来作用于不可打印的字符，例如向上箭头键或功能键。

$ZB可以包含以下任意内容：

• 终止符，例如回车符
• 转义序列
• 固定长度READ x#y的字符数y
• READ *x的单个字符
• 定时读取过期后出现空字符串

$ZB永远不会包含超过 64 个字符。较长的转义序列无效。

$ZB 示例

以下示例将用户指定的输入字符分配给READ命令变量x ，并将输入终止符（通常是 Return 字符）分配给$ZB特殊变量。从终端提示符发出此命令时，您需要设置一个变量以在与READ命令相同的命令行上捕获$ZB的值。这是因为用于发出命令行的行返回被写入$ZB作为终止符。此示例使用ZZDUMP显示$ZB捕获的字符的值。

USER>READ x SET y=$ZB
USER>ZZDUMP y

0000: 0D 
USER>

OPEN and USE 命令

OPEN 命令

建立终端的所有权。可选参数列表可以设置右边距、指定设备协议以及指定一个或多个终止字符。在参数列表之后，可以选择指定超时参数和/或mnespace参数。 mnespace参数指定 IRIS 例程，其中定义了与WRITE/mnemonic一起使用的控制助记符。

OPEN会暂停该过程，直到系统完成打开设备。如果按Ctrl-C中断OPEN命令，则会出现错误结果。

除非指定超时，否则OPEN会保留控制权，直至设备打开完成。超时后，如果 IRIS 无法在指定的秒数内打开设备，则会将$TEST设置为 0 并将控制权返回给进程。即使设备在操作系统级别不可用， OPEN也会继续尝试获取该设备，直到成功或超时到期。

OPEN 语法

OPEN命令采用以下参数：

OPEN terminal:(margin:protocols:terminator:portstate:baud):timeout:"mnespace"

仅需要终端参数。终端参数可以是一个表达式，其值为终端设备的名称。零 (0) 是该进程的主要设备。 $IO是当前设备。终端的最大长度为 256 个字符。

参数由冒号 (:) 分隔。如果省略列表中的参数，则必须指定冒号作为占位符。但是，不允许使用尾随冒号；不得以冒号结束命令或其参数列表。

可选参数列表包含在括号中，可以包含以下可选参数：

• margin是一个整数，通过指定右边距来指定每行的字符数。
• 协议是指定终端选项的一个或多个字母代码。
• 终止符是终止READ操作的一个或多个字符的字符串。这些字符补充了为特定协议定义的终止字符。
• portstate是指定 COM 端口状态的字符串。
• baud是一个整数，指定 COM 端口的波特率。

可以将这些可选参数指定为位置参数（按所示顺序），或使用语法 /KEYWORD=value 指定为关键字参数。关键字参数可以按任意顺序指定；由于 IRIS 按从左到右的顺序执行参数，因此在某些情况下，参数之间的交互可能决定首选顺序。您可以在同一参数列表中混合位置参数和关键字参数。如果指定多个参数，则需要使用括号。

以下参数列表是等效的：

   OPEN $IO:(80:"BFU":$CHAR(13)) 
    ; all positional
   OPEN $IO:(80::$CHAR(13):/PARAMS="BFU") 
    ; mixed positional and keyword, using the /PARAMS keyword
    ; to specify a protocol letter code string.
   OPEN $IO:(/MARGIN=80:/TERMINATOR=$CHAR(13):/BREAK:/FLUSH:/UPCASE)
    ; all keyword, using separate keywords 
    ; for each protocol letter code.

在参数列表（或占位符冒号，如果未指定参数列表）后面，可以指定一个可选的超时（以秒为单位），以及一个mnespace参数来指定包含该设备的控制助记符的例程。

第三十六章 终端输入 输出 - 开关控制 $X 的转义序列更新

开关控制 $X 的转义序列更新

要选择非默认行为来更新进程的$X ，请发出%SYSTEM.Process类的 DX( n ) 方法。

系统管理员可以通过类中设置 Config.Miscellaneous 的DX属性来更改系统范围的默认行为。

在这两种情况下， n 的值都在 0 到 4 之间，如下所示：

$TEST 显示定时操作结果

$TEST特殊变量由采用超时值的命令设置。这些命令包括OPEN和READ 。 $TEST的值可以设置为 1 或 0：

• 如果定时命令在超时到期之前成功，则$TEST设置为 1。
• 如果定时命令超时， $TEST将设置为 0。

注：没有超时的OPEN和READ命令对$TEST没有影响。

$ZA 显示读取状态

$ZA特殊变量包含许多位标志，显示当前设备上最后一次READ的状态。不能设置$ZA ； IRIS 控制其价值。 $ZA在下一次READ之前保持有效。 $ZA包含表中列出的值的总和，这显示了程序如何测试此变量。 （ $ZA还包含调制解调器连接状态的位标志，此处未列出。）

$ZA 读取状态值

虽然$ZA显示的许多条件都是错误，但它们不会通过捕获$ZTRAP特殊变量来中断程序流程。与这些错误有关的程序必须在每次READ之后检查$ZA 。当然，启用中断的Ctrl-C将捕获到$ZTRAP 。

第三十五章 终端输入 输出 - 特殊变量显示 I O 条件

WRITE * and $X and $Y

WRITE *不会更改$X和$Y 。因此，可以将控制序列发送到终端， $X和$Y仍将反映真实的光标位置。某些控制序列确实会移动光标，因此可以在需要时直接设置$X或$Y 。

$X 和 $Y 示例

在以下示例中，控制序列将 VT100 终端中的光标移动到第 10 行、第 20 列，并相应地设置$X和$Y 。

 ; set DY and DX to desired 
 ; values for $Y and $X 
 SET DY=10
 SET DX=20
 ; ...
 ; escape sequence moves
 ; cursor to desired position
 WRITE *27, *91, DY+1, *59, DX+1, *72
 ; ...
 ; updates $X and $Y
 SET $Y=DY
 SET $X=DX

转义序列对 $X 和 $Y的影响各不相同

转义序列可以改变$X和$Y值上的回显效果。三个因素控制着这种影响：

• 操作系统，设置默认行为。
• 是否在OPEN或USE命令中指定了 /NOXY（禁用$X和$Y处理）。
• 可以使用%SYSTEM.Process类的 DX() 方法来设置$X如何处理当前进程的转义序列。可以通过类中设置 Config.Miscellaneous的 DX 属性来建立系统范围的默认行为。

转义序列影响 Windows 和 UNIX® 系统上的 $X 和 $Y

默认情况下，在 UNIX® 和 Windows 上，当写入或回显任何包含 ASCII 转义字符（十进制值 27）的字符串时， IRIS 会更新$X和$Y，就像更新任何其他字符序列一样。因此，终端执行但不显示的 ANSI 标准控制序列可能会打乱$X和$Y与光标位置的关系。

避免此问题的最简单方法是使用DX()方法来更改行为（请参阅下一节）。或者，可以在WRITE *语句中使用字符串中每个字符的 ASCII 值。

控制序列示例

而不是使用代码：

%SYS>WRITE $CHAR(27)_"[lm"

可以使用以下不更新$X和$Y 的等效语句：

%SYS>WRITE *27,*91,*49,*109

第三十四章 终端输入 输出

概述

ObjectScript 提供支持串行异步 ASCII 终端的命令。还可以将这些命令与控制台 I/O 结合使用。

使用终端 I/O，例程可以：

• 启用或禁用传入字符的回显。
• 发送和接收 ANSI 标准转义序列。
• 控制键盘中断并编程特殊的用户交互，包括格式化屏幕、反向视频和用于跳过字段的特殊键。
• 启用和禁用Ctrl-C中断的识别。
• 通过 XON ( Ctrl-Q ) 和 XOFF ( Ctrl-S ) 控制传入和传出数据流。
• 指定 COM 端口状态参数和调制解调器波特率。
• 当指定自己的终止字符集时，请遵循外部协议。
• 与非终端设备通信，例如自动化仪器。

在大多数平台上，打印机被视为终端 I/O 设备。 UNIX® 系统始终将打印机作为终端 I/O 设备来处理。在 Windows 上，通过串行通信端口连接的打印机被视为终端 I/O 设备。否则，Windows 系统将打印机作为顺序文件 I/O 设备处理。

登录终端或控制台是主要设备

登录 IRIS 的终端或控制台是主要设备。无需打开主要设备。如果尚未发出OPEN和USE ，则进程第一次发出READ或WRITE时，系统会自动打开主设备，并将其设置为当前设备，就像您已显式发出OPEN 0 USE 0一样。

在本页的其余部分中， “终端”一词用于指代终端和控制台。

特殊变量显示 I/O 条件

I/O 命令可以影响特殊变量的值。您可以测试这些变量以确定 I/O 条件：

• $IO包含当前设备的名称。
• $TEST包含一个布尔值，显示最近的定时操作是否成功。
• $X和$Y显示光标的位置。
• $ZA 、 $ZB和$KEY显示有关READ操作的信息。 $ZB和$KEY相似，但不相同。

$X 和 $Y 以及光标位置

$X包含光标或打印头的水平位置， $Y包含垂直位置。 $X=0,$Y=0表示CRT 屏幕或打印页的左上角。 IRIS 计算$X和$Y模 256；也就是说，它们的范围是从 0 到 255，然后又从 0 开始。

回显角色的效果

OPEN和USE的S协议关闭回显。该协议还禁止在输入期间更改$X和$Y ，以便它们真正指示光标的位置。

第三十三章 UDP 客户端 服务器通信 - IPv4 和 IPv6

UDP 支持 IPv4 和 IPv6 互联网协议。由于这些协议不兼容，服务器和客户端都必须使用相同的Internet协议，否则传输将失败。

IPv4 地址具有以下格式。 n是 0 到 255 范围内的十进制整数：

n.n.n.n

可以将 IPv4 协议指定为"0.0.0.0" 。

IPv6 地址具有以下完整格式。 h是一个具有四个十六进制数字的十六进制数：

h:h:h:h:h:h:h:h

通常，IPv6 地址的缩写方式是消除前导零并用双冒号 (::) 替换连续的零部分； IPv6 地址中只能使用一个双冒号。通过使用 IPv4 缩写规则，可以将 IPv6 协议指定为“::” （意味着所有 8 个h部分的值为 0000）。

建立互联网协议：

• 客户端必须在 %New() 方法中建立 IPv4 或 IPv6。默认为 IPv4。
• 这必须与GetHostAddr()方法中指定并在Send()方法中提供（以二进制形式）的 IPv4 或 IPv6 协议匹配。

以下是 IPv4 传输：

Server
 SET sobj=##class(%Net.UDP).%New(3001,"127.0.0.1")



  SET inmsg=sobj.Recv() 

Client
 SET cobj=##class(%Net.UDP).%New()   /* the default is IPv4 */
 SET bhost=##class(%Net.UDP).GetHostAddr("127.0.0.1")
 SET outmsg="this is the message to send"
 WRITE cobj.Send(outmsg,bhost,3001) 

以下是 IPv6 传输：

Server
 SET x=##class(%SYSTEM.INetInfo).IsIPV6Enabled()
 IF x=1 {
    SET sobj=##class(%Net.UDP).%New(3001,"::1")



  SET inmsg=sobj.Recv() }
  ELSE {WRITE "IPv6 not enabled" } 

Client
 SET cobj=##class(%Net.UDP).%New(0,"::")
 SET bhost=##class(%Net.UDP).GetHostAddr("::1")
 SET outmsg="this is the message to send"
 WRITE cobj.Send(outmsg,bhost,3001) 

处理主机地址的方法可在%SYSTEM.INetInfo类文档中找到。

第三十二章 UDP 客户端 服务器通信

本页介绍如何使用 UDP 在进程之间建立远程通信。

介绍

通过%Net.UDP来支持 UDP。此类提供以下方法： Send()数据包到指定的目的地和端口、 Recv()来自套接字的数据包以及Reply()发送器最后收到的数据包。

目标被标识为本地主机名或者 IPv4 或 IPv6 主机地址。该端口可以是指定的端口号或动态端口分配。

建立UDP套接字

要使用 UDP，必须使用%New()方法来创建 UDP 套接字对象。然后，该对象实例用于发送、接收和回复数据包传输。

创建 UDP 套接字对象时，可以指定端口号和主机地址，如下例所示：

  SET UPDOref=##class(%Net.UDP).%New(3001,"0.0.0.0")

端口号和主机地址都是可选的。 %New()方法返回 UDP 套接字对象实例的 OREF（对象引用）。

• 服务器等待接收请求，然后提供所请求的信息。因此，传输的这一方可以称为接收方或提供方。当提供者创建 UDP 对象时，它必须定义接收请求的端口号。
• 客户端发送信息请求，然后接收回复。因此，传输的这一方可以称为发送方或请求方。当请求者创建 UDP 对象时，它可以使用动态端口号。默认值为0。当它发送数据包时，必须指定提供者的主机名和端口号。

主机地址

Send()方法指定目标的二进制地址。这是主机地址的二进制版本。必须使用GetHostAddr()方法创建此二进制主机地址，如下所示：

  SET client=##class(%Net.UDP).%New()
  SET addrbin=##class(%Net.UDP).GetHostAddr("172.16.61.196")
  WRITE client.Send("message text",addrbin,3001)

以向GetHostAddr()指定主机名、IPv4 地址或 IPv6 地址，如以下示例所示：

  SET hostname="MYLAPTOP"
  SET IPv4="172.16.61.196"
  SET IPv6="::1"
  SET flag=$SYSTEM.INetInfo.CheckAddressExist(hostname)
  IF flag=1 { SET addrbin=##class(%Net.UDP).GetHostAddr(hostname)
              WRITE "host name valid",! }
     ELSE { WRITE "not a hostname: ",hostname,! }
  SET flag=$SYSTEM.INetInfo.CheckAddressExist(IPv4)
  IF flag=1 { SET addrbin=##class(%Net.UDP).GetHostAddr(IPv4)
              WRITE "IPv4 valid",! }
     ELSE { WRITE "not an IPv4 address: ",IPv4,! }
  SET flag=$SYSTEM.INetInfo.CheckAddressExist(IPv6)
  IF flag=1 { SET addrbin=##class(%Net.UDP).GetHostAddr(IPv6)
              WRITE "IPv6 valid",! }
     ELSE { WRITE "not an IPv6 address: ",IPv6,! }

可以使用AddrToHostName()方法将此二进制主机地址扩展回主机名，如以下示例所示：

  SET addrbin=##class(%Net.UDP).GetHostAddr("MYLAPTOP")
  WRITE $SYSTEM.INetInfo.AddrToHostName(addrbin)

可以使用LocalHostName()法来确定主机名。可以使用HostNameToAddr()方法将主机名转换为 IPv4 或 IPv6 地址，如以下示例所示：

  SET localhost=$SYSTEM.INetInfo.LocalHostName()            /* get host name */
     WRITE "local host name is ",localhost,!
  SET addrbin=##class(%Net.UDP).GetHostAddr(localhost)      /* compress to binary address */
     WRITE "binary form of IP address is ",addrbin,!
  SET hostname=$SYSTEM.INetInfo.AddrToHostName(addrbin)     /* expand binary address to host name */
     WRITE "binary IP address expands to ",hostname,!
  SET ipaddr=$SYSTEM.INetInfo.HostNameToAddr(hostname)      /* host name to IP address */
     WRITE "hostname corresponds to IP address ",ipaddr,!

第三十一章 TCP 高级主题

本页讨论使用 TCP/IP 在 IRIS 数据平台进程之间进行通信的几个高级主题。

连接管理

服务器一次仅维护一个连接。如果在另一个连接打开时第二个客户端尝试连接，TCP/IP 会将该客户端放入队列中。在队列中时，第二个客户端可以向端口写入数据，就像已连接一样。第二个客户端写入的数据保留在缓冲区中，直到第一个连接关闭并且第二个客户端连接为止。

如果第二个客户端在连接存在之前发出READ，则会挂起。当第二个客户端在队列中时，第三个客户端的任何连接尝试都会失败。

如果已经打开 TCP 设备的客户端在第一个连接仍然存在时尝试第二次连接，则第二个OPEN命令会导致错误。将这种情况视为错误而不是USE命令可以防止出现意外的结果。如果错误的程序认为它已打开新连接，而实际上它正在重用可能具有不同目标或不同参数的现有连接，则可能会出现此类意外结果。

TCP 设备的作业命令

可以使用JOB命令来实现TCP并发服务器。 TCP 并发服务器允许同时为多个客户端提供服务。在这种模式下，客户端不必等待服务器完成为其他客户端提供服务。相反，每次客户端请求服务器时，它都会为该客户端生成一个单独的子作业，只要客户端需要它，该子作业就会保持打开状态。一旦生成该子作业（由JOB命令的返回指示），另一个客户端就可以请求服务，并且服务器也将为该客户端创建一个子作业。

非并发和并发模式下的客户端/服务器连接。

并发服务器使用JOB命令并设置了切换并发服务器位（位 4 或位 16）。位 16 是推荐设置。

• 如果设置了位 4，则JOB命令将主要输入和主要输出进程参数中的 TCP 设备传递给衍生进程。每当在switch中包含位 4 时，必须在主要输入和主要输出过程参数中指定 TCP 设备。主输入和主输出必须使用相同的设备。不建议使用位 4；有关详细信息，请参阅《ObjectScript 参考》中的JOB命令。
• 如果设置了位 16，则JOB命令将 TCP 设备、主要输入和主要输出进程参数的三个独立设备传递给生成的进程。可以使用主体输入和主体输出进程参数在JOB命令中指定其中两个 TCP 设备。还可以默认这些参数，如以下示例所示： JOBchild:(:16:input:output)或JOB child:(:16::)) 。

在发出JOB命令之前，为主要输入和主要输出指定的设备必须：

• 保持开放
• 监听 TCP 端口
• 已接受传入连接

在执行JOB命令之后，生成过程中的设备仍在侦听 TCP 端口，但不再具有活动连接。应用程序应在发出JOB命令后检查$ZA ，以确保 TCP 设备状态中的 CONNECTED 位已重置。

生成的进程使用指定的 TCP 设备在指定的入口点启动。TCP 设备在子进程中与在父进程中具有相同的名称。 TCP 设备有一个连接的套接字。继承的TCP设备处于S（流）模式。但是，子进程可以使用USE命令更改模式。我们建议服务器以A（接受）模式打开TCP 设备。

• 当switch =4 时，如果主设备上发生错误，作业只是停止，而不采取错误陷阱。这是因为当switch =4 时，TCP 设备是主要设备。要支持错误捕获，请使用switch =16 并为 TCP 设备指定另一个设备。
• 当switch =4 时，如果远程 TCP 设备关闭连接，作业就会停止，而不会出现错误陷阱。要覆盖此默认行为并生成错误，必须设置%SYSTEM.Process类的 DisconnectErr() 方法。

可以使用%SYSTEM.Socket类方法（而不是JOB命令）来创建并发 TCP 服务器连接。但是，请注意， %SYSTEM.Socket方法假定辅助作业已启动。如果不需要侦听器作业来启动辅助作业，并且侦听器作业知道辅助作业的进程 ID (PID)，则可以使用这些方法进行并发 TCP 服务器连接。

在某些情况下，TCP 将单独的记录连接起来形成单个记录。如果客户端或服务器进程向 TCP 端口发出一系列由 WRITE 分隔的WRITE命令，则可能会发生串联！或WRITE #命令来刷新缓冲区，无论连接的另一端是否正在等待READ命令。

下面的第一个示例概述了进程 A 在进程 B 将两条记录写入 TCP 端口时等待READ命令时如何接收两条单独的记录。

Process A                            Process B
%SYS> USE "|TCP|41880" R A U 0 W A   %SYS> USE "|TCP|41880" WRITE "ONE",!,"TWO"
<RETURN>                             <RETURN>
ONE
%SYS> USE 41880 R A U 0 W A 
<RETURN>
TWO

第二个示例概述了进程 A 在进程 B 完成向 TCP 端口写入两条记录后发出READ命令时如何接收一条串联记录。

Process A                           Process B
.                                   %SYS> USE "|TCP|41880" WRITE "ONE",!,"TWO"
.                                   <RETURN>
ONE
%SYS> USE "/TCP/41880" R A U 0 W A 
<RETURN>
ONETWO

多路复用 IRIS TCP 设备

%SYSTEM.Socket在提供了多路复用 IRIS TCP 设备的方法。 Fork()和Select()方法允许使用单个作业同时处理接受新连接和从连接的 TCP 设备读取数据。监听的 TCP 设备收到连接后，使用Fork()创建新的 TCP 设备用于读取数据。原始侦听 TCP 设备继续接受传入连接。可以使用Select()方法来等待侦听和连接的 TCP 设备。当新连接到达或数据可用时， Select()返回收到信号的设备名称。

可以使用Select()、 Publish()、 Export()和Import()方法来让侦听器作业接受传入连接并将连接的设备传递给工作人员作业。该工作人员作业可以与远程客户端进行通信。

第三十章 TCP 客户端 服务器通信 - 作业服务器资源

作业服务器资源

如果正在编写一个IRIS服务器来与无法控制的客户端连接，则服务器进程必须发出CLOSE命令来关闭TCP连接。就 IRIS而言，CLOSE命令确实会关闭连接，但是在内部TCP/IP会在服务器上为这个连接保留最长两分钟的资源。

当jobserver用于为TCP/IP作业提供服务时，可能会产生意想不到的结果。当一个JOBSERVER进程执行暂停时，该进程立即返回到可用的JOBSERVER进程池，但其资源在内部保留最多两分钟。由于JOBSERVER进程是在第一个可用的基础上分配的，因此来自数量相对较少的客户机的重载可能会耗尽JOBSERVER进程的资源。

为了避免这个问题，在JOBSERVER下运行的JOB打开的TCP/IP服务器应该显式地发出一个CLOSE命令，然后在最后的QUIT或HALT)命令之前发出一个简短的HANG命令。根据TCP/IP规范，需要一个HANG120来保证在JOBSERVER的转世之间没有资源仍在使用。在实践中，一秒的HANG通常足以在JOBSERVER进程之间均匀地分配资源负载。

自动切断

TCP绑定连接在以下条件下自动关闭:

• IRIS致命错误

• 客户端或服务器进程的RESJOB

• iris stop

• iris force

断开连接的影响

断开连接对保留在输出缓冲区中的数据的影响由OPEN或USE期间建立的/CLOSEFLUSH设置决定。默认是刷新数据。

如果一方关闭连接，但另一方发出新的WRITE命令，则第一个WRITE命令可能成功。任何附加的WRITE命令都会收到<WRITE>错误。

从客户端，所有发送到关闭连接端的READ命令都收到<READ>错误。必须关闭设备并重新打开，以重新与服务器建立通信。

在服务器端，<READ>或<WRITE>错误后的第一个READ等待并接受一个新的连接。

可以使用%SYSTEM.TCPDevice.GetDisconnectCode()在方法中以返回导致当前TCP设备上<READ>或<WRITE>错误的内部错误。$IO必须是TCP设备。

相关类

%SYSTEM.INetInfo%SYSTEM.TCPDevice%SYSTEM.Socket%IO.Socket

第二十九章 TCP 客户端 服务器通信 - 记录的拼接

记录的拼接

在某些情况下，TCP会将不同的记录连接在一起形成单个记录。如果客户端或服务器进程向一个由WRITE分隔的TCP端口发出一系列WRITE命令，则可能会发生串接！或用于刷新缓冲区的WRITE#命令，而不管读命令是否在连接的另一端等待。

Process A                            Process B
%SYS> USE "|TCP|41880" R A U 0 W A   %SYS> USE "|TCP|41880" WRITE "ONE",!,"TWO"
<RETURN>                             <RETURN>
ONE
%SYS> USE 41880 R A U 0 W A 
<RETURN>
TWO

第二个例子概述了在进程B完成将两条记录写入到TCP端口之后，当它发出读命令时，进程A如何接收一条串联的记录。

Process A                           Process B
.                                   %SYS> USE "|TCP|41880" WRITE "ONE",!,"TWO"
.                                   <RETURN>
ONE
%SYS> USE "/TCP/41880" R A U 0 W A 
<RETURN>
ONETWO

多路复用 TCP设备

类中的%SYSTEM.Socket提供了多路传输 TCP设备的方法。Fork()和Select()方法允许让单个作业同时处理接受新连接和从连接的TCP设备读取数据。侦听的TCP设备收到连接后，在中使用Fork()打开以创建用于读取数据的新的TCP设备。原始侦听的TCP设备继续接受传入的连接。可以使用在的Select()来等待侦听和连接的TCP设备。当新连接到达或数据可用时，Select()将返回发出信号的设备名称。

可以使用Select()、Publish()、Export()和Import()方法，使侦听器作业接受传入连接并将连接的设备传递给工作作业。此工作作业可以与远程客户端通信。

正在关闭连接

客户端或服务器端都可以结束TCP绑定连接。关闭连接的首选方法是客户端向TCP设备发出close命令。(或者，客户端可以发出HALT命令。)然后服务器应该向该设备发出另一个READ命令，并接收到<READ>错误，然后为TCP设备发出一个CLOSE命令。

这种顺序的原因是，根据TCP/IP标准，连接资源在CLOSE后保持两分钟，但仅用于“主动关闭器”——首先执行CLOSE的进程。因此，最好先关闭客户机，因为服务器的资源通常比客户机的资源更有限。

使用CLOSE命令断开连接

从客户端或服务器发出这样的CLOSE命令:

CLOSE "|TCP|devicenum"

如上所述，客户端最好先发出CLOSE命令。如果服务器首先发出CLOSE命令，客户端将收到<WRITE>错误，然后应该发出CLOSE命令。

第二十八章 TCP 客户端 服务器通信 - JOB命令示例

JOB命令示例

以下示例显示了一个非常简单的并发服务器，只要它检测到来自客户端的连接，就会产生一个子作业。 JOB指定一个并发服务器位开关值（值16）并通过符号表（值1）：16+1=17。

server
  SET io="|TCP|1" 
  SET ^serverport=7001 
  OPEN io:(:^serverport:"MA"):200 
  IF ('$TEST) { 
       WRITE !,"Cannot open server port" 
       QUIT }
  ELSE { WRITE !,"Server port opened" }
loop
     USE io READ x ; Read for accept 
     USE 0 WRITE !,"Accepted connection" 
     JOB child:(:17:io:io) ;Concurrent server bit is on 
     GOTO loop
child
  WRITE $JOB,! ; Send job id on TCP device to be read by client 
  QUIT
client
  SET io="|TCP|2" 
  SET host="127.0.0.1" 
  OPEN io:(host:^serverport:"M"):200 ;Connect to server
   IF ('$TEST) { 
       WRITE !,"cannot open connection" Quit }
   ELSE { 
       WRITE !,"Client connection opened" 
       USE io READ x#3:200 ;Reads from subjob 
       }
   IF ('$TEST) { 
       WRITE !,"No message from child" 
       CLOSE io 
       QUIT }
   ELSE {
       USE 0 WRITE !,"Child is on job ",x 
       CLOSE io 
       QUIT }

子进程使用继承的TCP连接将其作业ID(在本例中假设为3个字符)传递回客户机，之后子进程退出。客户端打开与服务器的连接，并在打开的连接上读取子任务的作业ID。在本例中，变量主机的IPv4格式值“127.0.0.1”表示到本地主机的环回连接。如果host设置为服务器的IP地址或名称，则可以在与服务器不同的机器上设置客户端。

原则上，子服务器和客户端可以进行扩展通信，多个客户端可以同时与服务器的各自子服务器进行通信。

请注意，这个简单的示例不包含用于检测和处理断开或读取操作失败的逻辑。

第二十七章 TCP 客户端 服务器通信 - 连接管理

连接管理

服务器一次只维护一个连接。如果第二个客户端在另一个连接打开时尝试连接，则 TCP/IP 将该客户端放入队列中。在队列中时，第二个客户端可以像已连接一样写入端口。第二个客户端写入的数据保留在缓冲区中，直到第一个连接关闭并且第二个客户端连接。

如果第二个客户端在连接存在之前发出 READ，它就会挂起。当第二个客户端在队列中时，第三个客户端的任何连接尝试都会失败。

如果已经打开 TCP 设备的客户端在第一个连接仍然存在时尝试第二次连接，则第二个 OPEN 命令会导致<COMMAND> 错误。将这种情况视为错误而不是 USE 命令可以防止出现意外结果。如果一个错误的程序认为它打开了一个新连接，而实际上它正在重用一个可能具有不同目标或不同参数的现有连接，则可能会出现这种意想不到的结果。

TCP 设备的作业命令

可以使用 JOB 命令来实现 TCP 并发服务器。 TCP 并发服务器允许同时为多个客户端提供服务。在这种模式下，客户端不必等待服务器完成对其他客户端的服务。相反，每次客户端请求服务器时，它都会为该客户端生成一个单独的子作业，只要客户端需要它，该子作业就会保持打开状态。一旦生成此子作业（由 JOB 命令的返回指示），另一个客户端可能会请求服务，服务器也会为该客户端创建一个子作业。

非并发和并发模式下的客户端/服务器连接。

并发服务器使用设置了切换并发服务器位（第 4 位或第 16 位）的 JOB 命令。位 16 是推荐设置。

如果设置了第 4 位，则 JOB 命令将主要输入和主要输出进程参数中的 TCP 设备传递给派生进程。无论何时在开关中包含位 4，都必须在主要输入和主要输出过程参数中指定 TCP 设备。必须对主要输入和主要输出使用相同的设备。不推荐使用位 4。

如果设置了第 16 位，则 JOB 命令将 TCP 设备的三个独立设备、主要输入和主要输出过程参数传递给派生进程。使用主要输入和主要输出过程参数在 JOB 命令中指定其中两个 TCP 设备。还可以默认这些参数，如以下示例所示：JOB child:(:16:input:output) 或 JOB child:(:16::))。

在发出 JOB 命令之前，为主要输入和主要输出指定的设备必须：

• 保持开放
• 监听 TCP 端口
• 已接受传入连接

在 JOB 命令之后，生成过程中的设备仍在TCP 端口上侦听，但不再有活动连接。应用程序应在发出 JOB 命令后检查 $ZA 以确保 TCP 设备状态中的 CONNECTED 位已重置。

派生的进程使用指定的 TCP 设备在指定的入口点开始。 TCP 设备在子进程中的名称与在父进程中的名称相同。 TCP 设备有一个连接的套接字。继承的 TCP 设备处于 S（流）模式。但是，子进程可以使用 USE 命令更改模式。我们建议服务器以 A（接受）模式打开 TCP 设备。

派生进程中的 TCP 设备处于连接状态：与设备从客户端打开后接收到的状态相同。生成的进程可以使用带有 USE 0 或 USE $P 的 TCP 设备。它还可以隐式使用 TCP 设备（如果 switch=4）。但是，出于以下原因，switch=16 优于 switch=4：

• 当 switch=4 时，如果在主设备上发生 <READ> 错误，则作业会简单地停止，而不会出现错误陷阱。这是因为当 switch=4 时，TCP 设备是主要设备。要支持错误捕获，请使用 switch=16并为 TCP 设备指定另一个设备。
• 当 switch=4 时，如果远程 TCP 设备关闭连接，作业会简单地停止，而不会出现错误陷阱。要覆盖此默认行为并生成 <DSCON> 错误，必须在类中设置 %SYSTEM.Process的 DisconnectErr()方法。

可以在类方法中使用 %SYSTEM.Socket而不是 JOB 命令来创建并发 TCP 服务器连接。但是，请注意方法中的 %SYSTEM.Socket 假定工作作业已经启动。如果不需要侦听器作业来启动辅助作业，并且侦听器作业知道辅助作业的进程 ID (PID)，则可以将这些方法用于并发 `TCP 服务器连接。

第二十六章 TCP 客户端 服务器通信 - $ZB 和 READ 命令

$ZB 和 READ 命令

$ZB 保存终止读取的字符。该字符可以是以下之一：

• 终止字符，例如回车
• 固定长度 READ x#y 的第 y 个字符
• READ *X 的单个字符
• 定时读取过期后的空字符串
• 转义序列
• 请注意，如果一个字符串以 CR LF 结尾，则只有 CR 会放在 $ZB 中。

TCP 设备的 WRITE 命令

在使用 OPEN 和 USE 建立连接后，WRITE 命令将数据从客户端或服务器发送到 TCP 设备。

语法如下：

WRITE x
WRITE ! 
WRITE #

WRITE如何工作

WRITE x 在建立连接后将 x 从客户端或服务器发送到缓冲区。

WRITE ！和 WRITE # 不表示换行和换页。相反，它们告诉 IRIS 刷新缓冲区中保留的所有字符，并通过网络将它们发送到目标系统。

可以使用 %SYSTEM.INetInfo类的 TCPStats() 方法确定当前 TCP 连接执行的写入次数。

WRITE 修改 $X 和 $Y

IRIS 将缓冲区中的字符数存储在 $X 特殊变量中。

ASCII 字符 <return> 和<line feed> 不包括在此计数中，因为它们不被视为记录的一部分。用 WRITE 刷新缓冲区！将 $X 重置为 0，并将 $Y 的值增加 1。使用 WRITE # 刷新缓冲区将 ASCII 字符 <form feed> 作为单独的记录写入，并将 $Y 重置为 0。

WRITE命令错误

在以下任何情况下，都可能收到 <WRITE> 错误。

• 如果超过最大字符串大小（1024 个字符）而不刷新缓冲区。
• 如果在其中没有字符时刷新写入缓冲区（TCP/IP 忽略长度为 0 的记录）。
• 如果在服务器收到来自客户端的连接请求之前从服务器向客户端发送 WRITE 命令。 （ IRIS 在服务器上产生 <WRITE> 错误。）

WRITE控制命令

TCP 绑定设备支持一系列具有 WRITE *-n 语法的控制命令。

• WRITE *-2 - 在当前连接到客户端的服务器模式会话上，此命令会断开与会话的连接。要接受新会话，可以在设备上执行新的 READ 命令。
• WRITE *-3 - 将任何缓冲的输出发送出 TCP 连接；即，对输出缓冲区中的数据执行 TCP SEND 操作。如果数据是压缩（/GZIP）流数据，*-3 发送数据时不标记压缩端点。将 $X 重置为 0。将 $Y 加 1。如果没有缓冲输出，则此命令不执行任何操作。
• WRITE *-99 - 发送压缩 (/GZIP) 流数据。首先用压缩端点标记输出缓冲区中的数据，然后通过对输出缓冲区数据执行 TCP SEND 操作来发送此压缩流数据。

第二十五章 TCP 客户端 服务器通信 - TCP 设备的 READ 命令

TCP 设备的 READ 命令

从服务器或客户端发出 READ 命令以读取客户端或服务器设置的任何字符。

语法如下：

READ var:timeout 
READ *var:timeout
READ var#length:timeout

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

超时参数支持秒和秒的分数到 1/100 秒。例如，10、10.5、.5、.05。

对于 SSL 连接，如果连接建立后另一方从未发出读或写命令，则作业可以等待第一个读或第一个写命令。在这种情况下， IRIS 支持 READ 命令的读取超时和 WRITE 命令的写入超时（使用 /WRITETIMEOUT=n 选项）。如果没有指定读或写超时，则作业将等待，直到对方发出读或写命令。

可以使用 %SYSTEM.INetInfo类的 TCPStats() 方法确定当前 TCP 连接执行的读取次数。

READ 修改 $ZA 和 $ZB

应用程序可以通过测试 $ZA 和 $ZB 的值来了解连接和读取是如何成功的。

$ZA 和 READ 命令

$ZA 报告连接状态。当设置 0x1000 位 (4096) 时，此 TCP 设备在服务器模式下运行。当设置 0x2000 位 (8192) 时，设备当前处于与远程主机通信的连接状态。

下表显示了 $ZA 中的每一位代表什么。

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

当前 TCP 设备

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

  DO $SYSTEM.TCPDevice.Help()

可以通过在 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 设备的 USE 命令

从客户端或服务器发出的 USE 命令使可以准备使用之前打开的 TCP 连接发送或接收数据。它具有以下语法（必须指定冒号，如图所示）：

USE devicename:(::mode:terminators)

• devicename - |TCP| 形式的字符串后跟一些数字。设备名称的数字部分称为设备标识符。如果在 OPEN 参数中未指定端口号，则此设备标识符必须是唯一的五位 TCP 端口号。如果在 OPEN 参数中指定了端口号（这是首选做法），则该设备标识符可以是任何唯一的数字，只要单个作业使用的所有 TCP 设备名称都是不同的。
• mode - 可选——USE 支持与 OPEN 相同的模式参数。请参阅“TCP 设备的 OPEN 和 USE 命令关键字”。
• terminators - 可选 — 最多八个用户终止字符的列表，这些字符将终止 TCP 绑定设备上的读取。同时指定 T 模式和用户终止符是没有意义的，但如果这样做，T 模式将被忽略。

最简单的 USE 形式从 OPEN 命令中获取其模式和终止符参数，如以下示例所示：

   USE "|TCP|4"

可以在设备打开后替换、添加或删除模式参数和用户终止符。

要替换 OPEN 中指定的参数，请在 USE 中指定替换值。在以下示例中，USE 命令将 OPEN 模式替换为 PSTE 模式并关闭所有用户终止符：

   USE "|TCP|4":(::"PSTE")

增加或删除OPEN中指定的模式参数，用“+”号引入将要开启的模式参数，“-”号引入将要关闭的模式参数。如果不指定“+”或“-”，则新的模式参数集将替换现有模式参数。在以下示例中，USE 命令关闭 Q 模式（立即发送）并打开 W 模式（等待）。它使模式字符串的其余部分保持不变：

   USE "|TCP|4":(::"-Q+W")

在以下示例中，USE 命令保留模式字符串不变并指定一组新的用户终止符。

   USE "|TCP|4":(::"+":$CHAR(3,4))

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

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

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

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

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

客户端OPEN命令

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

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

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

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

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

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

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

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

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

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

以下命令将 x 设置为“hello”：

   OPEN "|TCP|4":("larry":"echo":"M")
   USE "|TCP|4"
   WRITE "hello",!
   READ x

以下open命开到 Internet 地址 128.41.0.73、端口号 22101 的连接，超时为 30 秒。

   OPEN "|TCP|22101":"128.41.0.73":30

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

立即发送模式（Q 模式）

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

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

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

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

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

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

流模式(S模式)

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

接收时，可以接收最大字符串长度的数据。所有读取都等待达到终止符或缓冲区变满的完全超时。当禁用此模式（默认）时，处于数据包模式。

继承 TCP 设备的 Jobbed 进程自动设置为 Stream 格式。可以使用 USE 命令重置格式。

缓冲区大小

TCP 设备的 ibufsiz 和 obufsiz 参数指定用于 TCP 输入和输出的内部 IRIS 缓冲区的大小。在所有支持的平台上，它们可以取 1KB 到 1MB 之间的值。然而，操作系统平台可能使用不同大小的输入和输出缓冲区。如果操作系统平台缓冲区小于 IRIS 缓冲区（例如，64KB 对 1MB），性能可能会受到影响：WRITE 操作可能需要多次访问操作系统才能发送整个 IRIS 缓冲区； READ 操作可能会返回受操作系统缓冲区大小限制的较小块。为获得最佳性能，用户应试验当前操作系统以确定 ibufsiz 和 obufsiz 的哪些值可产生最佳结果。

服务器端OPEN命令

处理服务器端 OPEN 时，它会建立一个 TCP 套接字并在套接字上侦听适当端口号上的传入连接请求。端口号要么在参数列表中明确指定，要么从设备名称的数字部分派生。在套接字设置为侦听后，OPEN 立即返回。

如果 OPEN 没有成功，则另一个进程可能已经在该端口号上侦听连接请求。

以下服务器端 OPEN 示例显示了一个设备规范，该规范允许读取和写入最大字符串大小的终止字符串，并使用最大长度读取和写入操作来整合 TCP 通道的使用。

   OPEN "|TCP|4":(:4200:"PSTE"::32767:32767)

此示例中的参数参数如下：因为这是服务器端 OPEN，所以省略了第一个参数（主机名）。第二个参数明确指定端口号 (4200)。第三个参数是模式代码字符。第四个参数（终止符）被省略。第五个参数是输入缓冲区大小。第六个参数是输出缓冲区大小。

在以下示例中，端口号未指定为参数；它源自设备名称的数字部分。此示例打开端口 4200，没有指定参数且超时为 10 秒：

   OPEN "|TCP|4200"::10

服务器端 OPEN 的默认输入缓冲区大小 (ibufsiz) 和输出缓冲区大小 (obufsiz) 参数值为 1,048,576 字节 (1 MB)。

服务器端 OPEN 支持可选的队列大小参数和可选的“G”模式参数。这些选项不可用于客户端 OPEN。

服务器端OPEN支持可选的/CLOSELISTEN关键字参数。此选项对于客户端OPEN不可用。

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

数据包模式

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

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

如果在没有要发送的字符的情况下发出WRITE*-1来启动一个TCP发送操作，则会收到一个<WRITE>错误。如果发出WRITE OF空字符串，则会收到<COMMAND>错误。

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

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

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

回车模式(C模式)

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

在输出时，WRITE ! 生成“CR LF”，而WRITE#生成“CR FF”。

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

监控断开模式(D模式)

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

当被激活时，IRIS大约每隔60秒轮询一次TCP连接。当检测到断开连接时，IRIS会发出一个<DISCONNECT>错误。在空闲作业中不会发生断开连接检测，例如被挂起命令挂起的作业或等待读取操作的作业。 IRIS在回滚操作期间挂起所有断开监视，以防止发出错误。回滚结束后， IRIS将恢复断开连接监视。此挂起既适用于激活了断开监控的当前TCP设备，也适用于连接到启用了断开监控的TCP设备的未启用断开监控的当前设备。

还可以使用 %SYSTEM.INetInfo 类的 Connected() 方法检查 TCP 断开连接。

转义序列处理模式（E模式）

当设置 E 模式时，输入流中的转义序列被解析并放入 $ZB 特殊变量中。转义序列不得超过 15 个字符，并且必须符合以下语法：

esc_seq::=type1 | type2

type1 ::= '['['0':'?']*['':'/']*{'@':DEL}   
type2 ::= [';'|'?'|'O']['':'/']*{'0':DEL}

这里使用的句法符号表示：

当 IRIS 发现 ESCAPE 时，它最多等待 1 秒，等待剩余的转义序列到达。如果转义序列与此语法不匹配，或者如果它超过 15 个字符，或者如果有效的转义序列未在 1 秒内到达， IRIS 将部分转义序列放入 $ZB 并设置“BADESC”位（ 256) 在 $ZA。

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

Supported 参数

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

hostname

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

parameters 参数中的参数如下：

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

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

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

  • A-接受模式。如果A处于打开状态，则在接受来自客户端作业的连接后，服务器上的初始读取将立即以零长度字符串终止。如果A为OFF，则读取将被阻止，直到超时或数据可用(以最先发生的为准)。
  • C-参见下面的回车模式。
  • D-参见下面的断开模式监控。
  • E-参见下面的转义序列处理模式。
  • G-使端口参数被解释为已打开的数据套接字的套接字描述符。
  • M-流模式下的标准IRIS设备。此模式是调用“PSTE”选项集的快捷方式。它产生了一种设备，其作用类似于标准的 IRIS设备，可用于在两个方向上传递任意行数据。可以打开流模式，以便可以发送或接收任意序列的字符串，而不会使缓冲区溢出。换行符被添加到输出，并从输入中删除。读命令会一直阻塞，直到出现以下情况之一：出现终止符、达到超时时间或已填满指定的读长度。
  • P - 使用记录终止字符填充输出。设置此模式后，WRITE !除了刷新写入缓冲区外，还发送 LF（换行）和 WRITE # 发送 FF（换页）。 WRITE *-3 命令可用于启动缓冲数据的发送，而无需将任何字符插入数据流。请注意 WRITE *-3 只是刷新写入缓冲区而不发送任何终止符，因此不会向接收程序发出数据已完成的信号。 WRITE *-3 更常用于 Wait (W) 模式，不需要终止符。
  • Q—请参阅下面的立即发送模式。
  • S—参见下面的流模式。
  • T—输入端的标准终止符。设置时，CR、LF 和 FF 控制字符用作读取终止符。
  • W—等待模式。在这种模式下，WRITE ！和 WRITE # 命令不会导致 TCP 设备刷新网络输出缓冲区。等待模式导致 TCP 设备等待，直到下一个 WRITE *-3 命令刷新缓冲区并传输数据。

• terminators - 可选-最多包含八个用户终止符的列表，这些字符将终止在TCP绑定设备上的读取。如果同时指定T模式和终止符，则会忽略T模式。

• ibufsiz - 可选-输入缓冲区大小。在内部，已从网络读取但尚未传送到 IRIS程序的字符缓冲在可保存ibufsiz字节的数据区中。

• obufsiz - 可选-输出缓冲区大小。在连续的“SEND”操作之间，TCP设备可以缓冲的最大数据量。发送操作意味着将缓存的数据发送到网络。WRITE！、WRITE#和WRITE*-3命令可以生成发送操作。

  指定S模式时，会自动生成发送操作，以便在输出缓冲区太满时发送输出缓冲区的内容。但是，在完成消息创建后，程序员仍必须使用其中一个发送操作来确保消息已发送。

  当未指定S模式时，如果写入操作将在缓冲区中放置足够的数据以超过输出缓冲区大小，则会发生<WRITE>错误。请注意，尝试写入本身比输出缓冲区大小更长的字符串总是失败。

• queuesize - 可选-一个整数，指定有多少客户端作业可以排队等待与服务器的连接。仅用于服务器端打开。默认值为5。最大值取决于TCP实施，但不能超过1000。

• keepalivetime - 可选-(仅限Windows、AIX和Linux)允许为此设备设置不同于系统默认的保活计时器。指定使TCP连接保持活动状态的整数秒。有效值介于30到432000之间。(432000秒等于5天。)。小于30的值默认为30。如果省略或设置为0，则使用系统范围的默认保活计时器。有关详细信息，请参见/KEEPALIVE关键字选项。

  当TCP设备打开时，保活计时器不一定开始计时。它通常在连接已建立时开始计时。也就是说，当初始读取连接已成功完成时。

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

使用OPEN命令

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

OPEN devicename:parameters:timeout:mnespace

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

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

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

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

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

如果省略开放参数，则可以通过指定冒号分隔符来指示其缺失。

尽管TIMEOUT参数是可选的，但强烈建议使用它，因为打开的成功或失败由$TEST特殊变量的值指示，并且只有在指定了TIMEOUT的情况下才会设置$TEST。如果在超时到期之前打开尝试成功，则$TEST设置为1；如果超时到期，则$TEST设置为0。

如果Windows系统上的tcp连接尝试失败，则tcp连接错误将被写入IRIS系统错误日志，例如，错误代码10061=WSAECONNREFUSED。

以下是客户端打开的示例，其中7000是端口号，"127.0.0.1"是parameters参数(主机名，指定为IPv4地址)：

  SET dev="|TCP|7000"
  OPEN dev:("127.0.0.1":7000)

hostname 参数

客户端OPEN需要HostName参数。客户端参数可以只是主机名，也可以是主机名后跟其他冒号分隔的参数。如果仅指定主机名参数，则可以省略参数圆括号。

服务器端参数省略了主机名。

主机名可以是IP主机的名称(来自本地系统的远程主机数据库)，也可以是IPv4或IPv6协议格式的IP地址。由于这些协议不兼容，服务器和客户端必须使用相同的Internet协议，否则传输将失败。

IPv4地址具有以下格式。N是介于0到255之间的十进制整数：

n.n.n.n

IPv6地址的完整格式如下。H是具有四个十六进制数字的十六进制数：

h:h:h:h:h:h:h:h

通常，IPv6地址的缩写方式是消除前导零并用双冒号(::)替换连续的零部分；IPv6地址中只能使用一个双冒号。通过使用IPv4缩写规则，可以将IPv6环回地址指定为"::1"(这意味着前七个连续的h部分都具有值0000，并且第八个部分中的前导零被删除)。

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

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

TCP 客户端/服务器通信

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

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

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

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

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

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

TCP 连接概述

要在系统之间创建客户端-服务器关系，必须遵循一组特定的约定：

• 系统必须与适当的网络硬件和软件连接，包括 TCP/IP 协议软件。
• 系统通过 TCP 端口相互通信。连接两端的进程必须使用相同的端口号。
• 指定 TCP 端口号或代表它的设备的设备名称，作为 IRISOPEN、USE 和 CLOSE 命令中的设备。

使用这些约定，建立 TCP 绑定连接的一般过程是：

1. 服务器进程向 TCP 设备发出 OPEN 命令。
2. 服务器进程发出一个 USE 命令，然后是一个 READ 命令，等待来自客户端进程的输入。在客户端可以建立连接之前，服务器必须处于监听状态。当客户端打开连接并发送一些数据时，初始 READ 命令完成。可以在 OPEN 命令中包含“A”模式参数，以便在服务器接受连接后立即完成初始读取。
3. 客户端进程发出一个 OPEN 命令，指定它要连接的 TCP 设备。
4. 客户端进程发出一个USE命令，然后是一个WRITE命令来完成连接。 IRIS将WRITE命令中的所有字符复制到缓冲区。它不会将它们写入网络，直到发出write !或WRITE #命令刷新缓冲区。
5. 服务器读取客户端在其第一个 WRITE 命令中发送的字符后，双方可以继续发出 READ 和 WRITE 命令。这些命令对同一端口的顺序没有进一步限制。
6. 任何一方都可以使用 CLOSE 或 HALT 命令启动连接的关闭。最好先关闭客户端。如果服务器需要断开连接以便它可以接受来自另一个客户端进程的连接，可以改为发出 WRITE *-2 命令。

注意：此过程假定客户端和服务器都是 IRIS 进程（尽管任一进程都可以是非 IRIS 进程）。

以下部分详细介绍了如何使用 IRIS I/O 命令在客户端和服务器进程之间创建 TCP 绑定。

TCP 设备的 OPEN 命令

服务器和客户端进程都使用 ObjectScript OPEN 命令来启动连接。服务器通过发出 READ 命令完成连接，该命令接收客户端 OPEN 命令和第一个数据传输。

注意：如果在已经打开的 TCP 设备上发出 OPEN 命令，则第二个 OPEN 命令将被视为 USE 命令。即，忽略主机名和端口参数（保留第一个 OPEN 命令值）并更新模式和终止符参数。

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

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

介绍

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

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

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

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

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

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

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

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

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

指定作业间通信设备的内存缓冲区

系统管理员可以使用管理门户配置 IJC 缓冲区。选择“系统管理” 、 “配置” 、 “附加设置” 、 “高级内存” 。可以设置的两个参数是：

• ijcnum ：IJC 设备的最大数量。范围为 0 到 256。默认值为 16。如果编辑此设置，则必须重新启动 IRIS 才能应用更改。
• ijcbuff ：每个 IJC 缓冲区的最大大小（以字节为单位）。范围为 512 到 8192。默认大小为 512 字节。如果编辑此设置，则必须重新启动 IRIS 才能应用更改。

每个 IJC 设备对应一个 IJC 缓冲区，其大小在ijcbuff中指定。可以写入长度为ijcbuff减 1 的消息。

禁用作业间通信缓冲区

如果不使用 IJC 设备，则可以将 IJC 设备的最大数量 ( ijcnum ) 设置为 0 以避免占用内存。

作业间通信设备编号

作业间通信设备由 IRIS 自动定义编号。它们的实际标识号取决于系统上配置的 IJC 缓冲区的最大数量

下表给出了系统上可用的 IJC 设备编号范围，具体取决于分配的 IJC 缓冲区的数量。

例如，如果分配 8 个 IJC 缓冲区，则系统上将定义从 224 到 239 的设备号（偶数用于READ设备，奇数用于WRITE设备）。

再举一个例子，如果分配 94 个 IJC 缓冲区，则定义以下设备编号范围：224 到 255、64 到 199、4 到 19 以及 2048 到 2051。可以将任何偶数/奇数对与OPEN一起使用，使用、读取、写入和关闭命令。

设备编号

IJC 设备的 I/O 命令

可以对 IJC 设备使用所有标准 I/O 命令： OPEN 、 USE 、 READ 、 WRITE和CLOSE 。

OPEN命令

OPEN命令保留作业间通信设备供使用。

OPEN device::timeout

device 设备

上表中的设备编号。打开偶数设备以发出READ命令。打开奇数设备以发出WRITE命令。为了两个进程进行通信，它们必须打开一组设备对。

timeout 暂停

可选— 一个正整数，其值（以秒为单位）是 IRIS 等待OPEN完成的最长时间。如果指定 0，则 OPEN立即将控制权返回给进程。

此示例显示两个进程如何通过打开单独的设备进行读取和写入来进行通信：

Process A                          Process B 
OPEN 227 USE 227 WRITE "MSG_1"
WRITE "MSG_2"                       OPEN 226 USE 226 READ X
CLOSE 227                           CLOSE 226
OPEN 224 USE 224 READ X             WRITE X
CLOSE 224                           MSG_1
WRITE X                             .
MSG_3                               .
                                    .
                                    OPEN 225 USE 225 WRITE "MSG_3" 
                                    CLOSE 225

过程A首先打开设备227并向其写入MSG_1。 IRIS 将此消息写入设备226 和227 共享的缓冲区中。然后进程A 将第二条消息写入同一缓冲区。现在，进程B打开伴随设备226并从缓冲器读取第一消息(MSG_1)。

现在，进程 A 想要读取消息，因此它必须打开另一个设备 224。由于该设备及其同伴设备 225 的缓冲区当前为空，因此进程 A 会等待，直到进程 B 打开设备 225 并将 MSG_3 写入其中。在IRIS将该消息放入由设备224和225共享的缓冲器中之后，对设备224的READ命令成功。

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

用于进程间通信的 CLOSE 命令

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

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

CLOSE cpipename:"I"

使用命名管道与 Visual Basic 进行通信

在 Windows 上，在 IRIS 中使用命名管道就像使用 TCP 设备一样，但使用设备名称|NPIPE|nnn而不是|TCP|nnn 。 OPEN参数如下：

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

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

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

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

服务器可以打开命名管道并在客户端打开同一命名管道之前立即发出写入。写操作将挂起，直到客户端打开命名管道。用户可以通过发出 Control-C 来中断挂起。

一旦打开，管道就像普通设备一样。在服务器端，客户端可以像 TCP 中一样通过以下方式断开连接：

   USE "|NPIPE|3":"DISCONNECT"

或者：

   USE "|NPIPE|3" WRITE *-2

OPEN 命令关键字

以下列表描述了仅使用OPEN命令控制命名管道的关键字。

/HOSTNAME=str

默认值：默认值为“” （空字符串），它将管道作为服务器打开。

对应于服务器位置参数，指定 Windows 计算机。当打开管道作为服务器时，不需要指定该关键字。使用”。” （带引号的句点）连接到本地管道名。

/IBUFSIZE=n

默认值：2048

指定命名管道输入缓冲区的大小，该缓冲区保存从管道接收但尚未传递到应用程序的数据。

/INSTANCES=n

默认值：1

指定命名管道允许的最大实例数。大于 1 的值允许多个服务器打开命名管道的实例，以便一次可以为多个客户端提供服务。

/OBUFSIZE=n

默认值：2048

指定操作系统使用的输出缓冲区的大小。此缓冲区大小是建议性的，因为操作系统根据系统施加的约束来调整缓冲区的大小。

/PIPENAME=str

无默认值。

对应于指定管道名称的pipelinename位置参数。

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

用于进程间通信的 READ 命令

语法

READ:pc readargument,...

READ 从管道读取数据。

其中reargument可以是：

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

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

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

CPIPE 退出代码

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

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

在 UNIX® 系统上，退出代码仅适用于非 shell 命令；即，使用 /COMMAND 或 /ARGS 打开的 CPIPE 设备。

用于进程间通信的 CLOSE 命令

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

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

CLOSE cpipename:"I"

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

OPEN 和 USE 命令关键字

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

/IOTABLE[=name]

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

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

/TRANSLATE[=n]

默认值：1

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

/XYTABLE[=name]

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

对应Y\name\参数代码，为设备建立$X/$Y动作表。

仅限 OPEN 关键字

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

/ENV=environmentvars

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

• 明确地说。例如：

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

• 通过多维数组。例如：

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

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

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

/IGNOREEOF[=n]

默认值：0

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

/PARAMS=str

无默认值。

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

/QUEUE

默认值：设备不被识别为进程间通信管道。

对应于Q参数代码，它指定应打开进程间通信管道。请注意，使用此命令需要%System_Callout资源的使用权限。

/Read

默认值：如果未指定 /Read 或 /Write，则默认为读取。

对应于R参数代码，它指定应打开队列或管道以接受来自另一个进程的数据。

/Write

默认值：如果未指定 /Read 或 /Write，则默认为读取。

对应于W参数代码，它指定应打开队列或管道以将数据发送到另一个进程。