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

78 lines
4.1 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_ZonedToASCIIZoned" />
<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_zonedtoasciizoned" />
<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_ZonedToASCIIZoned</title>
</head>
<body id="cwbdt_zonedtoasciizoned"><a name="cwbdt_zonedtoasciizoned"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1"><span class="apiname">cwbDT_ZonedToASCIIZoned</span></h1>
<div><div class="section"><h4 class="sectiontitle">Purpose</h4><p>Translates data from EBCDIC zoned decimal
format to ASCII zoned decimal format. This function can be used for translating
data from the iSeries™ server
for use in ASCII files.</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_ZonedToASCIIZoned(
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 left half-byte (0xf) in the EBCDIC
zoned decimal data will be converted to 0x3 in the left half-byte of the ASCII
zoned decimal data except for the last byte (sign). The high half of the
last byte of the EBCDIC zoned decimal data indicates the sign of the number.
If the high half-byte is 0xb or 0xb then a negative number is indicated,
any other value indicates a positive number. This function checks that the
high half of each byte of EBCDIC zoned decimal data must be 0xf except for
the last byte. The low half of each byte of EBCDIC 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>