ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaik_5.4.0.1/rzaikcwbnlgethostccsid.htm

68 lines
3.7 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="cwbNL_GetHostCCSID" />
<meta name="DC.Relation" scheme="URI" content="rzaikconvnlsapis.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1999, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="cwbnl_gethostccsid" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>cwbNL_GetHostCCSID</title>
</head>
<body id="cwbnl_gethostccsid"><a name="cwbnl_gethostccsid"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"><span class="apiname">cwbNL_GetHostCCSID</span></h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4><p>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 <span class="uicontrol">Language</span> tab
of the <span class="keyword">iSeries™ Access Family</span> <span class="uicontrol">Properties</span> dialog.</p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4><pre>
unsigned long CWB_ENTRY cwbNL_GetHostCCSID(
char * system,
unsigned long * CCSID );</pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4><dl><dt class="dlterm">char * system - input</dt>
<dd>The name of the host system. If NULL, the managing system is used.</dd>
<dt class="dlterm">unsigned * CCSID - output</dt>
<dd>Length of the result buffer.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Return Codes</h4><p>The following list shows common return
values.</p>
<dl><dt class="dlterm">CWB_OK</dt>
<dd>Successful completion.</dd>
<dt class="dlterm">CWB_INVALID_POINTER</dt>
<dd>NULL passed on output parameter.</dd>
<dt class="dlterm">CWBNL_DEFAULT_HOST_CCSID_USED</dt>
<dd>Host CCSID 500 is returned</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Usage</h4><p>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.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaikconvnlsapis.htm" title="This topic describes the iSeries Access for Windows conversion NLS APIs.">iSeries Access for Windows conversion NLS APIs list</a></div>
</div>
</div>
</body>
</html>