SEND TEXT

描述

SEND TEXT 发送不带映射的文本数据。 将文本拆分为与终端具有相同宽度的行，从而使单词不会跨行边界中断。 如果文本超过某个页面，那么会将其拆分为适合具有应用程序定义的头和尾数的终端的页面。

将 SEND TEXT 命令与任何 ALARM ， FREEKB ， FRSET ， HONEOM ， L40， L64， L80或 PRINT 选项一起使用时，请参阅 DFHMDI 选项， CTRL 以获取选项优先级的描述。

选项

ACCUM

指定此命令是用于构建逻辑消息的若干命令之一。 逻辑消息由 SEND PAGE 命令完成，或由 PURGE MESSAGE 命令删除。

HEADER ， JUSFIRST ， JUSLAST ，有所对齐和尾部都意味着 ACCUM。

ACTPARTN (名称)

指定要激活的分区的名称 (1-2 个字符)。 激活分区会将光标移动到指定分区中，并解锁指定分区的键盘。

如果目标终端不支持分区，或者没有应用程序分区集，那么将忽略此选项。

ALARM

指定要激活 3270 可听警报功能。 对于支持 FMHs 的逻辑单元 (交互式和批处理逻辑单元除外) ， ALARM 指示 BMS 在 FMH 中设置警报标志。

备用

设置终端以使用 ALTERNATE 屏幕大小。

CURSOR (data-value)

指定在完成 SEND TEXT 命令时将 3270 或 3604 游标返回到的位置。

数据值必须是半字二进制值，用于指定相对于零的光标位置; 可指定的值范围取决于正在使用的屏幕的大小。

此选项覆盖 DFHMDF 的 ATTRB 操作数的任何 IC 选项。 如果正在使用 ACCUM ，那么将使用指定的 CURSOR 的最新值来定位游标。

CURSOR 选项中指定的值必须为正数。 负值会导致不可预测的结果。

缺省值

设置终端以使用 DEFAULT 屏幕大小。

ERASE

指定要擦除屏幕打印机缓冲区或分区，并将光标返回到屏幕左上角。 (此选项仅适用于 3270 或 8775 以及 3604 键盘显示。)

任何事务或一系列伪会话事务中的第一个输出操作应始终指定 ERASE。 对于连接到 3270 屏幕或打印机的事务，除非 DEFAULT 或 ALTERNATE 选项显式覆盖，否则这还可确保选择正确的屏幕大小，如 RDO PROFILE 定义中的 SCRNSIZE 选项为事务定义的那样。

FMHPARM (名称)

指定要使用的外部映射的名称 (1-8 个字符)。 (此选项仅适用于具有外部格式的 3650 个逻辑单元。)

FORMFEED

指定需要新页面。 对于 3270 打印机和显示器， FORMFEED 字符位于缓冲区的开头。 因此，应用程序必须确保此缓冲区位置不会被映射或文本数据覆盖。 如果目标终端不支持 FORMFEED (即，未使用 RDO TYPETERM 选项 FORMFEED) ，那么将忽略此参数。

FORMFEED 选项可以出现在任何 SEND TEXT AC暨命令上。 您只需要在物理页面中指定一次，因为它始终在物理页面的开头强制使用 FORMFEED。 To force a FORMFEED at the start of a particular SEND TEXT ACCUM command, use the JUSFIRST option instead.

免费 KB

指定在写入数据后应该解锁 3270 键盘。 如果省略 FREEKB ，那么键盘保持锁定状态。

使用 FREEKB 选项时，请参阅 DFHMDI 选项， CTRL 以获取选项优先级的描述。

请注意，对于支持分区的终端上的每个分区，将单独维护键盘锁定状态。

FROM (数据区)

指定包含要发送的数据的数据区。

HEADER (数据区)

指定要放置在每页文本数据开头的标题数据。 头的格式为:

2 字节

数据的二进制长度 (n)。

1 字节

需要或不需要页码 (空白)。

1 字节

保留字段。

N 字节

的合法性。

请参阅 标题和尾部格式 以获取更多信息。

HONEOM

