134 lines
7.9 KiB
HTML
134 lines
7.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="IGCANKCNV (Alphanumeric-to-DBCS Conversion) keyword" />
|
|
<meta name="abstract" content="Use this field-level keyword to convert alphanumeric characters to equivalent DBCS characters (Japanese only)." />
|
|
<meta name="description" content="Use this field-level keyword to convert alphanumeric characters to equivalent DBCS characters (Japanese only)." />
|
|
<meta name="DC.subject" content="IGCANKCNV (Alphanumeric-to-DBCS Conversion) keyword, Alphanumeric-to-DBCS Conversion (IGCANKCNV) keyword" />
|
|
<meta name="keywords" content="IGCANKCNV (Alphanumeric-to-DBCS Conversion) keyword, Alphanumeric-to-DBCS Conversion (IGCANKCNV) keyword" />
|
|
<meta name="DC.Relation" scheme="URI" content="prtkwd.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="prtkwd.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstigcfont.htm" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rzakdmstptigcan" />
|
|
<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>IGCANKCNV (Alphanumeric-to-DBCS Conversion) keyword</title>
|
|
</head>
|
|
<body id="rzakdmstptigcan"><a name="rzakdmstptigcan"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">IGCANKCNV (Alphanumeric-to-DBCS Conversion) keyword</h1>
|
|
<div><p>Use this field-level keyword to convert alphanumeric characters
|
|
to equivalent DBCS characters (Japanese only).</p>
|
|
<div class="section"><p>Each DBCS character is printed twice as wide as a printed alphanumeric
|
|
character.</p>
|
|
<p>This keyword has no parameters.</p>
|
|
<p>In addition to converting
|
|
alphanumeric characters, the system adds shift-control characters at the beginning
|
|
and end of converted character strings.</p>
|
|
<p>For example, the string</p>
|
|
<pre>ABCDE</pre>
|
|
<p>appears
|
|
as:</p>
|
|
<pre>0<sub>E</sub>A B C D E0<sub>F</sub></pre>
|
|
<p>after
|
|
it is converted. Note that shift-control characters were added to the string
|
|
(0<sub>E</sub>=shift-out, 0<sub>F</sub>=shift-in).</p>
|
|
<p>You may specify IGCANKCNV
|
|
for any named field.</p>
|
|
<p>Consider the following information
|
|
when using the IGCANKCNV keyword:</p>
|
|
<ul><li>The converted characters are printed according to the instructions specified
|
|
for printing DBCS data, such as expanded characters. For example, if you specify
|
|
the CHRSIZ(2) keyword, the characters converted by this keyword are doubled
|
|
in width.</li>
|
|
<li>This conversion does not affect other attributes of a file. For example,
|
|
if you specify this DDS keyword for a field that contains floating-point data,
|
|
the system leaves the data in the floating-point format. Only the printed
|
|
appearance of the field changes. Also, any other attributes defined for the
|
|
field are still applicable, even those that are not valid for DBCS fields.</li>
|
|
<li>The following DDS keywords are ignored when you specify the keyword IGCANKCNV:
|
|
<p>BLKFOLD<br />
|
|
CPI<br />
|
|
DFT<br />
|
|
IGCALTTYP</p>
|
|
</li>
|
|
</ul>
|
|
<ul><li>The length of the printed string of characters expanded
|
|
by the IGCANKCNV function is at least two times the length of the original
|
|
string plus two positions for the shift-control characters. For example, after
|
|
a string of four Katakana characters is converted, its length is: <pre>10 ((4 characters by 2) + 2 shift-control characters)</pre>
|
|
<p>If you specify additional characters to be included in the string, such as
|
|
with the EDTWRD function, those characters also are expanded and the length
|
|
of the string changes accordingly. For example, suppose you specify
|
|
a 4-position field that also includes a dollar sign and a decimal point, such
|
|
as:</p>
|
|
<pre>$12.34</pre>
|
|
<p>After the field is
|
|
converted, the field length is 14. The four numbers in the field are expanded
|
|
(eight positions), the dollar sign and the decimal point are expanded (four
|
|
positions) and shift-control characters are added (two positions).</p>
|
|
</li>
|
|
<li>The field for which IGCANKCNV is specified should not contain any DBCS
|
|
data. The system does not support conversion of fields with both alphanumeric
|
|
and DBCS data. If a field with IGCANKCNV contains DBCS characters, the results
|
|
of the conversion cannot be predicted.</li>
|
|
<li>The field for which IGCANKCNV is specified cannot be a DBCS-graphic field
|
|
(a field with a data type of G).</li>
|
|
<li>The system replaces unprintable alphanumeric characters before it converts
|
|
them to equivalent DBCS characters as specified by the RPLUNPRT value on the
|
|
Create Printer File (CRTPRTF) command.</li>
|
|
<li>The output must be printed on a DBCS printer.</li>
|
|
<li>A warning message appears if IGCANKCNV is specified in a file created
|
|
with DEVTYPE(*IPDS).</li>
|
|
<li>For files created with DEVTYPE(*AFPDS), characters in the field specified
|
|
with IGCANKCNV are printed using the font identified by the IGCCDEFNT keyword.</li>
|
|
<li>IGCANKCNV cannot be specified on a record or on a field in a record if
|
|
that record also contains COLOR, BARCODE, or LPI.</li>
|
|
<li>Option indicators are not allowed with IGCANKCNV.</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the IGCANKCNV keyword on the DDS coding form.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
00010A*
|
|
00020A*
|
|
00030A R RECORD CHRSIZ(2) SKIPB(3)
|
|
00040A FLDA 400 20SPACEA(2)
|
|
00050A FLDB 80A 20SPACEA(2) CHRISIZ(1)
|
|
00060A FLDC 20A 20SPACEA(2) IGCANKCNV
|
|
A</pre>
|
|
<p>The alphanumeric characters printed from FLDC are converted
|
|
to equivalent DBCS characters. These converted characters are then expanded
|
|
because the record was specified with the DDS keyword CHRSIZ(2).</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="prtkwd.htm" title="Do not use these keywords with DBCS (double-byte character set) data fields (the data type specified in position 35 is O or G).">Keyword considerations for printer files that use double-byte character set</a></div>
|
|
</div>
|
|
<div class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzakdmstprkey.htm" title="See the valid keyword entries for defining printer files in this topic.">Keyword entries for printer files (positions 45 through 80)</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="prtkwd.htm" title="Do not use these keywords with DBCS (double-byte character set) data fields (the data type specified in position 35 is O or G).">Keyword considerations for printer files that use double-byte character set</a></div>
|
|
<div><a href="rzakdmstigcfont.htm" title="Use this record- or field-level keyword to specify the DBCS-coded font for printing a named or constant field or fields.">IGCCDEFNT (DBCS Coded Font) keyword</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |