SEND PAGE

发送最后一页数据。

SEND PAGE

读取语法图跳过可视语法图SEND PAGERELEASETRANSID( 名称)RETAINTRAILER( data-area)SET( ptr-引用)AUTOPAGECURRENTALLNOAUTOPAGEOPERPURGEFMHPARM( 名称)LAST

条件: IGREQCD , INVREQ , RETPAGE , TSIOERR 和 WRBRK

 

描述

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支持写中断时才适用。

缺省操作: 忽略条件。