[MC_]TEST_RTS_AND_POST

The [MC_]TEST_RTS_AND_POST verb asynchronously determines whether a request-to-send notification has been received from the partner transaction program. A transaction program can issue a [MC_]TEST_RTS_AND_POST at any time, even when there is another verb outstanding on the conversation. [MC_]TEST_RTS_AND_POST returns when a request-to-send notification is received, or when the conversation ends, or when a conversation failure is detected.

This verb can only be issued through the APPC entry point.

VCB Structure

typedef struct test_rts_and_post
{
 unsigned short      opcode;               /* verb operation code     */
 unsigned char       opext;                /* verb extension code     */
 unsigned char       format;               /* format                  */
 unsigned short      primary_rc;           /* primary return code     */
 unsigned long       secondary_rc;         /* secondary return code   */
 unsigned char       tp_id[8];             /* TP identifier           */
 unsigned long       conv_id;              /* conversation identifier */
 unsigned char       reserv3;              /* reserved                */
 unsigned long       sema;                 /* post handle for verb    */
} TEST_RTS_AND_POST;
typedef struct mc_test_rts_and_post
{
 unsigned short    opcode;             /* verb operation code     */
 unsigned char     opext;              /* verb extension code     */
 unsigned char     format;             /* format                  */
 unsigned short    primary_rc;         /* primary return code     */
 unsigned long     secondary_rc;       /* secondary return code   */
 unsigned char     tp_id[8];           /* TP identifier           */
 unsigned long     conv_id;            /* conversation identifier */
 unsigned char     reserv3;            /* reserved                */
 unsigned long     sema;               /* post handle for verb    */
} MC_TEST_RTS_AND_POST;

Supplied Parameters

The transaction program supplies the following parameters to Personal Communications:
opcode
AP_B_TEST_RTS_AND_POST
Displays a basic verb icon.
AP_M_TEST_RTS_AND_POST
Displays a mapped verb icon.
opext
AP_BASIC_CONVERSATION or AP_MAPPED_CONVERSATION
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
tp_id
Identifier for the local transaction program.

The value of this parameter was returned by the TP_STARTED verb in the invoking transaction program or by RECEIVE_ALLOCATE in the invoked transaction program.

conv_id
Conversation identifier.

The value of this parameter was returned by the [MC_]ALLOCATE verb in the invoking transaction program or by RECEIVE_ALLOCATE in the invoked transaction program.

sema
Handle of the event that the application will wait on. This verb is intended for use with WaitForMultipleObjects in the Win32® API. For more information about this function, see the programming documentation for the Win32® API.

Returned Parameters

If the verb executes successfully (that is, a request-to-send notification is received), Personal Communications return the following parameter:
primary_rc
AP_OK
If the verb returns because the conversation has ended or a conversation failure has been detected, Personal Communications returns the following parameter:
primary_rc
AP_UNSUCCESSFUL
If the verb does not execute because of a parameter error, Personal Communications returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_BAD_CONV_ID

AP_BAD_TP_ID
AP_TEST_INVALID_FOR_FDX

The conditions generating the following possible primary return codes (primary_rc) are described in APPC Common Return Codes.

AP_CONVERSATION_TYPE_MIXED
AP_UNEXPECTED_SYSTEM_ERROR
AP_CANCELLED