Previous Page Contents Page Next Page

1.4 Sending and Receiving Status with Data

In Confirmation Processing, the invoking TP used the MC_SEND_DATA verb to send data and then the MC_CONFIRM verb to request confirmation from the invoked TP. It is possible to use a parameter on the [MC_]SEND_DATA verb to indicate that APPC should also perform the function of the [MC_]CONFIRM verb (or [MC_]DEALLOCATE, [MC_]FLUSH, or [MC_]PREPARE_TO_RECEIVE) after sending the data, instead of having to issue two separate verbs.

Similarly, the invoked TP in Confirmation Processing issued the MC_RECEIVE_AND_WAIT verb twice, first to receive the data and then to receive the status information that the invoking TP requested confirmation. It is possible to use a parameter on any of the [MC_]RECEIVE verbs to indicate that APPC should return status information about the same receive verb as the data, instead of having to issue two separate receive verbs.

Receiving Status Information with Data shows the use of the send type parameter on MC_SEND_DATA to perform the function of the MC_CONFIRM verb, and the return status with data parameter on MC_RECEIVE_AND_WAIT to receive status information with data. All primary_rc values can be assumed to be AP_OK unless shown otherwise.

Receiving Status Information with Data

Invoking TPFlowInvoked TP
TP_STARTED
MC_ALLOCATE
MC_SEND_DATA (type = AP_SEND_DATA_CONFIRM)
->
RECEIVE_ALLOCATE
MC_RECEIVE_AND_WAIT (rtn_status = NO) (what_rcvd= AP_DATA_COMPLETE)
MC_RECEIVE_AND_WAIT (rtn_status = NO) (what_rcvd = AP_CONFIRM_WHAT_RECEIVED)
MC_CONFIRMED
<-
MC_SEND_DATA (type = AP_NONE)
MC_CONFIRM
->
MC_RECEIVE_AND_WAIT (rtn_status = YES) (what_rcvd = AP_DATA_COMPLETE_CONFIRM)
MC_CONFIRMED
<-
MC_DEALLOCATE
TP_ENDED
->
MC_RECEIVE_AND_WAIT (primary_rc = AP_DEALLOC_NORMAL)
TP_ENDED

1.4.1 Sending Status Information with Data

In Receiving Status Information with Data, the first MC_SEND_DATA verb issued by the invoking TP has a send type of AP_SEND_DATA_CONFIRM. This indicates that APPC should perform the function of the MC_CONFIRM verb after sending the data. Instead of CONFIRM, the [MC_]SEND_DATA verb can also perform the function of [MC_]FLUSH, [MC_]DEALLOCATE, or [MC_]PREPARE_TO_RECEIVE, or can specify (as for the second MC_SEND_DATA verb in the example) that no additional function is to be performed.

1.4.2 Receiving Status Information with Data

In Receiving Status Information with Data, the third MC_RECEIVE_AND_WAIT verb issued by the invoked TP has a rtn_status parameter of AP_YES. This indicates that, if data followed by status information is available, APPC can return the status information about this verb in addition to the data. The verb returns with a what_rcvd parameter of AP_DATA_COMPLETE_CONFIRM , which indicates that the invoking TP sent data and then requested confirmation. The first two MC_RECEIVE_AND_WAIT verbs have the rtn_status parameter set to AP_NO, so APPC does not return status information with the data; the first verb receives the data, and the second receives the status information.

Previous Page Contents Page Top of Page Next page