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

74 lines
3.9 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_ASCIIZonedToZoned" />
<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_asciizonedtozoned" />
<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_ASCIIZonedToZoned</title>
</head>
<body id="cwbdt_asciizonedtozoned"><a name="cwbdt_asciizonedtozoned"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"><span class="apiname">cwbDT_ASCIIZonedToZoned</span></h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4><p>Translates data from ASCII zoned decimal
format to EBCDIC zoned decimal. This function can be used for translating
data from ASCII files for use on the iSeries™ server.</p>
</div>
<div class="section"><h4 class="sectiontitle">Unicode version</h4><p><span class="apiname">None.</span></p>
</div>
<div class="section"><h4 class="sectiontitle">Syntax</h4><pre>
unsigned int CWB_ENTRY cwbDT_ASCIIZonedToZoned(
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 left half of each byte (0x3) in the ASCII
zoned decimal format will be converted to 0xf in the left half-byte of the
EBCDIC zoned data except for the last byte (sign). This function checks that
the left half of each byte in the ASCII zoned decimal data must be 0x3 except
for the last byte. The high half of the last byte must be 0x3 or 0xb. The
right half of each byte in the ASCII zoned decimal 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>