SEND (LUTYPE2/LUTYPE3)
将数据写入 3270 显示逻辑单元 (LUTYPE2) 或 3270 打印机逻辑单元 (LUTYPE3)。
语法
条件: INVREQ , LENGERR 和 TERMERR
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
描述
SEND 命令将数据写入终端。
选项
- 备用
- 设置终端以使用 ALTERNATE 屏幕大小。
- CTLCHAR (data-value)
- 指定用于控制 3270 的 SEND 命令的 1 字节写控制字符 (WCC)。 IBM 3270 数据流程序员参考中对这些字符进行了说明。 COBOL 用户必须指定包含该字符的数据区。 如果省略该选项,那么所有已修改的数据标记都将重置为零并恢复键盘。
- 缺省值
- 设置终端以使用 DEFAULT 屏幕大小。
- DEFRESP
- 指示输出操作完成时需要明确的响应。
- 删除
- 指定要擦除屏幕打印机缓冲区或分区,并将光标返回到屏幕左上角。 此选项仅适用于 3270 或 8775 以及 3604 键盘显示。
任何事务或一系列伪会话事务中的第一个输出操作必须始终指定 ERASE 选项。 对于连接到 3270 屏幕或打印机的事务,除非 DEFAULT 或 ALTERNATE 选项显式覆盖,否则此选项还可确保选择正确的屏幕大小,如 PROFILE 资源定义中的 SCRNSIZE 选项为事务定义的那样。
- FLENGTH (data-value)
- LENGTH 选项的替代方法。 出于体系结构原因,对于所有与终端相关的 SEND 命令,此选项限制为最大 32 KB。
- FROM (数据区)
- 指定要写入逻辑单元或伙伴事务的数据。
- 邀请函
- 对于 SEND (APPC) 命令,应用程序可以使用 INVITE 选项向已发送到已连接 APPC 系统中的进程的数据添加更改方向指示符。 除非在 GDS SEND INVITE 命令上也编码了 CONFIRM 或 WAIT ,否则控制数据不会由 CICS® 传输,直到后续的 WAIT 或 SYNCPOINT 命令为止。
对于其他 SEND 命令, INVITE 指定要为此设施运行的下一个终端控制命令是 RECEIVE。 这允许出现最佳流。
- 最后一个
- 指定这是事务的最后一个 SEND 命令。
- LENGTH (data-value)
- 指定要写入的数据的长度 (作为半字二进制值)。 有关安全上限的说明,请参阅 翻译注意事项:EXEC CICS 命令中的 LENGTH 选项。
- STRFIELD
- 指定 FROM 选项中指定的数据区包含结构化字段。 如果指定了此选项,那么应用程序必须处理所有结构化字段的内容。 如果数据区包含读分区结构化字段,那么必须使用 CONVERSE 命令而不是 SEND 命令。 IBM 3270 数据流程序员参考中描述了结构化字段)
CTLCHAR 和 ERASE 选项与 STRFIELD互斥,它们与 STRFIELD 一起使用会生成错误消息。
- WAIT
- 指定在尝试任何后续处理之前必须完成该命令的处理。
如果未指定 WAIT 选项,那么当命令的处理开始时,控制权将返回给应用程序。 对与任务关联的终端的后续输入或输出请求 (终端控制, BMS 或批处理数据交换) 会导致应用程序等待上一个请求完成。
条件
以下某些情况可能组合出现。 如果发生多个事件,那么仅会将第一个事件传递到应用程序。 但是,设置了 EIBRCODE 以指示发生的所有条件。
- 16 INVREQ
- RESP2 值:
- 200
- 分布式程序链接服务器应用程序尝试在其函数输送会话 (其主体设施) 上发送。
对于 SEND (APPC) ,分布式程序链接服务器应用程序在 CONVID 选项上指定了函数输送会话 (其主体设施)。
在下列任何情况下也会发生 (未设置RESP2 ):- 已指定 CONFIRM 选项,但 APPC 对话不是同步级别 1 或 2。
- SEND 命令已在不是映射对话或未使用 EXEC CICS 接口的 APPC 对话上使用。
缺省操作: 异常终止任务。
- 22 LENGERR
- 在 长度 或 长度 选项中提供了超出范围的值时发生。
缺省操作: 异常终止任务。
- 81 个 TERMERR
- 发生与会话相关的错误。 对该对话执行的除 FREE 以外的任何操作都将导致另一个 TERMERR 条件。
如果用户节点错误程序 (NEP) 的 CANCEL TASK 请求在节点异常条件程序处理会话错误时有未完成的终端控制请求处于活动状态,那么可能会导致此情况。
缺省操作: 异常终止任务,异常终止代码为 ATNI。
