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

CPI-C Calls
Set_Mode_Name (cmsmn)
Chapter 3268
Set_Mode_Name (cmsmn)
The Set_Mode_Name call is issued by the invoking program to specify
the mode name for a conversation. This call overrides the system-defined
mode name derived from the side information when the
Initialize_Conversation call was issued. This call cannot be issued after
the Allocate has been issued. Issuing this call has no effect on the side
information itself.
Function Call
void cmsmn (
unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR mode_name,
CM_INT32 CM_PTR mode_name_length,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmsmn (
byte[] conversation_ID,
byte[] mode_name,
CPICLength mode_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.
mode_name This parameter specifies the starting address of the
mode name (the name of a set of networking
characteristicsdefined during configuration). The mode
name can contain up to eight ASCII characters. The
following characters are allowed:
• Uppercase letters