SEND CONTROL
将设备控件发送到终端,而不使用映射或文本数据。 将关键字分成最低、标准和完整 BMS 支持的关键字。
有关 BMS 的更多信息,请参阅 基本映射支持。
语法
条件: IGREQCD , IGREQID ,INV最不发达国家, INVPARTN , INVREQ , RETPAGE , TSIOERR 和 WRBRK
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
描述
SEND CONTROL 向终端发送设备控制。
在使用 SEND CONTROL 命令和任何 ALARM、FREEKB、FRSET、HONEOM、L40、L64、L80 或 PRINT 选项时,请参阅 DFHMDI 选项,CTRL 了解选项优先级的说明。
选项
- ACCUM
- 指定此命令是用于构建逻辑消息的若干命令之一。 逻辑消息由 SEND PAGE 命令完成,或由 PURGE MESSAGE 命令删除。
- ACTPARTN (名称)
- 指定要激活的分区的名称 (1-2 个字符)。 激活分区会将光标移动到指定分区中,并解锁指定分区的键盘。
如果目标终端不支持分区,或者没有应用程序分区集,那么将忽略此选项。
- ALARM
- 指定要激活 3270 可听警报功能。 对于支持 FMHs 的逻辑单元 (交互式和批处理逻辑单元除外) , ALARM 指示 BMS 在 FMH 中设置警报标志。
- 备用
- 设置终端以使用 ALTERNATE 屏幕大小。
- CURSOR (data-value)
- 指定当 SEND CONTROL 命令完成时,将 3270 或 3604 游标返回到的位置。
数据值必须是半字二进制值,用于指定相对于零的光标位置; 可指定的值范围取决于正在使用的屏幕的大小。
如果正在使用 ACCUM ,那么将使用指定的 CURSOR 的最新值来定位游标。
CURSOR 选项中指定的值必须为正数。 负值会导致不可预测的结果。
如果省略此选项,那么光标位于屏幕的零位置。
- 缺省值
- 设置终端以使用 DEFAULT 屏幕大小。
- ERASE
- 指定要擦除屏幕打印机缓冲区或分区,并将光标返回到屏幕左上角。 (此选项仅适用于 3270 或 8775 以及 3604 键盘显示。)
任何事务或一系列伪会话事务中的第一个输出操作应始终指定 ERASE。 对于连接到 3270 屏幕或打印机的事务,除非 DEFAULT 或 ALTERNATE 选项显式覆盖,否则这还可确保选择正确的屏幕大小,如 RDO PROFILE 定义中的 SCRNSIZE 选项为事务定义的那样。
- ERASEAUP
- 指定要擦除分区或整个屏幕中所有不受保护的字符位置。 (此选项仅适用于 3270 和 8775。)
- FORMFEED
- 指定需要新页面。 对于 3270 打印机和显示器, FORMFEED 字符位于缓冲区的开头。 因此,应用程序必须确保此缓冲区位置不会被映射或文本数据覆盖。 如果目标终端不支持 FORMFEED (即,未使用 RDO TYPETERM 选项 FORMFEED) ,那么将忽略此参数。
- 免费 KB
- 指定要解锁的 3270 键盘。 如果省略 FREEKB ,那么键盘保持锁定状态。
请注意,对于支持分区的终端上的每个分区,将单独维护键盘锁定状态。
- FRSET
- 指定将当前在 3270 (或分区) 缓冲区中的所有字段的已修改数据标记 (MDT) 重置为未修改的条件 (即,字段重置)。
这允许下一个请求映射的 DFHMDF 的 ATTRB 操作数控制为响应 BMS 命令而写入或重写的字段的最终状态 (如果未在符号映射中写入其他属性信息)。
- HONEOM
- 指定将使用缺省打印机行长度。 此长度应该与使用 RDO TYPETERM 选项 PAGESIZE 或 ALTPAGE 指定的长度相同。
- 最后一个
- 指定这是事务的最后一个输出操作,因此是支架的结尾。 此选项仅适用于逻辑单元。
- 最不发达国家 (name)
- 指定要用于确定要在 FMH 中传输到逻辑单元的逻辑设备代码 (最不发达) 的 2 字符助记符。 助记符标识由 DFHTCT TYPE=最不发达国家宏定义的最不发达国家条目。 当指定了最不发达国家时, BMS 使用设备类型,页面大小和与最不发达国家助记符关联的页面状态来格式化消息。 这些值取自 LU 的扩展本地最不发达国家表 (如果有)。 如果 LU 只有本地 (未扩展) 的最不发达国家表,那么将从系统最不发达国家表中获取值。 从本地的 "最不发达国家" 表中获取 "最不发达国家" 的数字值,除非这是一个未扩展的表,并且未指定该值,在这种情况下,将从系统表中获取该值。
- L40, L64或 L80
- 指定 3270 打印机的行长度; 在一行上打印了 40,64 或 80 个字符之后,将强制载波返回和换行。 如果这与 RDO TYPETERM 选项 PAGESIZE 或 ALTPAGE 指定的页面宽度不同,那么可能会产生不可接受的结果。
使用选项时,请参阅 DFHMDI options , CTRL 以获取选项优先级的描述。
- MSR (data-value)
- 指定控制连接到 8775 或 3643 终端的 10/63 磁条阅读器的 4 字节数据值。 DFHMSRCA 中提供了一组常量,以帮助设置此 4 字节区域。 有关完整列表,请参阅 磁性插槽读卡器 (MSR) 控制值常量。 如果未使用 RDO TYPETERM 选项 MSRCONTROL ,那么将忽略此选项。
- OUTPARTN (名称)
- 指定要向其发送数据的分区的名称 (1-2 个字符)。 如果终端不支持分区,或者没有与终端关联的应用程序分区集,那么将忽略此选项。 如果设置了应用程序分区,且省略了 OUTPARTN 选项,则数据将发送到 DFHMSD 或 DFHMDI 映射定义宏的 PARTN 操作数命名的分区。 如果未使用映射,或者没有 PARTN 操作数,那么会将输出发送到分区集中的第一个分区。
- 页面调度
- 指定输出数据不被立即发送到终端,而是被放置在临时存储器中,并响应终端操作员输入的寻呼命令而显示。
如果在指定 PAGING 时带有 REQID 前缀(用于定义为可恢复的临时存储队列),CICS® 会在任务到达同步点时为逻辑消息提供消息恢复功能。
- 指定要在 3270 打印机或具有打印机适配器功能的 3275 上启动打印操作,或者要在控制器分配的打印机上打印 LUTYPE2 (3274/76 或 3790) 上的数据。 如果省略此选项,那么会将数据发送至打印机缓冲区,但不会打印数据。
- REQID (名称)
- 指定要用作 CICS 消息恢复临时存储器标识的一部分的 2 字符前缀。 只能为每条逻辑消息指定一个前缀。 缺省前缀为 **。
仅当在 BMS SEND 命令中指定了调页选项并且已达到同步点时,才会为逻辑消息提供 BMS 消息恢复。
- SET (ptr-ref)
- 指定要设置为输出数据地址的指针。
SET 选项指定将已完成的页面返回到应用程序。 指针设置为已完成页面列表的地址。
如果在映射定义中指定了 TIOAPFX=YES ,那么返回的指针将包含 TIOA 前缀的地址。 用户数据从 TIOA 前缀开始的偏移 X'0C' 开始。
- TERMINAL
- 指定将输出数据发送到发起事务的终端。
- WAIT
- 指定在输出操作完成之前,不应将控制返回到应用程序。
如果未指定 WAIT ,那么当输出操作已启动时,控制权将返回到应用程序。 后续输入或输出命令 (终端控制, BMS 或批处理数据交换) 会导致应用程序等待先前命令完成。
条件
- 57 IGREQCD
- 在从 LUTYPE4 逻辑单元接收到具有请求更改方向 (RCD) 代码的 SIGNAL 数据流控制命令之后尝试执行 SEND CONTROL 命令时发生。
缺省操作: 异常终止任务。
- 39 IGREQID
- 如果 REQID 选项中指定的前缀与先前 REQID 选项所建立的前缀不同,或者缺省情况下此逻辑消息为 REQID (**)。
缺省操作: 异常终止任务。
- 41 名
- 如果指定的最不发达国家助记符未包含在逻辑单元的最不发达国家列表中,那么将发生此情况。
缺省操作: 异常终止任务。
- 65 个 INVPARTN
- 如果未在与应用程序关联的分区集中定义指定的分区,那么将发生此情况。
缺省操作: 异常终止任务。
- 16 INVREQ
- RESP2 值:
- 200
- 分布式程序链接服务器应用程序尝试在其函数输送会话 (其主体设施) 上发送。
在以下情况下也会发生 (未设置RESP2 ):- 当 BMS 逻辑消息处于活动状态时,会将控制信息输出到与映射数据相同的分区或最不发达国家。 如果既未使用分区也未使用最不发达国家,那么会将控制信息输出到与映射数据相同的设备。
缺省操作: 异常终止任务。
- 32 RETPAGE
- 如果指定了 SET 选项,并且已完成的页面已准备好返回到应用程序,那么将发生此错误。
缺省操作: 在紧跟 BMS SEND 命令之后的位置将控制权返回给应用程序。
- 35 TSIOERR
- 发生不可恢复的临时存储器输入/输出错误。
缺省操作: 异常终止任务。
- 03 WRBRK
- 如果终端操作员按 ATTN 键中断了该命令,那么将发生此情况。 它仅适用于 2741 通信终端,并且仅当 CICS支持写中断时才适用。
缺省操作: 忽略条件。
