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

CPI-C Calls
Set_TP_Name (cmstpn)
Chapter 3 291
Set_TP_Name (cmstpn)
The Set_TP_Name call is issued by the invoking program to specify the
partner program name. This call overrides the partner program name
derived from the side information when the Initialize_Conversation call
was issued. This call cannot be issued after the Allocate call has been
issued. Issuing this call has no effect on the side information itself.
This call functions differently from Specify_Local_TP_Name.
Set_TP_Name is issued by the invoking program, to specify the name of
the program it wants to allocate a conversation with;
Specify_Local_TP_Name is issued by the invoked program, to specify a
name for which it will accept incoming Allocate requests.
Function Call
void cmstpn (
unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR TP_name,
CM_INT32 CM_PTR TP_name_length,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmstpn (
byte[] conversation_ID,
byte[] TP_name,
CPICLength TP_name_length,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameters are:
conversation_ID This is the identifier for the conversation. The value of
this parameter is returned by the
Initialize_Conversation call.