cwbNL_GetHostCCSID

Purpose

Returns the associated CCSID of a given host system or the managing system or the EBCDIC code page character conversion override value, if one is specified on the Language tab of the iSeries™ Access Family Properties dialog.

Syntax

 
unsigned long CWB_ENTRY cwbNL_GetHostCCSID(
                              char * system,
                              unsigned long * CCSID );

Parameters

char * system - input

The name of the host system. If NULL, the managing system is used.

unsigned * CCSID - output

Length of the result buffer.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_POINTER

NULL passed on output parameter.

CWBNL_DEFAULT_HOST_CCSID_USED

Host CCSID 500 is returned

Usage

This API does not make or require an active connection to the host system to retrieve the associated CCSID value. However, it does depend on a prior successful connection to the host system. If no prior successful connection was made to the host system, the API determines the most appropriate associated host CCSID by using an internal mapping table.