HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs

MC_TEST_RTS_AND_POST and TEST_RTS_AND_POST

• Only one [MC_]TEST_RTS_AND_POST verb per conversation can be active at any time.

How the TP Uses the Verb

To use the [MC_]TEST_RTS_AND_POST verb, the local TP performs the following steps:

Using [MC_]TEST_RTS_AND_POST

1. Issues the [MC_]TEST_RTS_AND_POST verb.

2. Checks the value of the primary return code primary_rc:

• If the primary return code is

AP_OK, the verb is waiting for a REQUEST_TO_SEND notiﬁcation from the

partner TP. While receiving data asynchronously, the local TP can do the following:

• Perform tasks not related to this conversation

• Issue other APPC verbs on this conversation

• Prematurely cancel the [MC_]TEST_RTS_AND_POST verb by issuing one of the following verbs:

• DEALLOCATE with dealloc_type set to AP_ABEND_PROG, AP_ABEND_SVC,or

AP_ABEND_TIMER

• MC_DEALLOCATE with dealloc_type set to AP_ABEND

• SEND_ERROR

• TP_ENDED

• If, however, the primary return code is not

AP_OK, the [MC_]TEST_RTS_AND_POST verb has failed. In

this case, the local TP does not perform Steps 3 and 4.

3. Checks that the callback routine (supplied as a parameter on this verb) has been called by APPC. When a

REQUEST_TO_SEND notiﬁcation is received from the partner TP, APPC calls this routine.

4. Checks the new value of the primary return code primary_rc.

• If the primary return code is

AP_OK, the partner TP has issued [MC_]REQUEST_TO_SEND.

• If the primary return code is not

AP_OK, the application should check the primary_rc and secondary_rc pa-

rameters to determine the action it should take.

Avoiding Indeﬁnite Waits

If the local TP issues the [MC_]TEST_RTS_AND_POST verb and subsequently waits for the callback routine to be

called, it will be suspended until REQUEST_TO_SEND notiﬁcation is received from the partner TP. It could wait

indeﬁnitely if the partner TP does not issue [MC_]REQUEST_TO_SEND. If you need to have the TP operating

continuously, avoid waiting on the callback routine, or use the [MC_]TEST_RTS verb.

248