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

74 lines
3.8 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="cwbDT_ZonedToZoned" />
<meta name="DC.Relation" scheme="URI" content="rzaikdatatransapilist.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="cwbdt_zonedtozoned" />
<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>cwbDT_ZonedToZoned</title>
</head>
<body id="cwbdt_zonedtozoned"><a name="cwbdt_zonedtozoned"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"><span class="apiname">cwbDT_ZonedToZoned</span></h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4><p>Translates data from zoned decimal format
to zoned decimal. This function can be used for translating data from the iSeries™ server
for use in no-conversion files and vice-versa.</p>
</div>
<div class="section"><h4 class="sectiontitle">Unicode version</h4><p>None.</p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4><pre>
unsigned int CWB_ENTRY cwbDT_ZonedToZoned(
char *target,
char *source,
unsigned long length);</pre>
</div>
<div class="section"><h4 class="sectiontitle">Parameters</h4><dl><dt class="dlterm">char * target - output</dt>
<dd>Pointer to the target data.</dd>
<dt class="dlterm">char * source - input</dt>
<dd>Pointer to the source data.</dd>
<dt class="dlterm">unsigned long length - input</dt>
<dd>Number of bytes of source data to translate.</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 pointer was passed by caller.</dd>
<dt class="dlterm">other</dt>
<dd>Offset of the first untranslated character plus one.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Usage</h4><p>The caller must make sure that there is adequate
space to hold the target information. The high half of the last byte of the
zoned data indicates the sign of the number. If the high half-byte is 0xb
or 0xb then a number is indicated, any other value indicates a positive number.
This function checks that the high half of each byte of zoned data must be
0xf except for the last byte. The low half of each byte of zoned data must
be in the range 0-9.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaikdatatransapilist.htm" title="The following data transformation APIs are listed alphabetically.">iSeries Access for Windows data transformation API list</a></div>
</div>
</div>
</body>
</html>