指定将使用缺省打印机行长度。 此长度应该与使用 RDO TYPETERM 选项 PAGESIZE 或 ALTPAGE 指定的长度相同，并且与打印机打印纸宽度相同; 否则，数据可能无法正确格式化。

使用 HONEOM 选项时，请参阅 DFHMDI 选项， CTRL 以获取选项优先级的描述。

日美第一

指定文本数据将放置在页面顶部。 先前请求中的任何部分格式化的页面都被认为是完整的。 如果指定了 HEADER 选项，那么头在数据之前。 另请参阅对齐选项的描述。

日上

指定文本数据将位于页面底部。 处理请求后，将认为页面已完成。 如果指定了挂车选项，那么挂车遵循数据。 另请参阅对齐选项的描述。

对齐 (data-value)

指定要在其中定位文本数据的页面的行。 数据值必须是 1 到 240 范围内的半字二进制值。 虽然不能将它们指定为常量，但是可以动态地提供特殊值 -1 和 -2 以分别表示 JUSFIRST 或 JUSLAST。

最后一个

指定这是事务的最后一个输出操作，因此是支架的结尾。 此选项仅适用于逻辑单元。

最不发达国家 (name)

指定要用于确定要在 FMH 中传输到逻辑单元的逻辑设备代码 (最不发达) 的 2 字符助记符。 助记符标识由 DFHTCT TYPE=最不发达国家宏定义的最不发达国家条目。

当指定了最不发达国家时， BMS 使用设备类型，页面大小和与最不发达国家助记符关联的页面状态来格式化消息。 这些值取自逻辑单元的扩展本地最不发达国家表 (如果有)。 如果逻辑单元只有本地 (未扩展) 最不发达国家表，那么将从系统最不发达国家表中获取值。 从本地的 "最不发达国家" 表中获取 "最不发达国家" 的数字值，除非这是一个未扩展的表，并且未指定该值，在这种情况下，将从系统表中获取该值。

LENGTH (data-value)

指定要作为半字二进制值发送的数据的长度。 有关安全上限的描述，请参阅 CICS 命令中的 LENGTH 选项。

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) 控制值常量 DFHMSRCA 以获取完整列表。 如果未使用 RDO TYPETERM 选项 MSRCONTROL ，那么将忽略此选项。

NLEOM

指定使用打印机适配器功能部件的 3270 打印机或 3275 显示器的数据应该使用空格和换行符 (NL) 来构建，并且应该将消息结束 (EM) 字符放在数据的末尾。 当打印数据时，每个 NL 字符会使打印在下一行上继续，而 EM 字符会终止打印。

必须在用于构建逻辑消息的第一个 SEND TEXT 命令中指定此选项。 如果接收消息 (直接或路由) 的设备不是上述其中之一，那么将忽略该选项。

如果使用此选项，那么不允许对先前写入缓冲区的字段进行缓冲区更新和属性修改。 CICS 在每次写入终端时都包含 ERASE 选项。

NL 字符占用缓冲区位置。 许多缓冲区位置 (相当于该终端的 RDO TYPETERM 选项 PAGESIZE 或 ALTPAGE 的值) 不可用于数据。 这可能会导致数据在缓冲区中回绕; 如果发生此情况，那么必须减小 PGESIZE 值。

如果存在 ALARM 选项，那么 NLEOM 选项将覆盖该选项。

OUTPARTN (名称)

指定要向其发送数据的分区的名称 (1-2 个字符)。 如果终端不支持分区，或者没有与终端关联的应用程序分区集，那么将忽略此选项。 如果存在应用程序分区集，并且省略了 OUTPARTN 选项，那么会将数据发送到由 DFHMSD 或 DFHMDI 映射定义的 PARTN 操作数指定的分区。 如果未使用映射，或者没有 PARTN 操作数，那么会将输出发送到分区集中的第一个分区。

页面调度

指定输出数据不被立即发送到终端，而是被放置在临时存储器中，并响应终端操作员输入的寻呼命令而显示。

如果使用用于定义为可恢复的临时存储器队列的 REQID 前缀指定了调页，那么当任务已达到同步点时， CICS 将为逻辑消息提供消息恢复。

PRINT

