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

Writing CPI-C Applications

Initial Conversation Characteristics

Chapter 276

Initial Conversation Characteristics

CPI-C maintains a set of internal values, called characteristics, for each

conversation. Some characteristics affect the overall operation of the

conversation, such as the conversation type. Others affect the operation

of speciﬁc calls, such as the receive type.

Many of these characteristics are initially derived from the side

information stored in the SNAplus2 conﬁguration ﬁle; see “Side

Information”. The Initialize_Conversation call speciﬁes the symbolic

destination name (the

sym_dest_name

parameter) associated with the

desired side information table entry.

Table 2-4, Changing Initial Conversation Characteristics, lists the

conversation characteristics, how they are set or changed by the

following conversation start-up calls, and which call can change a given

value.

• Initialize_Conversation

• Accept_Conversation

• Initialize_For_Incoming

• Accept_Incoming

For Unix The calls Initialize_For_Incoming and Accept_Incoming are always used

together. A characteristic is normally set by one of these calls and not

changed by the other.

For Windows The Initialize_For_Incoming and Accept_Incoming calls are not

supported on Windows systems. All references to these calls should be

ignored for Windows systems.

End of Section For a complete explanation of a characteristic, see the description of the

Set_* call associated with it in Chapter 3, “CPI-C Calls.”. For example,

the conversation type is described in the section on the

Set_Conversation_Type call.

Table 2-4 Changing Initial Conversation Characteristics

Conversation State

Initialize_Conversation sets: CM_INITIALIZE_STATE