MC_RECEIVE_AND_POST

MC_RECEIVE_AND_POST谓词异步接收应用程序数据和状态信息。 这样，当数据仍 (LU) 到达本地逻辑单元时，本地事务程序 (TP) 继续处理。

虽然异步 MC_RECEIVE_AND_POST 未完成，但可以在同一会话中发出以下谓词：

• GET_TYPE

• MC_GET_ATTRIBUTES

• MC_REQUEST_TO_SEND

• MC_SEND_ERROR

• MC_TEST_RTS

• TP_ENDED

  这允许应用程序使用异步 MC_RECEIVE_AND_POST 来接收数据。 虽然 MC_RECEIVE_AND_POST 是出色的，但它仍然可以使用 MC_SEND_ERROR 和 REQUEST_TO_SEND。 建议使用此功能进行完全异步支持。 有关 TP 如何接收数据以及如何使用此谓词的信息，请参阅本主题中的备注。

  以下结构描述了MC_RECEIVE_AND_POST谓词使用的谓词控制块 (VCB ) 。

语法

  
struct mc_receive_and_post {  
    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 short      what_rcvd;  
    unsigned char       rtn_status;  
    unsigned char       reserv4;  
    unsigned char       rts_rcvd;  
    unsigned char       reserv5;  
    unsigned short      max_len;  
    unsigned short      dlen;  
    unsigned char FAR * dptr;  
    unsigned char FAR * sema;  
    unsigned char       reserv6;  
};   

成员

opcode
提供的参数。 指定谓词操作代码，AP_M_RECEIVE_AND_POST。

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 返回。

what_rcvd
返回的参数。 指示是否收到数据或会话状态。

• AP_CONFIRM_DEALLOCATE指示合作伙伴 TP 颁发MC_DEALLOCATE，dealloc_type设置为 AP_SYNC_LEVEL。 会话的同步级别由 MC_ALLOCATE 建立，是AP_CONFIRM_SYNC_LEVEL。 收到此值后，本地 TP 通常会发出 MC_CONFIRMED。

• AP_CONFIRM_SEND指示合作伙伴 TP 颁发 MC_PREPARE_TO_RECEIVE，ptr_type 设置为 AP_SYNC_LEVEL。 会话的同步级别由 MC_ALLOCATE 建立，是AP_CONFIRM_SYNC_LEVEL。 收到此值后，本地 TP 通常会发出 MC_CONFIRMED并开始发送数据。

• AP_CONFIRM_WHAT_RECEIVED指示合作伙伴 TP 已 MC_CONFIRM颁发。 收到此值后，本地 TP 通常会发出 MC_CONFIRMED。

• 对于 MC_RECEIVE_AND_POST，AP_DATA_COMPLETE指示本地 TP 已收到完整的数据记录或数据记录的最后一部分。 收到此值后，本地 TP 通常会重新发出 MC_RECEIVE_AND_POST 或发出另一个接收谓词。 如果合作伙伴 TP 发送了更多数据，则本地 TP 将开始接收新的数据单位。 否则，本地 TP 会检查状态信息。

  如果 primary_rc 包含AP_OK， 并且what_rcvd 包含AP_SEND、AP_CONFIRM_SEND、AP_CONFIRM_DEALLOCATE或AP_CONFIRM_WHAT_RECEIVED，请参阅本节中 (值的说明) ，了解本地 TP 通常采取的下一步操作。

  如果primary_rc包含AP_DEALLOC_NORMAL，则会话已解除分配，以响应合作伙伴 TP 发出的 MC_DEALLOCATE 。

