Convert_Outgoing - Converting data from local code to code of receiver

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

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

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

Syntax

CMCNVO (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 which are 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:

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

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

Function declaration: Convert_Outgoing

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