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

CPI-C Calls

Extract_Mode_Name (cmemn)

Chapter 3 177

Extract_Mode_Name (cmemn)

The Extract_Mode_Name call returns the mode name and mode name

length for a speciﬁed conversation.

Function Call

void cmemn (

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 cmemn (

byte[] conversation_ID,

byte[] mode_name,

CPICLength mode_name_length,

CPICReturnCode return_code

);

Supplied Parameters

The supplied parameter is:

conversation_ID

This is the identiﬁer for the conversation. The value of

this parameter was returned by the

Initialize_Conversation, Initialize_For_Incoming, or

Accept_Conversation call.

Returned Parameters

After the verb executes, SNAplus2 returns parameters to indicate

whether the execution was successful and, if not, to indicate the reason

the execution was unsuccessful.

mode_name

This parameter speciﬁes the starting address of the

mode name.