SEND (LUTYPE6.1)
在 LUTYPE6.1 对话中发送数据。
语法
条件: CBIDERR , INVREQ , REGERR , NOTALLOC , SIGNAL 和 TERMERR
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
描述
SEND 将数据发送到 LUTYPE6.1 对话上的对话伙伴。
选项
- ATTACHID (名称)
- 指定连接头 (由 BUILD ATTACH 命令创建) 要在 FROM 选项中提供的用户数据之前并与之并置。 "name" (1-8 个字符) 标识要在本地任务中使用的连接头控制块。
- 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)
- 指定要写入的数据的长度 (作为半字二进制值)。 有关安全上限的说明,请参阅 翻译注意事项:EXEC CICS 命令中的 LENGTH 选项。
- 会话 (name)
- 指定会话 TCTTE 的符号标识 (1-4 个字符)。 此选项指定要使用的备用设施。 如果省略此选项,那么将使用任务的主体设施。
- WAIT
- 指定在尝试任何后续处理之前必须完成该命令的处理。
如果未指定 WAIT 选项,那么当命令的处理开始时,控制权将返回给应用程序。 对与任务关联的终端的后续输入或输出请求 (终端控制, BMS 或批处理数据交换) 会导致应用程序等待上一个请求完成。
条件
以下某些情况可能组合出现。 如果发生多个事件,那么仅会将第一个事件传递到应用程序。 但是,设置了 EIBRCODE 以指示发生的所有条件。
- 62 CBIDERR
- 如果找不到 ATTACHID 中指定的请求的连接头控制块,那么将发生此情况。
缺省操作: 异常终止任务。
- 16 INVREQ
- RESP2 值:
- 200
- 分布式程序链接服务器应用程序尝试在其函数输送会话 (其主体设施) 上发送。
对于 SEND (APPC) ,分布式程序链接服务器应用程序在 CONVID 选项上指定了函数输送会话 (其主体设施)。
在下列任何情况下也会发生 (未设置RESP2 ):- 已指定 CONFIRM 选项,但 APPC 对话不是同步级别 1 或 2。
- SEND 命令已在不是映射对话或未使用 EXEC CICS 接口的 APPC 对话上使用。
缺省操作: 异常终止任务。
- 22 LENGERR
- 在 长度 或 长度 选项中提供了超出范围的值时发生。
缺省操作: 异常终止任务。
- 61 个 NOTALLOC
- 如果命令中的 CONVID 值与应用程序拥有的对话无关,或者如果命令中指定的设施不是由应用程序拥有,那么将发生此情况。
缺省操作: 异常终止任务。
- 24 信号
- 当从逻辑单元或会话接收到入站 SIGNAL 数据流控制命令时发生。 当接收到入站信号时,始终设置 EIBSIG。
缺省操作: 忽略条件。
- 81 个 TERMERR
- 发生与会话相关的错误。 对该对话执行的除 FREE 以外的任何操作都将导致另一个 TERMERR 条件。
如果用户节点错误程序 (NEP) 的 CANCEL TASK 请求在节点异常条件程序处理会话错误时有未完成的终端控制请求处于活动状态,那么可能会导致此情况。
缺省操作: 异常终止任务,异常终止代码为 ATNI。
