__toCSName() — Convert coded character set ID to codeset name

Standards

Standards / Extensions	C or C++	Dependencies
z/OS® UNIX	both	z/OS V1R2

#include <_Ccsid.h>

int __toCSName(__ccsid_t Ccsid, char *codesetName);

The __toCSName() function returns the codeset name, corresponding to coded character codeset ID, Ccsid, in codesetName.

If successful, __toCSName() returns 0 and stores the codeset name in codesetName, when a corresponding codeset name exists for Ccsid.

If unsuccessful, __toCSName() returns -1.

If __toCSName() returns -1 for a reason other than no corresponding codeset name exists, it sets errno to one of the following values:

Error Code: Description
EINVAL: The corresponding codesetName length is greater than _CSNAME_LEN_MAX as defined in header <_Ccsid.h>.