Starting a Conversation
- A symbolic destination name—This is used as an index to a CMS communications
directory file that contains information necessary to establish the connection.
Note that the CMS communications directory file is called
side information
by SAA. - The actual target transaction program name or resource ID—Note that the CMS communications directory file is still searched for the specified name. Therefore, this name is used as the transaction program name only if it cannot be resolved using the CMS communications directory.
The Initialize_Conversation routine sets various conversation characteristics from the CMS communications directory file (if available) and sets other conversation characteristics to default values.
- Mode name
- TP name
- Partner LU name
- Conversation security type
- Access security user ID
- Access security password.
The default conversation type is mapped conversations. Mapped conversations allow you to send and receive user data without worrying about APPC logical record formats. However, you can change the conversation type to be a basic conversation. Basic conversations require programs to exchange data in a standardized format.
The default sync_level value is CM_NONE. CM_NONE specifies that the program will not use synchronization routines for the conversation. The sync_level characteristic can be changed to CM_CONFIRM or CM_SYNC_POINT. CM_CONFIRM specifies that the program will perform confirmation processing on the conversation specified. CM_SYNC_POINT specifies that the conversation is to be a protected conversation. This means that Coordinated Resource Recovery (CRR) will coordinate commits (and backouts) of work among multiple protected resources in a distributed application.
For more information on starting a conversation, see Common Programming Interface Communications Reference.