Convert_Incoming - Converting data from code of sender to local code

With the UPIC carrier system on Unix and Linux systems, the Convert_Incoming (CMCNVI) call converts the data form EBCDIC.DF.04.i to ISO8859-i by default.

With the UPIC carrier system on Windows systems, the Convert_Incoming (CMCNVI) call converts the data form EBCDIC.DF.04.F to Windows-1252 by default.

With the UPIC carrier system on BS2000 systems, Convert_Incoming (CMCNVI) converts the data from ISO8859-i to EBCDIC.DF.04.i.

Syntax

CMCNVI (data, length, return_code)

Parameters

<--> data	Address of the data to be converted. The data is then overwritten by the converted data.
--> length	Length of the data to be converted.
<-- return_code	Result of the function call.

Result (return_code)

CM_OK

The call is OK.

State change

This call does not change the program state.

Notes

• The data must be in printable form.

• The relevant conversion table (see chapter Code conversion) can be found at:

  • on Unix, Linux and Windows systems in the file kcsaeea.c under upic-dir or upic-dir\utmcnv.

  • on BS2000 in the file KDCAEEA.C in the library $userid.SYSLIB.UTM-CLIENT.070

Function declaration: Convert_Incoming

CM_ENTRY Convert_Incoming ( unsigned char CM_PTR  string,
                           CM_INT32       CM_PTR  string_length,
                           CM_RETURN_CODE CM_PTR  return_code)