x3270-script - 云端在线

程序：

您的姓名

x3270、c3270 和 s3270 的脚本工具

概要

x3270 -脚本 [ x3270-选项 ]
x3270 -插座 [ x3270-选项 ]
x3270 -脚本端口 端口 [ x3270-选项 ]
c3270 -插座 [ c3270-选项 ]
c3270 -脚本端口 端口 [ s3270-选项 ]
s3270 [ s3270-选项 ]
脚本 ( 命令 [ , 啊... ] )

商品描述

- x3270 脚本工具允许交互式 3270 模拟器 x3270 和 c3270 成为
在另一个程序的控制下运行，并形成纯脚本的基础
模拟器 s3270.

有四种基本的脚本编写方法。 第一个是 窥视 脚本 设施，由调用
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 x3270 -脚本 开关，以及默认模式 s3270. 这将模拟器作为
另一个进程的子进程。 通常这将是一个使用脚本 期望（1） perl的（1），或
Korn Shell 的协同处理设施 KSH(1). 在这种模式下，模拟器进程
在其标准输入上查找命令，并将响应放在标准输出上。

第二种方法是 孩子 脚本 由模拟器调用的设施 脚本 行动。
这将脚本作为模拟器的子进程运行。 孩子可以使用管道
连接到模拟器； 模拟器在一个管道上寻找命令，然后放置
另一方面的回应。 到模拟器的命令管道的文件描述符是
传入环境变量 X3270INPUT（例如，文本字符串“7”，如果文件
描述符为 7)； 来自模拟器的响应管道的文件描述符是
传入环境变量 X3270OUTPUT。

第三种方法使用 TCP 套接字。 这 -脚本端口 命令行选项导致
模拟器将套接字绑定到指定端口（在 IPv4 环回地址上，127.0.0.1）。
模拟器接受该端口上的 TCP 连接。 可以有多个命令和响应
通过每个连接发送。

第四种方法使用 Unix 域套接字。 这 -插座 命令行选项导致
模拟器创建一个名为的 Unix 域流套接字 /tmp/x3sck。PID. 模拟器接受
到该套接字的连接。 多个命令和响应可以通过每个发送
连接。

可以嵌套方法。 例如，对等或 TCP 套接字脚本可以调用
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 脚本 行动。 嵌套脚本完成后，将恢复调用脚本。

命令是模拟器 行动; 语法与右侧的语法相同
x3270 or c3270 键盘映射。 与转换表不同，动作名称不区分大小写，可以
唯一缩写，如果没有参数可以省略括号。
任何以开头的输入行 # or ! 被视为评论，将被忽略。

可以指定任何模拟器操作。 已经定义了几个特定的​​操作以供使用
通过脚本，以及某些其他操作（以及一般的模拟器）的行为是
当动作由脚本启动时不同。

一些动作产生输出； 有些可能会延迟完成，直到某些外部事件发生
发生，如主机解锁键盘。 每个命令的完成都被标记
通过两行消息。 第一行是模拟器的当前状态，记录在案
以下。 如果命令成功，第二行是字符串“ok”； 否则就是
字符串“错误”。

状态 FORMAT

状态消息由 12 个空格分隔的字段组成：

1 键盘状态
如果键盘未锁定，则字母 U. 如果键盘被锁定等待
来自主机的响应，或者如果未连接到主机，则该信件 L。 如果
由于操作员错误（字段溢出、受保护的字段、
等），信 E.

2 屏幕格式
如果屏幕被格式化，字母 F. 如果未格式化或处于 NVT 模式，则
邮件 U.

3 现场保护
如果包含光标的字段受保护，则字母 P. 如果不受保护或
未格式化的信 U.

4 连接状态
如果连接到主机，则字符串 C(主机). 否则，信 N.

5 模拟器模式
如果在 3270 模式下连接，字母 I. 如果连接在 NVT 线路模式下，字母
L. 如果以 NVT 字符模式连接，则字母 C. 如果未协商连接
模式（没有来自主机的 BIND 活动），字母 P. 如果没有连接，信 N.

6 型号 (2-5)

7 行数
屏幕上定义的当前行数。 主持人可以要求
模拟器使用 24x80 屏幕，所以这个数字可能小于最大数字
当前模型可能的行数。

8 列数
当前在屏幕上定义的列数，以相同的差异为准
对于行，上面。

9 光标行
当前游标行（零起点）。

10 光标列
当前游标列（零起点）。

11 窗口 ID
主窗口的 X 窗口标识符 x3270 窗口，以十六进制开头 0x.
对于 s3270 和 c3270，这是零。