指定要在 3270 打印机或具有打印机适配器功能的 3275 上启动打印操作，或者要在控制器分配的打印机上打印 LUTYPE2 (3274/76 或 3790) 上的数据。 如果省略此选项，那么会将数据发送至打印机缓冲区，但不会打印数据。

使用 PRINT 选项时，请参阅 DFHMDI 选项， CTRL 以获取选项优先级的描述。

REQID (名称)

指定要用作 CICS 消息恢复临时存储器标识的一部分的 2 字符前缀。 只能为每条逻辑消息指定一个前缀。 缺省前缀为 **。

仅当在 BMS SEND 命令中指定了调页选项并且已达到同步点时，才会为逻辑消息提供 BMS 消息恢复。

SET (ptr-ref)

指定要设置为数据地址的指针。 它指定要将已完成的页面返回到应用程序。 指针设置为已完成页面列表的地址。

应用程序在紧跟 BMS SEND 命令之后 (如果当前页面尚未完成) 或在 HANDLE CONDITION RETPAGE 命令中指定的标签处 (如果页面已完成) 重新获得控制。

如果在映射定义中指定了 TIOAPFX=YES ，那么返回的指针将包含 TIOA 前缀的地址。 用户数据从 TIOA 前缀开头的偏移量 X'0C' 处开始。

TERMINAL

指定要将数据发送到发起事务的终端。

尾部 (数据区)

指定包含要放置在每个输出页面底部的尾部数据的文本数据区域。 预告片的格式为:

2 字节

数据的二进制长度 (n)

1 字节

需要或不需要页码 (空白)

1 字节

保留字段

N 字节

数据

请参阅 标题和尾部格式 以获取更多信息。

WAIT

指定在输出操作完成之前，不应将控制返回到应用程序。

如果未指定 WAIT ，那么当输出操作已启动时，控制权将返回到应用程序。 后续输入或输出命令 (终端控制， BMS 或批处理数据交换) 会导致应用程序等待先前命令完成。

条件

57 IGREQCD

在从 LUTYPE4 逻辑单元接收到带有请求更改方向 (RCD) 代码的 SIGNAL 数据流控制命令之后尝试执行 SEND TEXT 命令时发生。

缺省操作: 异常终止任务。

39 IGREQID

如果 BMS SEND 命令的 REQID 选项中指定的前缀与先前 REQID 选项所建立的前缀不同，或者缺省情况下对此逻辑消息 REQID (**) 指定的前缀。

缺省操作: 异常终止任务。

41 名

如果指定的最不发达国家助记符未包含在逻辑单元的最不发达国家列表中，那么将发生此情况。

缺省操作: 异常终止任务。

65 个 INVPARTN

如果未在与应用程序关联的分区集中定义指定的分区，那么将发生此情况。

缺省操作: 异常终止任务。

16 INVREQ

RESP2 值：

200

不允许对分布式程序链接服务器程序使用命令。

在下列任何情况下也会发生 (未设置RESP2 ):

• 当 BMS 逻辑消息处于活动状态时，文本数据将输出到与映射数据相同的分区或最不发达国家。 如果未使用分区或最不发达国家，那么文本数据将输出到与映射数据相同的逻辑消息。
• 在溢出处理期间，会将数据发送到与导致页面溢出的最不发达国家不同的最不发达国家。
• SND TEXT 命令的头长度为负数。
• SEND TEXT 命令上的尾部长度为负数。

缺省操作: 异常终止任务。

22 LENGERR

如果在 LENGTH 选项中提供了超出范围的值，那么将发生此情况。

缺省操作: 异常终止任务。

32 RETPAGE

如果指定了 SET 选项，并且已完成的页面已准备好返回到应用程序，那么将发生此错误。

缺省操作: 在紧跟 BMS SEND TEXT 命令之后的位置将控制权返回给应用程序。

35 TSIOERR

发生不可恢复的临时存储器输入/输出错误。

缺省操作: 异常终止任务。

03 WRBRK

如果终端操作员按 ATTN 键中断了 SEND 命令，那么将发生此情况。 它仅适用于 2741 通信终端，并且仅当 CICS支持写中断时才适用。

缺省操作: 忽略条件。