SEND PAGE
发送最后一页数据。
描述
SEND PAGE 完成 BMS 逻辑消息。 它会导致 BMS 为最后一个 (可能是唯一的) 数据页面生成依赖于设备的数据流。 通常,此最后一页仅部分已满。SEND PAGE 仅由完整的 BMS 提供。 有关 BMS 的更多信息,请参阅 基本映射支持。
可以包含一些选项,以指定终端操作员应该对逻辑消息 (AUTOPAGE , NOAUTOPAGE 和 OPERPURGE) 的处置进行多少控制,确定在传输逻辑消息 (RELEASE 或 RETAIN) 后,控制是否应该返回到应用程序,将尾部数据添加到文本逻辑消息 (挂车) ,并将逻辑消息的最后一页的与设备相关的数据流返回到应用程序 (SET)。 如果这是调页消息,那么逻辑消息的最后一页将传输到临时存储器,并启动终端操作员调页事务。 如果是终端逻辑消息,则将最后一页传输到终端。
这仅受完整 BMS 支持。
选项
- ALL
- 指定在向终端发送 BMS 逻辑消息时,如果按下 2741 上的 ATTN 键,且 WRBRK 条件不活动,则停止当前页面的传输,且不传输其他页面。 已删除逻辑消息。
- AUTOPAGE
- 指定 BMS 逻辑消息的每个页面在可用时立即发送到终端。 如果通过 RDO TYPETERM 选项 AUTOPAGE (NO) 为终端指定了页面调度请求,那么 AUTOPAGE 将覆盖此逻辑消息的该请求。
假定 AUTOPAGE 用于 3270 打印机; 它不适用于 3270 显示终端。 如果既未指定 AUTOPAGE ,也未指定 NOAUTOPAGE ,那么终端具有使用 RDO TYPETERM 选项 AUTOPAGE 为其指定的页面调度状态。
- CURRENT
- 指定在向终端发送 BMS 逻辑消息时,如果按下 2741 上的 ATTN 键,且 WRBRK 条件未处于活动状态,则停止当前页面的传输,并开始下一页面 (如果有) 的传输。
- FMHPARM (名称)
- 指定要使用的外部映射的名称 (1-8 个字符)。 此选项仅适用于具有外部格式的 3650 个逻辑单元。
- 最后一个
- 指定这是事务的最后一个输出操作,因此是支架的结尾。 如果指定了 RELEASE ,那么除非 SEND PAGE 命令正在终止路由操作,否则将采用 LAST。 此选项仅适用于逻辑单元。
- NOAUTOPAGE
- 指定一次向终端发送一个 BMS 逻辑消息页面。 BMS 在终端可用时或应终端运营商的请求向终端发送第一页。 响应来自终端操作员的请求,将后续页面发送到终端。
如果 RDO TYPETERM 选项 AUTOPAGE (YES) 为终端指定了自动页面调度,那么 NOAUTOPAGE 将覆盖此逻辑消息。 对于逻辑单元, NOAUTOPAGE 适用于逻辑 message.NOAUTOPAGE 中所有最不发达国家的所有页面不适用于 3270 打印机。
- 操作清除
- 指定 CICS® 仅在终端操作员请求删除时删除 BMS 逻辑消息。 如果省略了该选项,那么当操作员输入不是调页命令的数据时, CICS 会删除该消息。
- RELEASE
- 指定在 SEND PAGE 命令之后,将控制权返回给 CICS。
- RETAIN
- 指定在 SEND PAGE 命令之后,当操作员完成显示页面时,将控制权返回给应用程序。
- SET (ptr-ref)
- 指定要设置为输出数据地址的指针。
SET 选项指定将最后一页或唯一一页返回给应用程序。 指针设置为当前页面的地址。 将创建一个地址列表,如果 ROUTE 命令正在运行,那么每个设备都有一个地址条目。 如果 ROUTE 命令未在运行,那么列表仅包含一个条目。
应用程序在紧跟 SEND PAGE 命令之后 (如果当前页面尚未完成) 或在 HANDLE CONDITION RETPAGE 命令中指定的标签处 (如果页面已完成) 重新获得控制。
如果在映射定义中指定了 TIOAPFX=YES ,那么返回的指针将包含 TIOA 前缀的地址。 用户数据从 TIOA 前缀开头的偏移量 X'0C' 处开始。
- 尾部 (数据区)
- 指定包含仅放置在最后一页底部的尾部数据的文本数据区域。 预告片的格式为:
- 2 字节
- 数据的二进制长度 (n)
- 2 字节
- 二进制零
- N 字节
- 的合法性。
请参阅 SEND PAGE 命令 以获取更多信息。
- TRANSID (名称)
- 指定要与任务所连接的终端的下一条输入消息配合使用的事务标识 (1-4 个字母数字字符)。 该标识必须已通过 RDO TRANSACTION 资源定义定义到 CICS 。 仅当指定了 SEND PAGE RELEASE 时, TRANSID 才有效。
如果在未处于最高逻辑级别的程序中指定此选项,那么仅当在较高逻辑级别的程序中发出的另一 SEND PAGE 命令 (或 RETURN 程序控制命令) 中未提供新的事务标识时,才会使用指定的事务标识。
条件
- 57 IGREQCD
- 在从 LUTYPE4 逻辑单元接收到具有请求更改方向 (RCD) 代码的 SIGNAL 数据流控制命令之后尝试执行 SEND PAGE 命令时发生。
缺省操作: 异常终止任务。
- 16 INVREQ
- RESP2 值:
- 200
- 不允许对分布式程序链接服务器程序使用命令。
在下列任何情况下也会发生 (未设置RESP2 ):- BMS 逻辑消息的处置 (TERMINAL , PAGE 或 SET) 在 SEND PAGE 命令完成之前更改。
- 当 BMS 逻辑消息处于活动状态时,文本数据将输出到与映射数据相同的分区或最不发达国家。 如果未使用分区或最不发达国家,那么文本数据将输出到与映射数据相同的逻辑消息。
- 当终止仅使用 SEND MAP 命令构建的逻辑消息时,指定尾部选项。
- 在溢出处理期间,将数据发送到与导致页面溢出的最不发达国家不同的最不发达国家。
- 拖车的长度为负数。
缺省操作: 异常终止任务。
- 32 RETPAGE
- 如果指定了 SET 选项,并且最后一个或唯一完成的页面已准备好返回到应用程序,那么将发生此错误。
缺省操作: 在紧跟 BMS SEND PAGE 命令之后的位置将控制权返回给应用程序。
- 35 TSIOERR
- 发生不可恢复的临时存储器输入/输出错误。
缺省操作: 异常终止任务。
- 03 WRBRK
- 如果终端操作员按 ATTN 键中断 SEND PAGE 命令,那么将发生此情况。 它仅适用于 2741 通信终端,并且仅当 CICS支持写中断时才适用。
缺省操作: 忽略条件。