12 命令执行时间
主机响应前一个命令所用的时间，以秒为单位
带小数点后的毫秒数。 如果前面的命令不需要
主机响应，这是一个破折号。

差异性

当一个动作由脚本启动时，模拟器会以几种不同的方式运行：

如果在处理动作时发生错误，通常的弹出窗口不会出现。
相反，文本被写入标准输出。

如果在标准输入上检测到文件结束，则模拟器退出。 （脚本可以退出
不通过使用杀死模拟器 关闭脚本 行动，下面。）请注意，这
仅适用于对等脚本； 简单地连接到子脚本的管道上的文件结尾
导致管道关闭和 脚本 动作来完成。

- 退出 action 总是导致模拟器退出。 （当从键盘调用时，它
仅在未连接到主机时才会退出。）

通常，AID 操作 (清除, 输入, PF及 PA) 直到主机才会完成
解锁键盘。 如果参数为 串 操作包括这些的代码
动作，它也会等待键盘解锁，然后再继续。

- 援助等待 用行为切换控件。 当这个切换被设置（默认）时，动作
块如上所述。 清除切换后，AID 操作会立即完成。
- 等待（输出） 然后可以使用 action 延迟脚本，直到主机更改
屏幕上的东西，以及 等待（解锁） 动作可用于延迟脚本直到
无论主机处于何种状态，主机都会解锁键盘 援助等待 切换。

请注意 脚本 直到在管道上检测到文件尾或
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 关闭脚本 action 由子进程调用。 此行为不受
的状态 援助等待 切换。

基础课程 编程 策略

3270 会话脚本可能比其他类型的脚本更困难，因为它可以
很难判断主机何时完成处理命令。 有一个明确的
3270 数据流工具，用于执行此操作：模拟器在发送时锁定键盘
主机一个AID，后面的主机解锁键盘。 模拟器支持这个
直接通过不允许 AID 操作完成，直到键盘被
解锁。 不幸的是，一些主机和一些主机应用程序将键盘解锁为
一旦他们开始处理命令，而不是在它完成之后。 一个人
当命令完成时（例如，当出现 READY 提示时，操作员可以在屏幕上看到
显示），但脚本可能很难做到这一点。 对于这种提前解锁的主机，
脚本中的唯一选项是轮询屏幕，直到它可以确定命令
做完了。

另一个复杂因素是主机 I/O 和脚本操作是异步的。 那就是
主机可以随时更新屏幕，甚至在读取屏幕的操作之间
内容，因此脚本可能会得到不一致的结果。 这个问题的帮助是
由...提供 捕捉 行动。 这 捕捉（保存） 操作将屏幕快照保存在
特殊缓冲区。 然后脚本可以使用 捕捉 的变体 ASCII 和 退潮 行动
(快照（ASCII） 和 快照（Ebcdic）) 查询保存的缓冲区——主机不能修改
-- 获取它想要的数据。 最后， 捕捉（等待 输出） 块 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 脚本 直到 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 主持人
修改 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 屏幕， 特别是 自 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 最后 呼叫 至 捕捉（保存）。 从而 a 脚本 能够
英寸 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 屏幕 有效 by 写作 a 循环 这 开始 - 捕捉（保存） 和 结束 -
捕捉（等待 输出）。

特定于脚本的 行动

已定义或修改了以下操作以与脚本一起使用。 （注意
与状态行上的显示不同， 行 和 山坳 这些动作中使用的坐标使用
[0,0] 作为它们的起源，而不是 [1,1]）。

文本
输出自上次以来主机在 NVT 模式下输出的任何数据
那个时候 文本 被称为。 数据以字符串“data:”开头，并且
已将所有控制字符扩展为 C 反斜杠序列。

这是一种以同步方式捕获 NVT 模式输出的便捷方法，无需
试图解码屏幕内容。

ASCII(行,山坳,行,列)

ASCII(行,山坳,长度)

ASCII(长度)

ASCII 输出屏幕内容的 ASCII 文本表示。 每一行都在前面
通过字符串“data:”，并且没有控制字符。

如果给定四个参数，则输出屏幕的矩形区域。

如果给出三个参数， 长度 输出字符，从
指定的行和列。

如果只有 长度 给定参数，即输出许多字符，从
光标位置。

如果没有给出参数，则输出整个屏幕。

EBCDIC 到 ASCII 的转换和输出字符集取决于
模拟器字符集（ -字符集 选项）和语言环境。 UTF-8 和某些
DBCS 语言环境可能会导致 EBCDIC 字符的多字节扩展
转换为大于 0x7f 的 ASCII 代码。

