gtpc2mah | C/C++ Language Support User's Guide |
This function notifies the remote transaction program that the local TPF transaction program is requesting to enter send state for the conversation. The conversation changes to send state when the local TPF program subsequently receives a SEND indication from the remote program.
Format
#include <tppc.h> void tppc_request_to_send(unsigned int *resid, struct tppc_return_codes *rcode);
Return Codes
The following table contains a list of the primary and secondary return
codes that can be returned to the program that called the
tppc_request_to_send function. A complete list of the return
codes and their definitions can be found in Table 37 and Table 38.
Symbolic Name | Primary Code | Secondary Code |
---|---|---|
LU62RC_OK | 0000 | |
LU62RC_PARAMETER_CHECK | 0001 | |
LU62RC_PK_BAD_TCBID | .... | 00000001 |
LU62RC_PK_BAD_CONVID | .... | 00000002 |
LU62RC_STATE_CHECK | 0002 | |
LU62RC_SKRTSND_BADSTATE | .... | 000000E1 |
LU62RC_TPF_ABEND | FFFF |
Programming Considerations
send
receive
received-confirm
received-confirm-send
received-confirm-deallocate
For the local program to receive permission to send data, the remote program must do one of the following:
Examples
The following example notifies the remote transaction program that the local transaction program is requesting to enter send state for the conversation.
#include <tppc.h> unsigned int resource_id; struct tppc_return_codes return_code;
·
·
·
/* set up resource_id with the value returned from the allocate verb */
·
·
·
tppc_request_to_send(&resource_id,&return_code); /* normal processing path */
·
·
·
Related Information