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

CPI-C Calls
Convert_Outgoing (cmcnvo)
Chapter 3 147
Convert_Outgoing (cmcnvo)
For Unix The Convert_Outgoing call converts a character string from ASCII to
EBCDIC. If the partner application requires data consisting of EBCDIC
character strings, the local application can use Convert_Outgoing to
convert data from ASCII to EBCDIC before sending it. (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 cmcnvo (
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 cmcnvo (
byte[] string,
CPICLength string_length,
CPICReturnCode return_code
);
Supplied Parameters
The supplied parameters are:
string This is the ASCII string to be converted to EBCDIC.
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):