ASCII字段
输出包含光标的字段的 ASCII 文本表示。 文本
前面是字符串“data:”。

连接(主机)
连接到主机。 直到模拟器成功，命令才会返回
以正确的模式连接，否则连接失败。

关闭脚本(状态)
使模拟器停止从脚本读取命令。 这对
允许对等脚本退出，仿真器以交互方式进行。 （没有
这个命令，模拟器会在检测到标准文件结束时退出
输入。）如果脚本是由 脚本 行动，可选 状态 is
用作返回状态 脚本; 如果非零， 脚本 将完成一个
错误，如果此脚本作为登录的一部分通过 ibm_主机 文件，
连接将中断。

继续脚本(停止)
允许正在等待的脚本 暂停脚本 行动，下面，继续。 这
停止 给出的是输出 暂停脚本 行动。

Disconnect
与主机断开连接。

退潮(行,山坳,行,列)

退潮(行,山坳,长度)

退潮(长度)

退潮 相同的功能 ASCII 上面，除了不是生成 ASCII 文本，
每个字符都输出为十六进制 EBCDIC 代码，前面是 0x.

退潮场
相同的功能 ASCII字段 上面，除了它生成十六进制 EBCDIC
码。

资料包(消息)
在 x3270 中，弹出信息性消息。 在 c3270 和 wc3270 中，写了一个
给 OIA 的信息性消息（显示屏下方的行）。 未定义为
s3270 或 tcl3270。

期望(文本[,超时])
暂停脚本直到指定的 文本 出现在数据流中
主机，或指定的 超时 （以秒为单位）过期。 如果不 超时 被指定，
默认值为 30 秒。 文本 可以包含标准的 C 语言转义符（反斜杠）
序列。 不理解通配符或模式锚字符。
期望 仅在 NVT 模式下有效。

移动光标(行,山坳)
将光标移动到指定的坐标。

暂停脚本
停止脚本直到 继续脚本 上面的动作被执行。 这允许一个
脚本等待用户输入并继续。 将单个参数输出到
继续脚本.

打印文本([命令,]过滤))
通过命名的管道传输当前屏幕图像的 ASCII 表示 过滤,
例如， LPR.

打印文本([HTML,],文件,文件名))
将当前屏幕内容保存在文件中。 随着 HTML 选项，将其另存为
HTML，否则将其保存为纯 ASCII。

打印文本(html，字符串)
以 HTML 形式返回当前屏幕内容。

询问(关键词)
返回状态信息。 关键词是：

关键字输出
────────────────────────────────────────────────────── ─
BindPluName 主机返回的 BIND PLU
ConnectionState TN3270/TN3270E 模式和子模式
CodePage 主机代码页
Cursor 光标位置（row col）
格式化 3270 格式状态（格式化或
未格式化）
主机 主机名和端口
LocalEncoding 本地字符编码
LuName 主机名 LU 名称
型号 3270 型号名称 (IBM-327x-n)
ScreenCurSize 当前屏幕大小（行列数）
ScreenMaxSize 最大屏幕尺寸（行列数）
Ssl SSL 状态（安全或不安全）
和主机验证状态（主机-
验证或主机未验证）

没有 关键词, 询问 返回每个定义的属性，每行一个，
以其名称标记。

读取缓冲区(ASCII)
转储屏幕缓冲区的内容，一次一行。 数据内的位置
字段在当前显示中一般输出为2位十六进制代码
字符集。 如果当前语言环境指定 UTF-8（或某些 DBCS 字符
集），某些位置可能会输出为多字节字符串（4 位、6 位或 8 位
代码）。 DBCS 字符在屏幕缓冲区中占据两个位置； 首先
location 在当前语言环境代码集中作为多字节字符串输出，并且
第二个位置作为破折号输出。 字段开始字符（每个
占据一个显示位置）输出为 SF(aa=nn[,...])，其中 aa 是一个字段
属性类型和 nn 是它的价值。

属性值
────────────────────────────────────────
c0 基本 3270 20 受保护
10 数字
04 可检测
08 强化
0c 不显示
01 修改
41 高亮 f1 闪烁
f2 反转
f4 下划线
f8 加强
42前景f0中性黑
f1 蓝色
f2 红色
f3 粉红色
f4 绿色
f5 绿松石
f6 黄色
f7 中性白
f8黑色
f9 深蓝色
发橙

