SEND: z/OS Communications Server 选项

选项

备用

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

ATTACHID (名称)

指定连接头 (由 BUILD ATTACH 命令创建) 要在 FROM 选项中提供的用户数据之前并与之并置。 "name" (1-8 个字符) 标识要在本地任务中使用的连接头控制块。

CNOTCOMPL

指示由于此 SEND 命令而发送的请求/响应单元 (RU) 未完成链。 如果省略此选项并指定链组合件，那么 RU 将终止链。

确认

指示使用同步级别 1 或 2 对话的应用程序需要来自远程应用程序的响应。 远程 CICS® 应用程序可以通过运行 ISSUE CONFIRMATION 命令进行正面响应，也可以通过运行 ISSUE ERROR 命令进行负面响应，在这种情况下，发送应用程序会设置 EIBERR 和 EIBERRCD。 在接收到响应之前， CICS 不会将控制权返回给发送应用程序。

CONVID (名称)

标识与命令相关的对话。 4 字符名称标识 EIB 中 EIBRSRCE 中先前 ALLOCATE 命令返回的令牌，或表示主体会话的令牌 (由先前 ASSIGN 命令返回)。

为了与先前发行版兼容，接受 SESSION 作为 CONVID 的同义词。 新程序必须使用 CONVID。

如果省略此选项，那么将采用主体设施。

CTLCHAR (data-value)

指定用于控制 3270 的 SEND 命令的 1 字节写控制字符 (WCC)。 IBM 3270 Data Stream Programmers Reference中描述了这些字符。 COBOL 用户必须指定包含该字符的数据区。 如果省略该选项，那么所有已修改的数据标记都将重置为零并恢复键盘。

缺省值

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

DEFRESP

指示输出操作完成时需要明确的响应。

删除

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

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

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 命令。

最不发达国家 (name)

指定用于确定相应逻辑设备代码 (最不发达国家) 数字值的 2 字符助记符。 助记符表示终端控制表TYPE=最不发达的最不发达国家条目。

LENGTH (data-value)

指定要写入的数据的长度 (作为半字二进制值)。 有关安全上限的说明，请参阅 翻译注意事项：EXEC CICS 命令中的 LENGTH 选项。

会话 (name)

指定会话 TCTTE 的符号标识 (1-4 个字符)。 此选项指定要使用的备用设施。 如果省略此选项，那么将使用任务的主体设施。

状态 (cvda)

获取当前对话的状态。 CICS 返回的 CVDA 值为:

• 已分配
• 经济及社会理事会
• 确认
• 交汇
• FREE
• 无暂挂
• 暂挂接收
• RECEIVE
• 回滚
• SEND
• 无同步
• 同步接收
• 同步发送

STRFIELD

指定 FROM 选项中指定的数据区包含结构化字段。 如果指定了此选项，那么应用程序必须处理所有结构化字段的内容。 如果数据区包含读分区结构化字段，那么必须使用 CONVERSE 命令而不是 SEND 命令。 结构化字段在 IBM 3270 数据流程序员参考中进行了描述。)

CTLCHAR 和 ERASE 选项与 STRFIELD互斥，它们与 STRFIELD 一起使用会生成错误消息。

WAIT

指定在尝试任何后续处理之前必须完成该命令的处理。

如果未指定 WAIT 选项，那么当命令的处理开始时，控制权将返回给应用程序。 对与任务关联的终端的后续输入或输出请求 (终端控制， BMS 或批处理数据交换) 会导致应用程序等待上一个请求完成。

条件

以下某些情况可能组合出现。 如果发生多个事件，那么仅会将第一个事件传递到应用程序。 但是，设置了 EIBRCODE 以指示发生的所有条件。

62 CBIDERR

如果找不到 ATTACHID 中指定的请求的连接头控制块，那么将发生此情况。

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

57 IGREQCD

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

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

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。