• 对于 MC_RECEIVE_AND_POST，AP_DATA_INCOMPLETE指示本地 TP 收到了不完整的数据记录。 如果不是第一个读取记录) 的接收谓词，则 max_len 参数指定的值小于数据记录的长度 (或小于数据记录的其余部分。 收到此值后，本地 TP 通常会重新发出 MC_RECEIVE_AND_POST (或发出另一个接收谓词) 来接收记录的下一部分。

• AP_NONE指示 TP 未收到数据或会话状态指示器。

• 对于合作伙伴 TP，AP_SEND指示会话已进入 RECEIVE 状态。 对于本地 TP，会话现在处于“发送”状态。 收到此值后，本地 TP 通常使用 MC_SEND_DATA 开始发送数据。

  rtn_status
  提供的参数。 指示是否应在一次 API 调用中返回数据和会话状态指示器。

• AP_NO指定应在单独调用谓词时单独返回指示器。

• AP_YES指定应同时返回指示器，前提是两者都可用。 在以下情况下，可以返回两者：

  接收缓冲区足够大，可以保存状态指示器前面的所有数据。

  数据是状态指示器之前的最后一条数据记录。

  rts_rcvd
  返回的参数。 指示合作伙伴 TP 是否 MC_REQUEST_TO_SEND颁发。

• AP_YES指示合作伙伴 TP 已 发出MC_REQUEST_TO_SEND，请求本地 TP 将会话更改为 RECEIVE 状态。

• AP_NO指示合作伙伴 TP 尚未发出 MC_REQUEST_TO_SEND。

  Max_len
  提供的参数。 指定本地 TP 可以接收的最大数据字节数。 范围为 0 到 65535。

  该值不得超过包含接收数据的缓冲区的长度。 dptr 的偏移量加上 max_len 的值不能超过数据段的大小。

  dlen
  返回的参数。 指定接收的数据的字节数。 数据存储在 dptr 指定的缓冲区中。 长度为零表示未收到任何数据。

  dptr
  提供的参数。 提供缓冲区的地址，以包含本地 LU 接收的数据。

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

  对于 OS/2 操作系统，数据缓冲区必须驻留在未命名的共享段上，该段由 DosAllocSeg 函数分配，标志等于 1。 数据缓冲区必须完全适合数据段。

  成武
  提供的参数。 提供异步接收操作完成时 APPC 要清除的信号灯的地址。 sema 参数是通过调用 CreateEvent 或 OpenEvent Win32 函数获取的事件句柄。

返回代码

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

rtn_status AP_YES时，可以返回前面的返回代码或以下返回代码之一。

AP_DATA_COMPLETE_SEND

主返回代码;这是AP_DATA_COMPLETE和AP_SEND的组合。

AP_DATA_COMPLETE_CONFIRM_SEND

主返回代码;这是AP_DATA_COMPLETE和AP_CONFIRM_SEND的组合。

AP_DATA_COMPLETE_CONFIRM

主返回代码;这是AP_DATA_COMPLETE和AP_CONFIRM_WHAT_RECEIVED的组合。

AP_DATA_COMPLETE_CONFIRM_DEALL

主返回代码;这是AP_DATA_COMPLETE和AP_CONFIRM_DEALLOCATE的组合。

AP_DEALLOC_NORMAL
主返回代码;合作伙伴 TP 颁发的MC_DEALLOCATE，dealloc_type设置为 AP_FLUSH 或 AP_SYNC_LEVEL，会话的同步级别指定为 AP_NONE。

如果 AP_YES rtn_status，则还要检查 what_rcvd 。

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

AP_BAD_CONV_ID

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

AP_BAD_TP_ID

辅助返回代码; tp_id 的值与 APPC 分配的 TP 标识符不匹配。

AP_BAD_RETURN_STATUS_WITH_DATA

辅助返回代码;指定的 rtn_status 值未被 APPC 识别。

AP_INVALID_DATA_SEGMENT

辅助返回代码;为数据缓冲区指定的长度长于为包含缓冲区而分配的段。

AP_INVALID_SEMAPHORE_HANDLE

辅助返回代码;RAM 信号量或系统信号量句柄的地址无效。

注意

APPC 无法捕获所有无效信号灯句柄。 如果 TP 传递了错误的 RAM 信号灯句柄，将导致保护冲突。

AP_STATE_CHECK
主要返回代码；谓词未执行，因为它是在无效状态下发出的。

AP_RCV_AND_POST_BAD_STATE

辅助返回代码;当 TP 发出此谓词时，会话未处于 RECEIVE 或 SEND 状态。

AP_RCV_AND_POST_NOT_LL_BDY

辅助返回代码;会话处于 SEND 状态;TP 已开始，但未完成发送逻辑记录。

AP_CANCELED
主返回代码;本地 TP 发出了以下谓词之一，该谓词取消 了MC_RECEIVE_AND_POST：

dealloc_type设置为 AP_ABEND的 MC_DEALLOCATE

MC_SEND_ERROR

TP_ENDED

发出其中一个谓词会导致信号量被清除。

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_CONV_FAILURE_NO_RETRY
  主返回代码;会话因永久条件（例如会话协议错误）而终止。 系统管理员应检查系统错误日志以确定错误原因。 在更正错误之前，不要重试该对话。

  AP_CONV_FAILURE_RETRY
  主返回代码;由于临时错误，会话已终止。 重启 TP 以查看问题是否再次出现。 如果存在，系统管理员应检查错误日志以确定错误原因。

  AP_CONVERSATION_TYPE_MIXED
  主返回代码;TP 已发出基本和映射对话谓词。 在单个会话中只能发出一种类型。

  AP_INVALID_VERB_SEGMENT
  主要返回代码；VCB 超出了数据段的末尾。

  AP_PROG_ERROR_NO_TRUNC
  主返回代码;当会话处于 SEND 状态时，合作伙伴 TP 颁发 了MC_SEND_ERROR 。 数据未被截断。

  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_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 通过以下过程接收数据：

1. 本地 TP 发出接收谓词，直到它完成接收完整的数据单元。 接收的数据是一条数据记录。

   本地 TP 可能需要多次发出接收谓词才能接收完整的数据单元。 收到完整的数据单元后，本地 TP 可以对其进行操作。 接收谓词MC_RECEIVE_AND_POST、MC_RECEIVE_AND_WAIT和MC_RECEIVE_IMMEDIATE。

2. 本地 TP 再次发出接收谓词。 这具有以下效果之一：

   • 如果合作伙伴 TP 发送了更多数据，则本地 TP 开始接收新的数据单元。

   • 如果合作伙伴 TP 已完成发送数据或正在等待确认，则状态信息 (通过 what_rcvd) 指示本地 TP 通常采取的下一个操作。

   以下过程演示本地 TP 使用 MC_RECEIVE_AND_POST 执行的任务。

使用 MC_RECEIVE_AND_POST

1. 对于 Windows 操作系统，TP 通过调用 RegisterWindowMessage API 或分配信号灯来检索 WinAsyncAPPC 消息号。 如果应用程序希望通过 Windows 消息机制收到通知，则 sema 字段应设置为 NULL。

   当本地 TP 完成接收数据时，APPC 发送 Windows 消息或清除信号灯。

   对于 OS/2 操作系统，TP 使用 DosSemSet 函数设置 sema 指向的信号灯。

   当本地 TP 异步接收数据时，信号灯将保持设置。 当本地 TP 完成接收数据时，APPC 将清除信号灯。

2. TP 问题 MC_RECEIVE_AND_POST。

3. TP 检查 primary_rc的值。

   如果 AP_OK primary_rc ，则 dptr) 指向的接收缓冲区 (异步接收来自合作伙伴 TP 的数据。 异步接收数据时，本地 TP 可以：

   • 执行与此会话无关的任务。

   • 问题 MC_REQUEST_TO_SEND。

   • 通过发出 GET_TYPE、 MC_GET_ATTRIBUTES或 MC_TEST_RTS来收集有关此对话的信息。

   • 通过发出dealloc_type设置为 AP_ABEND 的MC_DEALLOCATE提前取消MC_RECEIVE_AND_POST;MC_SEND_ERROR;或TP_ENDED。

     但是，如果未 AP_OK primary_rc ， 则MC_RECEIVE_AND_POST 失败。 在这种情况下，本地 TP 不执行接下来的两个任务。

4. 对于 Windows 操作系统，当 TP 异步接收完数据时，APPC 会发出 WinAsyncAPPC Windows 消息或清除信号灯。

   对于 OS/2 操作系统，TP 使用 DosSemWait 函数等待 APPC 清除 sema 指向的信号灯。 当 TP 异步接收完数据时，APPC 会清除信号灯。 若要防止本地 TP 等待，请让其测试信号灯 (调用 DosSemWait，超时设置为零) 直到 APPC 清除信号灯。

5. TP 检查 primary_rc 的新值。

   如果 AP_OK primary_rc ，则本地 TP 可以检查其他返回的参数并操作异步接收的数据。

   如果未AP_OK primary_rc，则只接收secondary_rc和rts_rcvd (请求发送) 有意义。

   聊天状态效果

   当 TP 发出此谓词时，会话必须处于 RECEIVE 或 SEND 状态。

   在会话处于 SEND 状态时发出 MC_RECEIVE_AND_POST 具有以下效果：

• 本地 LU 将发送缓冲区中的信息和 SEND 指示器发送到伙伴 TP。

• 会话更改为PENDING_POST状态;本地 TP 已准备好从合作伙伴 TP 异步接收信息。

  会话更改状态两次：

• 谓词初始返回后，如果 primary_rc 包含AP_OK，则会话将更改为PENDING_POST状态。

• 完成谓词后，状态会根据以下值而更改：

  primary_rc 参数

  如果AP_OK primary_rc，则为what_rcvd参数

  下表显示了AP_OK primary_rc时与每个 what_rcvd 值关联的新状态。

what_rcvd	新状态
AP_CONFIRM_DEALLOCATE	CONFIRM_DEALLOCATE
AP_DATA_COMPLETE_CONFIRM_DEALL	CONFIRM_DEALLOCATE
AP_DATA_CONFIRM_DEALLOCATE	CONFIRM_DEALLOCATE
AP_CONFIRM_SEND	CONFIRM_SEND
AP_DATA_COMPLETE_CONFIRM_SEND	CONFIRM_SEND
AP_DATA_CONFIRM_SEND	CONFIRM_SEND
AP_CONFIRM_WHAT_RECEIVED	确认
AP_DATA_COMPLETE_CONFIRM	确认
AP_DATA_CONFIRM	确认
AP_DATA	RECEIVE
AP_DATA_COMPLETE	RECEIVE
AP_DATA_INCOMPLETE	RECEIVE
AP_SEND	SEND
AP_DATA_COMPLETE_SEND	SEND_PENDING

下表显示了与除AP_OK以外的每个 primary_rc 值关联的新状态。

primary_rc	新状态
AP_CANCELED	没有变化
AP_CONV_FAILURE_RETRY	RESET
AP_CONV_FAILURE_NO_RETRY	RESET
AP_DEALLOC_ABEND	RESET
AP_DEALLOC_ABEND_PROG	RESET
AP_DEALLOC_ABEND_SVC	RESET
AP_DEALLOC_ABEND_TIMER	RESET
AP_DEALLOC_NORMAL	RESET
AP_PROG_ERROR_PURGING	RECEIVE
AP_PROG_ERROR_NO_TRUNC	RECEIVE
AP_SVC_ERROR_PURGING	RECEIVE
AP_SVC_ERROR_NO_TRUNC	RECEIVE
AP_PROG_ERROR_TRUNC	RECEIVE
AP_SVC_ERROR_TRUNC	RECEIVE