APPC/MVS provides the following conversation callable services that TPs
use to communicate in conversations. These services apply to both mapped and
basic conversations, as specified on the Conversation_type parameter of the
Allocate service.
- Allocate
- Allocate (start) a conversation with a partner TP.
- Confirm
- Request a confirmation, for example, that the partner has successfully
received data that was sent.
- Confirmed
- Send a confirmation, in response to a request for confirmation.
- Deallocate
- Deallocate (end) a conversation.
- Error_Extract
- Return detailed information about errors indicated by APPC/MVS return
codes.
- Flush
- Flush the LU's data buffer, forcing buffered data to be sent.
- Get_Attributes
- Get attributes of a specified conversation.
- Get_Conversation
- Get the current conversation and its attributes.
- Get_TP_Properties
- Get TP properties (TP name, LU name, user ID, profile).
- Get_Type
- Get the type of conversation (basic or mapped).
- Post_on_Receipt
- Receive asynchronous notification when data or status on particular
conversation becomes available.
- Prepare_to_Receive
- Prepare to receive data (change to Receive state).
- Receive_Immediate
- Receive data immediately, including any buffered data.
- Receive_and_Wait
- Receive and wait for data to arrive.
- Request_to_Send
- Request to send data (change to Send state).
- Send_Data
- Send data to the partner.
- Send_Error
- Send error notification to the partner when the caller detects an error.
- Set_Syncpt_Options
- Change the APPC/MVS defaults that control syncpoint processing for protected
conversations.
For reference information about these services, including syntax and parameter
descriptions, see APPC/MVS TP Conversation Callable Services.
The following sections describe how to use these services in a TP conversation.