MC_SEND_DATA

2025-06-05

MC_SEND_DATA谓词将数据置于本地逻辑单元（LU）发送缓冲区中，以便传输到合作伙伴事务计划（TP）。

以下结构描述了 MC_SEND_DATA 谓词使用的谓词控制块（VCB）。

语法

  
struct mc_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_M_SEND_DATA。

opext
提供的参数。指定谓词作扩展，AP_MAPPED_CONVERSATION。

reserv2
保留字段。

primary_rc
返回的参数。指定 APPC 在谓词完成时设置的主要返回代码。有效的返回代码因发布的 APPC 谓词而异。有关此谓词的有效错误代码，请参阅返回代码。

secondary_rc
返回的参数。指定 APPC 在谓词完成时设置的辅助返回代码。有效的返回代码因发布的 APPC 谓词而异。有关此谓词的有效错误代码，请参阅返回代码。

tp_id
提供的参数。标识本地 TP。

此参数的值由调用 TP 中的 TP_STARTED 或调用的 TP 中的 RECEIVE_ALLOCATE 返回。

conv_id
提供的参数。提供会话标识符。

此参数的值由调用 TP 中的 MC_ALLOCATE 或调用的 TP 中的 RECEIVE_ALLOCATE 返回。

rts_rcvd
返回的参数。提供请求到发送接收的指示器。

AP_YES指示合作伙伴 TP 已发出 MC_REQUEST_TO_SEND，请求本地 TP 将会话更改为 RECEIVE 状态。若要更改为 RECEIVE 状态，本地 TP 可以使用 MC_PREPARE_TO_RECEIVE、 MC_RECEIVE_AND_WAIT或 MC_RECEIVE_AND_POST。
AP_NO表示合作伙伴 TP 尚未发出 MC_REQUEST_TO_SEND。

data_type
提供的参数。指定在支持同步点时要发送的数据的类型。有效参数包括：

AP_APPLICATION

AP_USER_CONTROL_DATA

AP_PS_HEADER

dlen
提供的参数。指定要放入本地 LU 发送缓冲区的数据字节数。范围为 0 到 65535。

dptr
提供的参数。指定要放入本地 LU 发送缓冲区中的数据的缓冲区的地址。

对于 Windows作系统，数据缓冲区可以驻留在静态数据区域或全局分配的区域。数据缓冲区必须完全适合此区域。

类型
提供的参数。允许 TP 在一个 API 调用中发送数据并执行其他函数。例如，可以将 MC_SEND_DATA 与设置为 CONFIRM 的类型 组合在一起，以实现与发出 MC_SEND_DATA 后跟 MC_CONFIRM相同的目标。
AP_SEND_DATA_CONFIRM对应于后跟 MC_CONFIRM MC_SEND_DATA。
AP_SEND_DATA_FLUSH对应于 后跟MC_FLUSHMC_SEND_DATA。
AP_SEND_DATA_DEALLOC_ABEND对应于MC_SEND_DATA，后跟具有AP_ABEND dealloc_type的MC_DEALLOCATE。
AP_SEND_DATA_DEALLOC_FLUSH对应于MC_SEND_DATA，后跟MC_DEALLOCATE AP_FLUSH dealloc_type。
AP_SEND_DATA_DEALLOC_SYNC_LEVEL对应于MC_SEND_DATA，后跟具有AP_SYNC_LEVEL dealloc_type的MC_DEALLOCATE。
AP_SEND_DATA_P_TO_R_FLUSH对应于MC_SEND_DATA，后跟MC_PREPARE_TO_RECEIVE ptr_type AP_FLUSH。
AP_SEND_DATA_P_TO_R_SYNC_LEVEL对应于MC_SEND_DATA，后跟MC_PREPARE_TO_RECEIVE，AP_SYNC_LEVEL的ptr_type和锁设置为AP_SHORT。

返回代码

AP_OK
主要返回代码;已成功执行谓词。

AP_PARAMETER_CHECK
主要返回代码;由于参数错误，谓词未执行。

AP_BAD_CONV_ID

辅助返回代码; conv_id 的值与 APPC 分配的会话标识符不匹配。

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 发出MC_SEND_DATA，但会话未处于 SEND 状态。

AP_ALLOCATION_ERROR
主要返回代码;APPC 未能分配会话。会话状态设置为 RESET。

此代码可以通过 MC_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
主要返回代码;无法在处理谓词时加载或终止所需的组件。因此，无法进行通信。请联系系统管理员以采取纠正措施。

当此返回代码与 MC_ALLOCATE一起使用时，它可能指示找不到任何通信系统来支持本地 LU。（例如，使用 TP_STARTED 指定的本地 LU 别名不正确或尚未配置。请注意，如果 lu_alias 或 mode_name 少于 8 个字符，则必须确保这些字段填充右侧的空格。如果这些参数未填充空格，则返回此错误，因为没有节点可以满足 MC_ALLOCATE 请求。

当MC_ALLOCATE为配置了多个节点的 Microsoft 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 发出 MC_SEND_ERROR。已清除发送但尚未收到的数据。

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
主要返回代码;由于以下原因之一，已解除分配会话：
合作伙伴 TP 发布了MC_DEALLOCATE，dealloc_type设置为AP_ABEND。
合作伙伴 TP 遇到 ABEND，导致合作伙伴 LU 发送 MC_DEALLOCATE 请求。

注解

当 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	收到

MC_SEND_DATA 可能会无限期等待，因为合作伙伴 TP 尚未发出接收谓词。如果发生这种情况，则发送缓冲区可能会填满。

发生以下情况之一时，本地 LU 发送缓冲区中收集的数据将传输到合作伙伴 LU（和合作伙伴 TP）：

发送缓冲区将填满。
本地 TP 问题 MC_FLUSH、 MC_CONFIRM或 MC_DEALLOCATE （或者刷新 LU 发送缓冲区的其他谓词）。

通过

MC_SEND_DATA

语法

成员

返回代码

注解

其他资源