SEND MAP MAPPINGDEV

描述

SEND MAP MAPPINGDEV 创建要发送到非事务主体设施的终端的映射输出数据。 要使用的终端特征由 MAPPINGDEV 定义。

映射的数据不会传输，但会返回到由 SET 选项定义的缓冲区中的应用程序。

选项

ALARM

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

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

CURSOR (data-value)

指定当 SEND MAP MAPPINGDEV 命令完成时要将 3270 游标返回到的位置。

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

此选项覆盖 DFHMDF 的 ATTRB 操作数的任何 IC 选项。

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

仅数据

指定仅写入应用程序数据。 必须为提供的数据中的每个字段指定属性字符 (仅限 3270)。 如果用户提供的数据中的属性字节设置为 X'00 '，那么屏幕上的属性字节保持不变。 将忽略映射中的任何缺省数据或属性。

ERASE

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

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

ERASEAUP

指定在显示此输出页面之前，将擦除整个屏幕中所有不受保护的字符位置。 (此选项仅适用于 3270 和 8775。)

FORMFEED

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

免费 KB

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

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

FROM (数据区)

指定包含要处理的数据的数据区。 如果未指定此字段，那么该名称缺省为以 O 为后缀的映射的名称。 这包括由 DFHMDI 和 DFHMSD BMS 映射定义上的 TIOAPFX=YES 选项生成的 12 字节前缀 (请参阅 DFHMDI 操作数， TERM 和 在 BMS 操作数中指定 NODDS)。

FRSET

指定在将任何映射数据写入缓冲区之前，将当前在 3270 缓冲区中的所有字段的已修改数据标记 (MDT) 重置为未修改的条件 (即，字段重置)。

这允许请求的映射的 DFHMDF 的 ATTRB 操作数控制为响应 BMS 命令而写入或重写的字段的最终状态 (如果未在符号映射中写入其他属性信息)。

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

LENGTH (data-value)

指定要格式化为半字二进制值的数据的长度。

如果发送映射的数据区长于要映射的数据，那么应指定 LENGTH。 这应该包括由 DFHMDI 和 DFHMSD BMS 映射定义上的 TIOAPFX=YES 选项生成的 12 字节前缀的长度 (请参阅 DFHMDI 操作数， TERM 和 在 BMS 操作数中指定 NODDS)。 有关安全上限的描述，请参阅 CICS 命令中的 LENGTH 选项。

MAP (name)

指定要使用的映射的名称 (1-7 个字符)。

MAPPINGDEV (data-value)

指定一个 3270 终端的名称，该 3270 终端的 BMS 特征与最终将使用 SEND TEXT MAP 命令或终端控制 SEND 或 CONVERSE 将数据发送到的终端的 BMS 特征相匹配。

MAPONLY

指定仅写入映射中的缺省数据。

MAPSET (名称)

指定要使用的映射集的非后缀名 (1-7 个字符)。 映射集必须位于 CICS ® 程序库中。 可以使用 RDO 来定义映射集，也可以在首次使用映射集时由程序自动安装来定义映射集。 如果未指定此选项，那么假定 MAP 选项中给定的名称是映射集的名称。

每个映射集的映射数限制为最大值 9 998。

PRINT

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

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

SET (ptr-ref)

指定要设置为映射数据的地址的指针。

包含映射数据的存储区域的格式与使用完整 BMS SEND 命令中的 SET 选项时返回的页面缓冲区的格式相同。 有关使用 SET 选项的更多指导信息，请参阅 MAPPINGDEV 设施。

条件

以下某些情况可能组合出现。 如果发生多个事件，那么仅会将第一个事件传递到应用程序。

38 个 INVMPSZ

如果指定的映射对于 MAPPINGDEV 指定的终端太宽，或者如果 HANDLE CONDITION OVERFLOW 命令处于活动状态并且指定的映射对于 MAPPINGDEV 指定的终端太长，那么将发生此情况。

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

16 INVREQ

如果 MAPPINGDEV 指定的终端不存在，不支持 BMS ，或者不是 3270 打印机或显示器，那么将发生此情况。

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