FB紫色
fc 淡绿色
fd 淡绿松石
铁灰色
白色
43 个字符集 f0 默认
f1 APL
f8 数据库控制系统

扩展属性（不占显示位置）输出为
SA(aa=nn), aa 和 nn 具有与上述相同的定义（虽然基本
3270 属性永远不会作为扩展属性出现）。

此外，屏幕缓冲区中的 NULL 字符报告为 ASCII 字符
00 而不是 20，即使它们应该显示为空白。

读取缓冲区(退潮)
相当于 读取缓冲区(ASCII)，但数据字段输出为十六进制
EBCDIC 代码代替。 此外，如果缓冲区位置具有图形转义
属性，显示为 通用电气(xx).

脚本(路径[,arg...])
运行子脚本，将可选的命令行参数传递给它。 径 必须指定
可执行（二进制）程序：模拟器将创建一个新进程并执行
它。 如果您只是想让模拟器从文件中读取命令，请使用 来源
行动。

捕捉 相当于 捕捉(已保存） （见下文）。

捕捉(ASCII，...）
执行 ASCII 保存的屏幕图像上的操作。

捕捉(科尔斯)
返回保存的屏幕图像中的列数。

捕捉(退潮，...）
执行 退潮 保存的屏幕图像上的操作。

捕捉(读取缓冲区)
执行 读取缓冲区 保存的屏幕图像上的操作。

捕捉（行）
返回保存的屏幕图像中的行数。

捕捉(已保存)
在临时缓冲区中保存屏幕图像和状态的副本。 这个副本可以
被其他人查询 捕捉 允许脚本检查一致屏幕的操作
图像，即使主机可能正在更改图像（甚至屏幕尺寸）
动态地。

捕捉(状态)
返回上次保存屏幕时的状态行。

捕捉(稍等[,超时],输出)
暂停脚本直到主机发送进一步的输出，然后更新快照缓冲区
使用新的屏幕内容。 当主机解锁键盘时使用（允许
脚本后继续 输入, PF or PA 行动），但尚未完成
更新画面。 此操作通常在循环中调用，该循环使用
捕捉(ASCII），或 捕捉(退潮) 用于扫描屏幕以查找某些模式的操作
表示主机已完全处理完最后一条命令。

可选的 超时 参数指定失败前等待的秒数
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 捕捉 行动。 默认是无限期等待。

来源(文件)
读取和执行命令 文件. 这些命令的任何输出都将变为
输出来自 来源. 如果任何命令失败， 来源 命令将 而不去
中止； 它将继续读取命令，直到 EOF。

称谓(文本)
将 x3270 窗口标题更改为 文本.

转让(关键词=折扣值，...）
调用 IND$FILE 文件传输。 请参阅下面的文件传输。

稍等([超时,] 3270模式)
与在 NVT 模式和 3270 模式之间切换的主机通信时使用。
暂停脚本或宏直到主机协商 3270 模式，然后等待
格式化屏幕如上。

可选的 超时 参数指定失败前等待的秒数
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 稍等 行动。 默认是无限期等待。

为了向后兼容， 稍等(3270) 相当于 稍等(3270模式)

稍等([超时,] Disconnect)
暂停脚本，直到主机断开连接。 通常用于在发送一个 注销
命令到 VM/CMS 主机，以确保会话不会无意中设置为
断开的 州。

可选的 超时 参数指定失败前等待的秒数
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 稍等 行动。 默认是无限期等待。

稍等([超时,] 输入框)
一个有用的实用程序，用于在脚本开头和之后使用 连接 行动。
3270模式下，等待屏幕格式化，主机定位
光标位于可修改的字段上。 在 NVT 模式下，等待直到主机发送至少一个
字节数据。

可选的 超时 参数指定失败前等待的秒数
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 稍等 行动。 默认是无限期等待。

为了向后兼容， 稍等 相当于 稍等(输入框).

稍等([超时,] NVT模式)
与在 3270 模式和 NVT 模式之间切换的主机通信时使用。
暂停脚本或宏，直到主机协商 NVT 模式，然后等待
来自主机的字节如上所述。

可选的 超时 参数指定失败前等待的秒数
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 稍等 行动。 默认是无限期等待。

为了向后兼容， 稍等(安西) 等价于 稍等(NVT模式).

稍等([超时,] 输出)
暂停脚本，直到主机发送进一步的输出。 主机时经常需要
解锁键盘（允许脚本在一个 清除, 输入, PF or PA
action），但尚未完成更新屏幕。 也用于非阻塞AID
模式（有关详细信息，请参阅差异）。 此操作通常在循环中调用
使用 ASCII or 退潮 用于扫描屏幕以查找指示某种模式的操作
主机已完全处理完最后一条命令。

可选的 超时 参数指定失败前等待的秒数
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 稍等 行动。 默认是无限期等待。

稍等([超时,] 开锁)
暂停脚本，直到主机解锁键盘。 这在以下情况下很有用
在非阻塞 AID 模式下运行（切换 援助等待 清除), 等待主机
命令来完成。 有关详细信息，请参阅差异）。

可选的 超时 参数指定失败前等待的秒数
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 稍等 行动。 默认是无限期等待。

稍等(超时, 秒)
延迟脚本 超时 秒。 不同于其他形式的 稍等，超时时间是
不是可选的。

的WindowState(模式)
If 模式 is 标志性的, 将 x3270 窗口更改为图标。 如果 模式 is 正常,
将 x3270 窗口从图标更改为普通窗口。

文件 TRANSFER

- 转让 行动工具 IND$文件 文件传输。 这一行动要求
IND$文件 程序安装在 IBM 主机上，并且 3270 光标位于
将接受 TSO 或 VM/CMS 命令的字段。

由于文件传输的复杂性和选项数量，
转让 行动采取独特的形式 选项=折扣值, 并且可以以任何顺序出现。 笔记
如果 折扣值 包含空格（例如 VM/CMS 文件名），然后是整个参数
必须引用，例如，“HostFile=xxx foo a”。 选项是：

选项 需要？ 默认其他值
────────────────────────────────────────────────────── ──────────
方向 无接收发送
主机文件 是
本地文件 是
主机 没有 tso vm, cics
模式 无 ASCII 二进制
Cr 不删除添加，保留
重新映射 否 是 否
存在 否 保持 替换、追加
Recfm 没有固定的，可变的，
未定义
编号
大号 否
分配 无轨道、圆柱体、
视频块
主空间号
次要空间号
缓冲区大小 4096

选项详情如下。

方向性
提交 向主机发送文件， 接收 从主机接收文件。

主机文件
主机上的文件名。

本地文件
本地工作站上的文件名。

主办方 主机的类型（这决定了 IND$文件 命令）： TSO （
默认）， vm or 西斯.

时尚 使用 VHDL 语言编写 ASCII （默认）用于文本文件，将在 EBCDIC 之间进行翻译
和 ASCII 视需要。 用 二进制 对于非文本文件。

Cr 控制方式 新队 传输时处理字符 模式=ascii 文件。
去掉 （默认）条 新队 传输前本地文件中的字符
他们给主人。 加 增加 新队 每个主机文件记录之前的字符
将其传输到本地工作站。 保持 蜜饯 新队 字符当
将本地文件传输到主机。

重新映射 控制文本翻译 模式=ascii 文件。 价值 含 （默认）原因
x3270 重新映射文​​本以确保工作站之间的最大兼容性
字符集和编码以及主机的 EBCDIC 代码页。 价值 没有 原因
x3270 将文本按原样传入或传出主机，将所有翻译留给主机
IND$文件 主机上的程序。

存在 控制当目标文件已经存在时会发生什么。 保持 （默认）
保留文件，导致 转让 行动失败。 更换 覆盖
目标文件与源文件。 附加 将源文件附加到
目标文件。

推荐 控制在主机上创建的文件的记录格式。 （仅限 TSO 和 VM 主机。）
固定 创建具有固定长度记录的文件。 变量 创建一个文件
变长记录。 未定义 创建一个包含未定义长度记录的文件
（仅限 TSO 主机）。 这 莱克尔 选项控制记录长度或最大记录
的长度 推荐=固定 和 Recfm=变量 文件，分别。

莱克尔 指定在计算机上创建的文件的记录长度（或最大记录长度）
主持人。 （仅限 TSO 和 VM 主机。）

大号
指定在主机上创建的文件的块大小。 （仅限 TSO 和 VM 主机。）

分配
指定单位 主空间 和 次要空间 opţiuni: 轨道,
气缸 or 视频块. （仅限 TSO 主机。）

主空间
文件的主要分配，单位由 分配 选项。 (TSO
仅限主机。）

次要空间
文件的二级分配。 单位由 分配 选项。
（仅限 TSO 主机。）

缓冲区大小
DFT 模式传输的缓冲区大小。 范围从 256 到 32768。更大的值
提供更好的性能，但某些主机可能无法支持它们。

使用 onworks.net 服务在线使用 x3270-script