SEND_DATA谓词将数据置于本地逻辑单元（LU）发送缓冲区中，以便传输到合作伙伴事务计划（TP）。
以下结构描述了 SEND_DATA 谓词使用的谓词控制块（VCB）。
语法
struct send_data {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char tp_id[8];
unsigned long conv_id;
unsigned char rts_rcvd;
unsigned char data_type;
unsigned short int dlen;
unsigned char FAR * dptr ;
unsigned char type;
unsigned char reserv4;
};
成员
opcode
提供的参数。 指定谓词作代码，AP_B_SEND_DATA。
opext
提供的参数。 指定谓词作扩展，AP_BASIC_CONVERSATION。
reserv2
保留字段。
primary_rc
返回的参数。 指定 APPC 在谓词完成时设置的主要返回代码。 有效的返回代码因发布的 APPC 谓词而异。 有关此谓词的有效错误代码，请参阅返回代码。
secondary_rc
返回的参数。 指定 APPC 在谓词完成时设置的辅助返回代码。 有效的返回代码因发布的 APPC 谓词而异。 有关此谓词的有效错误代码，请参阅返回代码。
tp_id
提供的参数。 标识本地 TP。
此参数的值由调用 TP 中的 TP_STARTED 或调用的 TP 中的 RECEIVE_ALLOCATE 返回。
conv_id
提供的参数。 提供会话标识符。
此参数的值由调用 TP 中的 ALLOCATE 或调用 TP 中的 RECEIVE_ALLOCATE 返回。
rts_rcvd
返回的参数。 提供请求到发送接收的指示器。
AP_YES指示合作伙伴 TP 已发出 REQUEST_TO_SEND，请求本地 TP 将会话更改为 RECEIVE 状态。 若要更改为 RECEIVE 状态，本地 TP 可以使用 PREPARE_TO_RECEIVE、 RECEIVE_AND_WAIT或 RECEIVE_AND_POST。
AP_NO表示合作伙伴 TP 尚未发出 REQUEST_TO_SEND。
data_type
提供的参数。 指定在支持同步点时要发送的数据的类型。 有效参数包括：AP_APPLICATION
AP_USER_CONTROL_DATA
AP_PS_HEADER
dlen
提供的参数。 指定要放入本地 LU 发送缓冲区的数据字节数。 范围为 0 到 65535。dptr
提供的参数。 指定要放入本地 LU 发送缓冲区中的数据的缓冲区的地址。对于 Microsoft Windows作系统，数据缓冲区可以驻留在静态数据区域或全局分配的区域。 数据缓冲区必须完全适合此区域。
类型
提供的参数。 允许 TP 在一个 API 调用中发送数据并执行其他函数。 例如，可以将 SEND_DATA 与设置为 CONFIRM 的类型 组合在一起，以实现与发出 SEND_DATA 后跟 CONFIRM 相同的目标。AP_SEND_DATA_CONFIRM对应于后跟 CONFIRM的SEND_DATA。
AP_SEND_DATA_FLUSH对应于后跟 FLUSH的SEND_DATA。
AP_SEND_DATA_DEALLOC_ABEND对应于SEND_DATA，后跟 DEALLOCATE，dealloc_type AP_ABEND_PROG。
AP_SEND_DATA_DEALLOC_FLUSH 对应于SEND_DATA ，后跟 DEALLOCATE ，其 dealloc_type 为AP_FLUSH。
AP_SEND_DATA_DEALLOC_SYNC_LEVEL对应于具有AP_SYNC_LEVELdealloc_type的 DEALLOCATE 后跟SEND_DATA。
AP_SEND_DATA_P_TO_R_FLUSH对应于SEND_DATA，后跟具有AP_FLUSH ptr_type的PREPARE_TO_RECEIVE。
AP_SEND_DATA_P_TO_R_SYNC_LEVEL对应于SEND_DATA，后跟PREPARE_TO_RECEIVE，其ptr_type AP_SYNC_LEVEL和锁设置为AP_SHORT。
reserv4
保留字段。
返回代码
AP_OK
主要返回代码;已成功执行谓词。
AP_PARAMETER_CHECK
主要返回代码;由于参数错误，谓词未执行。
AP_BAD_CONV_ID
辅助返回代码; conv_id 的值与 APPC 分配的会话标识符不匹配。
AP_BAD_LL
辅助返回代码;逻辑记录的逻辑记录长度字段包含无效值-0x0000、0x0001、0x8000或0x8001。 有关逻辑记录的信息，请参阅 “关于事务程序 ”。
AP_BAD_TP_ID
辅助返回代码; tp_id 的值与 APPC 分配的 TP 标识符不匹配。
AP_INVALID_DATA_SEGMENT
辅助返回代码;为数据缓冲区指定的长度比分配给包含缓冲区的段长。
AP_SEND_DATA_INVALID_TYPE
辅助返回代码;APPC 无法识别指定类型。
AP_SEND_DATA_CONFIRM_SYNC_NONE
辅助返回代码;对于使用 NONE sync_level分配的对话，不允许类型 CONFIRM。
AP_STATE_CHECK
主要返回代码;该谓词未执行，因为它以无效状态发出。
AP_SEND_DATA_NOT_SEND_STATE
辅助返回代码;本地 TP 发出SEND_DATA，但会话未处于 SEND 状态。
AP_SEND_DATA_NOT_LL_BDY
辅助返回代码;TP 已启动，但未完成发送逻辑记录。 仅当 类型 参数为下列类型参数之一时，才会发生此情况：
AP_SEND_DATA_CONFIRM
AP_SEND_DATA_DEALLOC_FLUSH
AP_SEND_DATA_DEALLOC_SYNC_LEVEL
AP_SEND_DATA_P_TO_R_FLUSH
AP_SEND_DATA_P_TO_R_SYNC_LEVEL
AP_ALLOCATION_ERROR
主要返回代码;APPC 未能分配会话。 会话状态设置为 RESET。
可以通过 ALLOCATE 后颁发的谓词返回此代码。
AP_ALLOCATION_FAILURE_NO_RETRY
辅助返回代码;由于永久条件（例如配置错误或会话协议错误），无法分配会话。 若要确定错误，系统管理员应检查错误日志文件。 在更正错误之前，不要重试分配。
AP_ALLOCATION_FAILURE_RETRY
辅助返回代码;由于临时条件（如链接失败），无法分配会话。 失败的原因记录在系统错误日志中。 重试分配。
AP_CONVERSATION_TYPE_MISMATCH
辅助返回代码;合作伙伴 LU 或 TP 不支持分配请求中指定的聊天类型（基本或映射）。
AP_PIP_NOT_ALLOWED
辅助返回代码;分配请求指定 PIP 数据，但合作伙伴 TP 不需要此数据，或者合作伙伴 LU 不支持它。
AP_PIP_NOT_SPECIFIED_CORRECTLY
辅助返回代码;合作伙伴 TP 需要 PIP 数据，但分配请求未指定 PIP 数据或参数数不正确。
AP_SECURITY_NOT_VALID
辅助返回代码;合作伙伴 LU 不接受分配请求中指定的用户标识符或密码。
AP_SYNC_LEVEL_NOT_SUPPORTED
辅助返回代码;合作伙伴 TP 不支持在分配请求中指定的 sync_level （AP_NONE或AP_CONFIRM_SYNC_LEVEL），或者无法识别 sync_level 。
AP_TP_NAME_NOT_RECOGNIZED
辅助返回代码;合作伙伴 LU 无法识别分配请求中指定的 TP 名称。
AP_TRANS_PGM_NOT_AVAIL_NO_RETRY
辅助返回代码;远程 LU 拒绝了分配请求，因为它无法启动请求的合作伙伴 TP。 条件是永久性的。 错误的原因可能在远程节点上记录。 在更正错误之前，不要重试分配。
AP_TRANS_PGM_NOT_AVAIL_RETRY
辅助返回代码;远程 LU 拒绝了分配请求，因为它无法启动请求的合作伙伴 TP。 条件可能是暂时性的，例如超时。错误的原因可能在远程节点上记录。 重试分配。
AP_COMM_SUBSYSTEM_ABENDED
主要返回代码;指示以下条件之一：
此会话使用的节点遇到 ABEND。
TP 与 PU 2.1 节点之间的连接已中断（LAN 错误）。
TP 计算机上的 SnaBase 遇到 ABEND。
系统管理员应检查错误日志以确定 ABEND 的原因。
AP_COMM_SUBSYSTEM_NOT_LOADED
主要返回代码;无法在处理谓词时加载或终止所需的组件。 因此，无法进行通信。 请联系系统管理员以采取纠正措施。当此返回代码与 ALLOCATE 一起使用时，它可能指示找不到任何通信系统来支持本地 LU。 （例如，使用 TP_STARTED 指定的本地 LU 别名不正确或尚未配置。请注意，如果 lu_alias 或 mode_name 少于 8 个字符，则必须确保这些字段填充右侧的空格。 如果这些参数未填充空格，则返回此错误，因为没有节点可以满足 ALLOCATE 请求。
当 ALLOCATE 为配置了多个节点的 Host Integration Server 客户端系统生成此返回代码时，有两个辅助返回代码，如下所示：
0xF0000001
辅助返回代码;尚未启动任何节点。
0xF0000002
辅助返回代码;至少有一个节点已启动，但未在任何活动节点上配置本地 LU （TP_STARTED颁发 时）。 问题可能是以下任一问题：
未启动具有本地 LU 的节点。
未配置本地 LU。
AP_CONV_FAILURE_NO_RETRY
主要返回代码;由于永久性条件（例如会话协议错误）而终止了会话。 系统管理员应检查系统错误日志以确定错误的原因。 在更正错误之前，不要重试对话。AP_CONV_FAILURE_RETRY
主要返回代码;由于临时错误，会话已终止。 重启 TP 以查看问题是否再次发生。 如果这样做，系统管理员应检查错误日志以确定错误的原因。AP_CONVERSATION_TYPE_MIXED
主要返回代码;TP 已发出基本和映射的对话谓词。 单个对话中只能发出一种类型。AP_INVALID_VERB_SEGMENT
主要返回代码;VCB 超出了数据段的末尾。AP_PROG_ERROR_PURGING
主要返回代码;在 RECEIVE、PENDING、PENDING_POST、CONFIRM、CONFIRM_SEND 或 CONFIRM_DEALLOCATE 状态中，合作伙伴 TP 发出SEND_ERROR，err_type设置为AP_PROG。 已清除发送但尚未收到的数据。AP_STACK_TOO_SMALL
主要返回代码;应用程序的堆栈大小太小，无法执行谓词。 增加应用程序的堆栈大小。AP_CONV_BUSY
主要返回代码;在任何对话中，一次只能有一个未完成的对话谓词。 如果本地 TP 有多个线程，并且多个线程使用相同的 conv_id发出 APPC 调用，则可能会出现这种情况。AP_THREAD_BLOCKING
主要返回代码;调用线程已在阻塞调用中。AP_UNEXPECTED_DOS_ERROR
主要返回代码;作系统在处理来自本地 TP 的 APPC 调用时，已将错误返回到 APPC。 作系统返回代码通过 secondary_rc返回。 它以 Intel 字节交换的顺序显示。 如果问题仍然存在，请咨询系统管理员。AP_DEALLOC_ABEND_PROG
主要返回代码;由于以下原因之一，已解除分配会话：合作伙伴 TP 已颁发 DEALLOCATE，dealloc_type设置为AP_ABEND_PROG。
合作伙伴 TP 遇到 ABEND，导致合作伙伴 LU 发送 DEALLOCATE 请求。
AP_DEALLOC_ABEND_SVC
主要返回代码;会话已解除分配，因为合作伙伴 TP 发布了 DEALLOCATE，dealloc_type 设置为 AP_ABEND_SVC 。AP_DEALLOC_ABEND_TIMER
主要返回代码;会话已解除分配，因为合作伙伴 TP 发布了 DEALLOCATE，dealloc_type设置为AP_ABEND_TIMER。AP_SVC_ERROR_PURGING
主要返回代码;合作伙伴 TP（或 partner LU）在 RECEIVE、PENDING_POST、CONFIRM、CONFIRM_SEND 或CONFIRM_DEALLOCATE状态中，发出err_type设置为AP_SVC的SEND_ERROR谓词。 发送到合作伙伴 TP 的数据可能已被清除。
注解
当 TP 发出此谓词时，会话必须处于 SEND 状态。 下表汇总了基于 primary_rc的状态更改。
| primary_rc | 新状态 |
|---|---|
| AP_OK | 无更改 |
| AP_ALLOCATION_ERROR | 重置 |
| AP_CONV_FAILURE_RETRY | 重置 |
| AP_CONV_FAILURE_NO_RETRY | 重置 |
| AP_DEALLOC_ABEND | 重置 |
| AP_DEALLOC_ABEND_PROG | 重置 |
| AP_DEALLOC_ABEND_SVC | 重置 |
| AP_DEALLOC_ABEND_TIMER | 重置 |
| AP_PROG_ERROR_PURGING | 收到 |
| AP_SVC_ERROR_PURGING | 收到 |
SEND_DATA 可能会无限期等待，因为合作伙伴 TP 尚未发出接收谓词。 如果发生这种情况，则发送缓冲区可能会填满。
发生以下情况之一时，本地 LU 发送缓冲区中收集的数据将传输到合作伙伴 LU（和合作伙伴 TP）：
发送缓冲区将填满。
本地 TP 发出 FLUSH、 CONFIRM 或 DEALLOCATE （或刷新 LU 发送缓冲区的其他谓词）。