HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs

MC_TEST_RTS_AND_POST and TEST_RTS_AND_POST

APPC does not return secondary return codes with these primary return codes.

4.19.7 State When Issued

The conversation can be in any state except Reset when the TP issues this verb.

4.19.8 State Change

The conversation state does not change for this verb.

4.20 MC_TEST_RTS_AND_POST and TEST_RTS_AND_POST

The MC_TEST_RTS_AND_POST or TEST_RTS_AND_POST verb informs the application when a RE-

QUEST_TO_SEND notiﬁcation has been received from the partner TP.

Note

This verb can be used only in a half-duplex conversation; it is not valid in a full-duplex

conversation.

Normally, if the partner TP issues an [MC_]REQUEST_TO_SEND verb, the local TP will be notiﬁed of this by

the rts_rcvd parameter on a subsequent verb (this is a received parameter on a number of verbs), or by a successful

return code on the [MC_]TEST_RTS verb. The [MC_]TEST_RTS_AND_POST verb enables the local TP to receive

the REQUEST_TO_SEND notiﬁcation asynchronously when it arrives, instead of having to issue verbs repeatedly

to obtain the notiﬁcation.

WINDOWS

[MC_]TEST_RTS_AND_POST is supported on Win32 systems, but not on Win16 systems.

4.20.1 VCB Structure: MC_TEST_RTS_AND_POST

UNIX

The deﬁnition of the VCB structure for the MC_TEST_RTS_AND_POST verb is as follows:

typedef struct mc_test_rts_and_post

{

AP_UINT16 opcode;

unsigned char opext;

unsigned char format; /* Reserved */

AP_UINT16 primary_rc;

AP_UINT32 secondary_rc;

unsigned char tp_id[8];

AP_UINT32 conv_id;

void (*callback)();

unsigned char reserv3;

242