HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

Concepts
A Simple Mapped Conversation
Chapter 138
A Simple Mapped Conversation
The example below charts a simple mapped conversation. It shows the
CPI-C calls used to start the conversation, exchange data, and end it.
The arrow indicates the flow of data. Some call parameters and some
return codes are also shown, enclosed in parentheses.
Starting a Conversation
To start a conversation, the invoking program issues the following calls:
• Initialize_Conversation, which requests CPI-C to set the
characteristics of the conversation.
The Initialize_Conversation call specifies a symbolic destination
name, which is associated with a CPI-C side information entry in the
SNAplus2 configuration. This entry specifies partner program,
partner LU, mode, and security information.
Table 1-2 A Simple Mapped Conversation
Invoking Program Invoked Program
Initialize_Conversati
on
Allocate
Send_Data
Deallocate
→
Accept_Conversation
Receive
( data_received =CM_COMPLETE_DATA_RECEIVED)
( return_code =CM_DEALLOCATED_NORMAL)