SEND (3770)
将数据写入 3770 批处理逻辑单元。
描述
SEND 将数据写入终端。
选项
- CNOTCOMPL
- 指示由于此 SEND 命令而发送的请求/响应单元 (RU) 未完成链。 如果省略此选项并指定链组合件,那么 RU 将终止链。
- DEFRESP
- 指示输出操作完成时需要明确的响应。
- FLENGTH (data-value)
- LENGTH 选项的替代方法。 出于体系结构原因,对于所有与终端相关的 SEND 命令,此选项限制为最大 32 KB。
- FMH
- 指定要写入的数据中包含函数管理头。 如果同时指定了 ATTACHID 选项,那么将在连接 FMH 中设置并置的 FMH 标志。
FMH 的使用是可选的,并非所有终端类型都支持此功能。 如果未提供,那么 CICS® 将不执行任何操作,但 3600/4700 终端除外,其中 FMH 是必需的。 在这种情况下,如果未指定 FMH ,那么 CICS 将提供一个,并将其放在消息的前 3 个字节中,您必须为此目的保留这些字节。
- FROM (数据区)
- 指定要写入逻辑单元或伙伴事务的数据。
- 邀请函
- 对于 SEND (APPC) 命令,应用程序可以使用 INVITE 选项向已发送到已连接 APPC 系统中的进程的数据添加更改方向指示符。 除非在 GDS SEND INVITE 命令上也编码了 CONFIRM 或 WAIT ,否则 CICS 不会传输控制数据,直到后续的 WAIT 或 SYNCPOINT 命令为止。
对于其他 SEND 命令, INVITE 指定要为此设施运行的下一个终端控制命令是 RECEIVE。 这允许出现最佳流。
- 最后一个
- 指定这是事务的最后一个 SEND 命令。
- LENGTH (data-value)
- 指定要写入的数据的长度 (作为半字二进制值)。 有关安全上限的描述,请参阅 CICS 命令中的 LENGTH 选项。
- WAIT
- 指定在尝试任何后续处理之前必须完成该命令的处理。
如果未指定 WAIT 选项,那么当命令的处理开始时,控制权将返回给应用程序。 对与任务关联的终端的后续输入或输出请求 (终端控制, BMS 或批处理数据交换) 会导致应用程序等待上一个请求完成。
条件
以下某些情况可能组合出现。 如果发生多个事件,那么仅会将第一个事件传递到应用程序。 但是,设置了 EIBRCODE 以指示发生的所有条件。
- 16 INVREQ
- RESP2 值:
- 200
- 分布式程序链接服务器应用程序尝试在其函数输送会话 (其主体设施) 上发送。
对于 SEND (APPC) ,分布式程序链接服务器应用程序在 CONVID 选项上指定了函数输送会话 (其主体设施)。
在下列任何情况下也会发生 (未设置RESP2 ):- 已指定 CONFIRM 选项,但 APPC 对话不是同步级别 1 或 2。
- SEND 命令已在不是映射对话或未使用 EXEC CICS 接口的 APPC 对话上使用。
缺省操作: 异常终止任务。
- 22 LENGERR
- 在 长度 或 长度 选项中提供了超出范围的值时发生。
缺省操作: 异常终止任务。
- 24 信号
- 当从逻辑单元或会话接收到入站 SIGNAL 数据流控制命令时发生。 当接收到入站信号时,始终设置 EIBSIG。
缺省操作: 忽略条件。
- 81 个 TERMERR
- 发生与会话相关的错误。 对该对话执行的除 FREE 以外的任何操作都将导致另一个 TERMERR 条件。
如果用户节点错误程序 (NEP) 的 CANCEL TASK 请求在节点异常条件程序处理会话错误时有未完成的终端控制请求处于活动状态,那么可能会导致此情况。
缺省操作: 异常终止任务,异常终止代码为 ATNI。
