会话选项
以下几个表显示了会话选项。缺省值是 underlined。
- 下表中的值确定如何为以下功能定义数据字符串长度：发送键 (3)、搜索表示空间 (6)、将字符串复制到表示空间 (15)、搜索字段 (30)、将字符串复制到字段 (33)、发送文件 (90) 和 接收文件 (91)。
价值 说明 STRLEN 为所有字符串传递显式长度。 STREOT 长度未显式编码。调用（源）数据字符串以 EOT 字符结束。 - 下表中的语句用于指定在以下 EHLLAPI 功能的调用（源）数据字符串中用作文本结束 (EOT) 定界符的字符：发送键 (3)、搜索表示空间 (6)、将字符串复制到表示空间 (15)、搜索字段 (30)、将字符串复制到字段 (33)、发送文件 (90) 和 接收文件 (91)。
价值 说明 EOT=c 允许您指定字符串终止符的 EOT 字符（在 STREOT 方式下）。二进制零是缺省值。请勿在等号后面留空。 要有效，
c必须以 1 字节字符串文字字符的形式输入，并且前面没有空格。仅当 STREOT 选项（见项 1）生效时，此语句指定的 EOT 字符才会用于确定调用数据字符串的长度。 - 下表中的值影响搜索表示空间 (6) 和搜索字段 (30) 搜索功能。
价值 说明 SRCHALL 搜索表示空间 (6) 功能和搜索字段 (30) 功能会扫描整个主机表示空间或字段。 SRCHFROM 搜索表示空间 (6) 功能和搜索字段 (30) 功能会从指定的 PS 位置开始（适用于 SRCHFRWD），或在指定的 PS 位置结束（适用于SRCHBKWD）。 - 下表中的值影响搜索表示空间 (6) 和搜索字段 (30) 搜索功能。它们确定了搜索的方向。
价值 说明 SRCHFRWD 搜索表示空间 (6) 功能和搜索字段 (30) 功能按升序方向执行。 SRCHBKWD 搜索表示空间 (6) 功能和搜索字段 (30) 功能以降序方向执行。如果所请求字符串的第一个字符在为搜索指定的范围内开始，则满足搜索要求。 - 下表中的值确定功能复制表示空间 (5)、将表示空间复制到字符串 (8) 和将字段复制到字符串 (34) 的属性字节处理方式。
价值 说明 NOATTRB 将所有未知值转换为空白。 ATTRB 作为原始值传递回所有不具有 ASCII 等效值的代码。 NULLATTRB 将所有字段属性转换为 null 字符。 - 下表中的值影响暂停 (18) 功能。
价值 说明 FPAUSE 无论您在暂停 (18) 功能中指定的时间长短，全时暂停都将持续。 IPAUSE 可中断暂停。执行启动主机通知 (23) 功能后，主机事件满足暂停要求。 - 下表中的值确定是否显示由文件传输功能发送文件 (90) 和接收文件 (91) 生成的消息。
价值 说明 NOQUIET 将显示 SEND 和 RECEIVE 消息。 QUIET 不显示 SEND 和 RECEIVE 消息。 - 下表中的语句确定在执行文件传输功能发送文件 (90) 和接收文件 (91) 期间，Z and I Emulator for Windows EHLLAPI 将等待自动发出“取消”的时长。要有效，
c必须是大写字母 J–N，并且前面不能有空格。价值 说明 TIMEOUT=0 在（大约）20 秒延迟后自动发出“取消”。 TIMEOUT=c 在指定的延迟之后自动发出“取消”。下表中的 1 字符指示符指示 Z and I Emulator for Windows 在发出“取消”本身之前应接受的 30 秒周期数。 - 字符
- 值（以分钟为单位）
- 1
- 0.5
- 2
- 1.0
- 5
- 1.5
- 6
- 2.0
- 7
- 2.5
- 8
- 3.0
- 9
- 3.5
- 10
- 4.0
- 9
- 4.5
- J
- 5.0
- K
- 5.5
- L
- 6.0
- 周一
- 6.5
- 否
- 7.0
- 下表中的语句用于定义击键助记符的转义字符。此会话选项影响功能发送键 (3) 和获取键 (51) 功能。
c的值必须以 1 字节文字字符串的形式输入，并且前面没有空格。价值 说明 ESC=c 指定击键助记符的转义字符（@ 为缺省值）。请勿在等号后面留空。空白不是有效的转义字符。 - 下表中的值确定 EHLLAPI 是否自动在使用 发送键 (3) 功能发送的字符串前面添加 reset。
价值 说明 AUTORESET EHLLAPI 会尝试重置所有禁用条件，方法是在使用发送键 (3) 功能发送的所有键字符串前面添加 reset 作为前缀。 NORESET 请勿执行 AUTORESET。 - 下表中的值会影响连接表示空间 (1) 命令的运行方式。
价值 说明 CONLOG 在工作站会话和主机会话之间建立逻辑连接。在连接期间，不要跳至请求的表示空间。 CONPHYS 在工作站会话和主机会话之间建立物理连接。在连接期间，跳至请求的表示空间。 - 下表中的值影响等待 (4) 功能和获取键 (51) 功能。对于每个值，都有两种不同的效果，每个功能一个。
价值 说明 TWAIT 对于等待 (4) 功能，在 XCLOCK (X []) 或 XSYSTEM 超时之前最长等待一分钟。 对于获取键 (51) 功能，在 EHLLAPI 应用程序拦截某个键（基于开始击键拦截 (50) 功能下指定的选项的常规或 AID 键）后，请勿将控制权返回给该应用程序。
LWAIT 对于等待 (4) 功能，等至 XCLOCK (X [])/XSYSTEM 清除。不建议使用此选项，因为在主机可用之前，控制权不会返回到应用程序。 对于获取键 (51) 功能，在 EHLLAPI 应用程序拦截某个键（基于开始击键拦截 (50) 功能下指定的选项的常规或 AID 键）后，请勿将控制权返回给该应用程序。
NWAIT 对于等待 (4) 功能，检查状态并立即返回（无需等待）。 对于获取键 (51) 功能，如果没有任何与开始击键拦截 (50) 功能下指定的选项匹配的项在排队，则在第四个参数中返回返回码 25（击键不可用）。
注： 建议使用 NWAIT。 - 下表中的值影响复制表示空间 (5)、将表示空间复制到字符串 (8)、将字符串复制到表示空间 (15)、将字符串复制到字段 (33) 和将字段复制到字符串 (34)。扩展属性字节 (EAB) 包括扩展字符属性和扩展字段属性。
价值 说明 NOEAB 仅传递数据，无 EAB。 EAB 使用扩展属性字节传递表示空间数据。对于屏幕上显示的每个字符，将传递 2 个字节的数据。因此，必须预先分配一个缓冲区，该缓冲区的大小是表示空间大小的两倍；例如，对于 24 行 x 80 列表示空间，为 2 x 1920 = 3840。 字符串的扩展属性可以报告为字段字节的属性，而不是字段中每个单独字符的属性。在这种情况下，要判断屏幕上的特定字符或字符集是否为下划线，请执行 CopyPStoString，指定字段属性字节（屏幕上显示的字段前面的字节）的位置，以获取适用于该字段中所有字符的 EAB 信息。
注： 当使用 EHLLAPI 将 PS 复制到字符串时，将复制文本，并且该文本应对运算符不可见。使用 EHLLAPI 设置会话参数功能设置 NODISPLAY 选项，以确定是否存在隐藏的数据。这会导致 EHLLAPI 将不显示字段作为 null 返回。隐藏数据的另一个常见过程是将前景色和背景色设置为相同（例如黑色），以便显示文本，但对运算符不可见。应用程序检测此问题的唯一方法是使用 EAB 和 XLATE 会话参数，然后复制 PS。返回每个位置的前景色/背景色，并且可以确定哪些字符不可见。 - 下表中的值影响复制表示空间 (5)、将表示空间复制到字符串 (8)、将字符串复制到表示空间 (15)、将字符串复制到字段 (33) 和将字段复制到字符串 (34)。
价值 说明 NOXLATE EAB 未转换。 XLATE EAB 已转换为 PC 彩色图形适配器 (CGA) 格式。 - 下表中的值会影响复制表示空间 (5)、将表示空间复制到字符串 (8) 和将表示空间复制到剪贴板 (35)（如果指定了 NOATTRB 和 NOEAB）。
价值 说明 BLANK 将所有未知值转换为 X'20'。 NOBLANK 将所有未知值转换为 X'00'。 缺省值为 BLANK。如果要将缺省值更改为 NOBLANK，请在位于 Z and I Emulator for Windows 用户类应用程序数据目录的 PCSWIN.INI 文件中添加以下语句：[API] NullToBlank=NO - 下表中的值会影响查询会话 (10) 返回的表示空间大小。
价值 说明 CFGSIZE 返回已连接表示空间的所配置大小。此选项将忽略主机对所配置大小的任何覆盖。 NOCFGSIZE 返回已连接表示空间的当前大小。 - 下表中的值影响复制表示空间 (5)、将表示空间复制到字符串 (8)、将字段复制到字符串 (34) 和将表示空间复制到剪贴板 (35)。
价值 说明 DISPLAY 将表示空间中的不显示字段复制到目标缓冲区，方法与显示字段相同。当前应用程序正常运行。 NODISPLAY 请勿将表示空间中的不显示字段复制到目标缓冲区。将不显示字段作为 null 字符串复制到目标缓冲区。这样，应用程序就可以在表示窗口中显示复制的缓冲区，而不显示机密信息（如密码）。 - 下表中的值影响将字符串复制到表示空间 (15)、将字符串复制到字段 (33) 和将剪贴板粘贴到表示空间 (36)。
价值 说明 NOPUTEAB EAB 不包含在将字符串复制到表示空间或将字符串复制到字段的数据字符串中。 PUTEAB EAB 与字符数据包含在将字符串复制到表示空间或将字符串复制到字段的数据字符串中。 此选项用于兼容 Communication Manager/2。对于 Communication Manager/2，EAB（或 EAD）在设置会话参数中有效时，在将字符串复制到表示空间或将字符串复制到字段中指定的数据字符串包含 EAB（或 EAD）以及字符数据。然而，对于之前的 Z and I Emulator for Windows，在这些功能中指定的数据字符串只能由字符数据组成，即使 EAB（或 EAD）有效也是如此。但是，Z and I Emulator for Windows 允许数据字符串包含 EAB（或 EAD），方法是设置 PUTEAB 来兼容 Communication Manager/2。
- 下表中的值影响发送键 (3) 功能。如果键盘被阻止或正在使用，则不会处理击键。这些选项确定该功能是在 4 分钟超时之前尝试重新发送键，还是功能在确定键盘被阻止或正在使用后立即返回。
价值 说明 RETRY 继续尝试发送击键，直到发送击键或发生 4 分钟超时为止。 NORETRY 确定键盘被阻止或正在使用后立即返回。 - 下表中的值影响复制表示空间 (5)、将表示空间复制到字符串 (8)、将字符串复制到表示空间 (15)、将字符串复制到字段 (33)、将字段复制到字符串 (34)、搜索字段 (30)、查询会话(10)、将表示空间复制到剪贴板 (35) 和 将剪贴板粘贴到表示空间 (36)。
价值 说明 EXTEND_PS 5250 仿真支持 24 行 x 80 列的表示空间。在某些情况下，Communication Manager 5250 仿真会显示第 25 行。当显示来自主机的错误消息或操作员选择 SysReq 键时，就会出现这种情况。Z and I Emulator for Windows 在第 24 行显示第 25 行信息，但是 EHLLAPI 通常会看到真正的第 24 行。通过 EXTEND_PS 选项，EHLLAPI 应用程序可以使用与 Communication Manager EHLLAPI 相同的接口，并且在满足此条件时将扩展有效的表示空间。 NOEXTEND_PS 出现上述情况时，不会扩展表示空间。这是缺省值。 - 下表中的值影响连接表示空间 (1) 和连接窗口服务 (101) 功能。这些选项指定一个应用程序是否可以或将共享与其使用另一个应用程序连接到的表示空间。每次调用设置会话参数时，都只能指定以下一个值。
价值 说明 SUPER_WRITE 此应用程序允许其他允许共享和具有写入访问权的应用程序并发连接到相同的表示空间。发起应用程序执行管理类型功能，但不会为共享表示空间的其他应用程序创建错误。 WRITE_SUPER 应用程序需要写入访问权，并且仅允许管理应用程序并发连接到其表示空间。这是缺省值。 WRITE_WRITE 应用程序需要写入访问权，并允许具有可预测行为的合作伙伴或其他应用程序共享表示空间。 WRITE_READ 应用程序需要写入访问权，并允许执行只读函数的其他应用程序共享表示空间。还允许应用程序复制表示空间，并照常执行其他只读操作。 WRITE_NONE 应用程序可独占使用表示空间。不允许其他应用程序共享表示空间，包括管理应用程序。允许应用程序复制表示空间并照常执行只读操作。 READ_WRITE 应用程序仅需要读取访问权即可监控表示空间，并允许执行读取或写入功能或者同时执行这两项功能的其他应用程序共享表示空间。还允许应用程序复制表示空间，并照常执行其他只读操作。 - 下表中的值允许具有表示空间共享需求的应用程序将共享限制为合作伙伴应用程序（为使用该应用程序而开发的应用程序）。
价值 说明 NOKEY 允许应用程序兼容未指定 KEY 参数的现有应用程序。 KEY$nnnnnnnn 使用关键字限制对其支持的表示空间的共享访问。关键字的长度只能为 8 个字节。