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

CPI-C Calls
Convert_Incoming (cmcnvi)
Chapter 3144
Convert_Incoming (cmcnvi)
For Unix The Convert_Incoming call converts a character string from EBCDIC to
ASCII. If the partner application sends data consisting of EBCDIC
character strings, the local application can use Convert_Incoming to
convert these strings to ASCII. (CPI-C parameters other than the data in
Send_Data and Receive calls, such as mode_name and TP_name , are
always specified in ASCII and do not require conversion.)
Function Call
void cmcnvi (
unsigned char CM_PTR string,
CM_INT32 CM_PTR string_length,
CM_RETURN_CODE CM_PTR return_code
);
Function Call for Java CPI-C
public native void cmcnvi (
byte[] string,
CPICLength string_length,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameters are:
string This is the EBCDIC string to be converted to ASCII.
The CPI-C specification states that the string can
contain any of the following characters (character set
640):
Uppercase A-Z, lowercase a-z, 0–9, the period (.) and
space characters, and the special characters <+(&*
) ; - / , % _ > ? : ' = "
In addition, SNAplus2 CPI-C also accepts the following
characters (which may not be supported by other CPI-C
implementations):