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

CPI-C Calls
Allocate (cmallc)
Chapter 3126
Allocate (cmallc)
The Allocate call is issued by the invoking program to allocate a
conversation with the partner program, using the current conversation
characteristics. CPI-C can also allocate a session between the local LU
and partner LU if one does not already exist.
The type of conversation allocated is based on the conversation type
characteristic—mapped or basic.
Once the conversation has been allocated by this call, the following
conversation characteristics cannot be changed:
• Conversation type
• Mode name
• Partner LU name
• Partner program name
• Return control
• Synchronization level
• Conversation security
• User ID
• Password
Function Call
void cmallc (
unsigned char CM_PTR conversation_ID,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmallc (
byte[] conversation_ID,
CPICReturnCode return_code
);