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

CPI-C Calls
Extract_Maximum_Buffer_Size (cmembs)
Chapter 3 175
Extract_Maximum_Buffer_Size (cmembs)
For Unix The Extract_Maximum_Buffer_Size call returns the maximum size of a
CPI-C data buffer. This defines the maximum amount of data that can be
sent in one Send_Data call or received in one Receive call.
SNAplus2 CPI-C (including previous versions) always uses a data buffer
size of 32,767 bytes. However, for compatibility with other CPI-C
implementations (or with future versions of SNAplus2), an application
should not rely on this value, and should use this call to determine the
largest buffer size it can use.
Function Call
void cmembs (
CM_INT32 CM_PTR maximum_buffer_size,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmembs (
CPICLength maximum_bufer_size,
CPICReturnCode return_code
);
Supplied Parameters
There are no supplied parameters for this 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.
maximum_buffer_size This parameter specifies the length of the data
buffer.
return_code Possible values are:
CM_OK The call executed successfully.