118 lines
7.8 KiB
HTML
118 lines
7.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="concept" />
|
||
|
|
<meta name="DC.Title" content="CVTDTA (Convert Data) keyword in printer files" />
|
||
|
|
<meta name="abstract" content="This field-level keyword converts character data to hexadecimal data when the field is passed to the printer." />
|
||
|
|
<meta name="description" content="This field-level keyword converts character data to hexadecimal data when the field is passed to the printer." />
|
||
|
|
<meta name="DC.subject" content="CVTDTA (Convert Data) keyword, Convert Data (CVTDTA) keyword" />
|
||
|
|
<meta name="keywords" content="CVTDTA (Convert Data) keyword, Convert Data (CVTDTA) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmsttrspy.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="rzakdmstptcvtct" />
|
||
|
|
<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>CVTDTA (Convert Data) keyword in printer files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakdmstptcvtct"><a name="rzakdmstptcvtct"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">CVTDTA (Convert Data) keyword in printer files</h1>
|
||
|
|
<div><p>This field-level keyword converts character data to hexadecimal
|
||
|
|
data when the field is passed to the printer.</p>
|
||
|
|
<div class="p">You can use the CVTDTA keyword to define: <ul><li>Logos or emblems for a letterhead on your forms</li>
|
||
|
|
<li>Alternative character sets or symbols (such as a copyright symbol)</li>
|
||
|
|
<li>The appearance of a physical form (by adding vertical and horizontal lines
|
||
|
|
that act as boundaries on the form or between positions on an invoice)</li>
|
||
|
|
<li>IPDS™ bar-code
|
||
|
|
commands</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>This keyword has no parameters.</p>
|
||
|
|
<p>In an SCS printer file (DEVTYPE(*SCS) on the CRTPRTF command), specify
|
||
|
|
CVTDTA only when you use the DFNCHR keyword. Furthermore, use CVTDTA when
|
||
|
|
you define characters for unassigned code points. A <strong>code point</strong> is one
|
||
|
|
of the 256 values that you can assign a character in a character set. An <strong>unassigned
|
||
|
|
code point</strong> is a code point to which no character is assigned. On the <span class="keyword">iSeries™</span> server, a code point is identified
|
||
|
|
by a 2-digit hexadecimal number. For example, in the EBCDIC character set,
|
||
|
|
code point hexadecimal C1 is assigned the character A; hexadecimal 51 is an
|
||
|
|
unassigned code point.</p>
|
||
|
|
<p>CVTDTA is valid for the 5224, 5225, and IPDS printers. For IPDS printers, CVTDTA allows you to specify
|
||
|
|
code points to be included in the data stream. These code points print as
|
||
|
|
preassigned on the printer. Do not use the CVTDTA keyword with the TRNSPY
|
||
|
|
and DFNCHR keywords for IPDS printers.</p>
|
||
|
|
<div class="p">If you define characters for unassigned code points, perform
|
||
|
|
one of the following tasks: <ul><li>Specify CVTDTA</li>
|
||
|
|
<li>Work with hexadecimal data in your program</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>Specify CVTDTA only for named fields. For user-defined characters in constant
|
||
|
|
fields, use the DFT and DFNCHR keywords.</p>
|
||
|
|
<p>In an SCS printer file (DEVTYPE(*SCS) on the CRTPRTF command), if you specify
|
||
|
|
CVTDTA, you must also specify the TRNSPY keyword. In printer files created
|
||
|
|
with DEVTYPE(*IPDS) or DEVTYPE(*AFPDS) on the CRTPRTF command, if you specify
|
||
|
|
CVTDTA, you do not need to specify the TRNSPY keyword. However, a warning
|
||
|
|
message appears stating that the DEVTYPE should not be changed to *SCS.</p>
|
||
|
|
<p>If you specify CVTDTA on a field, the length of the field must be an even
|
||
|
|
number. The printed length of the field is the length you specify, divided
|
||
|
|
by two.</p>
|
||
|
|
<p>If you specify CVTDTA for a field, the character data that your program
|
||
|
|
passes in the field must contain only valid hexadecimal characters (0 through
|
||
|
|
9 and A through F). Blanks, whether embedded or trailing, are not valid hexadecimal
|
||
|
|
characters. If characters that are not valid are specified in the field at
|
||
|
|
program run time, the <span class="keyword"><font color="Purple">i5/OS™</font></span> operating
|
||
|
|
system sends escape message CPF5234 to your program.</p>
|
||
|
|
<p>Option indicators are not valid for this keyword.</p>
|
||
|
|
<div class="p">The following rules apply to using DDS CVTDTA for bar-code commands: <ul><li>The support is only for printers with device type *IPDS.</li>
|
||
|
|
<li>The support allows the following commands: <ul><li>WBCC (Write Bar-Code Control)</li>
|
||
|
|
<li>WBC (Write Bar Code)</li>
|
||
|
|
<li>END</li>
|
||
|
|
</ul>
|
||
|
|
<p>All three commands must be in the same field. No other commands can
|
||
|
|
be in that field.</p>
|
||
|
|
</li>
|
||
|
|
<li>The length of the field must be exact.</li>
|
||
|
|
<li>The length within each command must be exact.</li>
|
||
|
|
<li>Optional - the file can contain a DDS BARCODE keyword
|
||
|
|
on another record in the file. This record does not have to be used. It indicates
|
||
|
|
to the <span class="keyword"><font color="Purple">i5/OS</font></span> operating
|
||
|
|
system that bar codes can be expected when the file is used.</li>
|
||
|
|
<li>Correlation IDs are not required on the IPDS commands.</li>
|
||
|
|
<li>No validity checking is done on the user's bar-code data. Data that is
|
||
|
|
not valid will cause the printer to report that the command is not valid.</li>
|
||
|
|
<li>Examples of the commands are shown in <a href="#rzakdmstptcvtct__barcmd">Figure 1</a>.
|
||
|
|
Add the lengths of these commands in the example totals 69 (45 + 17 + 7 =
|
||
|
|
69). This will be multiplied by two to indicate the number of characters included
|
||
|
|
in the CVTDTA field. This means the field with CVTDTA for this example requires
|
||
|
|
a length of 138 (69 x 2 = 138).</li>
|
||
|
|
<li>See the <cite>Intelligent printer data stream reference</cite> manual
|
||
|
|
for more information about bar-code commands.</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="fignone" id="rzakdmstptcvtct__barcmd"><a name="rzakdmstptcvtct__barcmd"><!-- --></a><span class="figcap">Figure 1. Command format for bar-code commands using CVTDTA
|
||
|
|
(Part 1 of 2)</span><br /><img src="rsll917.gif" alt="Command format for bar-code
commands using CVTDTA" /><br /></div>
|
||
|
|
<div class="fignone"><span class="figcap">Figure 2. Command format for bar-code commands using CVTDTA (Part 2 of 2)</span><br /><img src="rsll918.gif" alt="Command format for bar-code
commands using CVTDTA" /><br /></div>
|
||
|
|
</div>
|
||
|
|
<div>
|
||
|
|
<div class="familylinks">
|
||
|
|
<div class="parentlink"><strong>Parent topic:</strong> <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="rzakdmsttrspy.htm" title="This field-level keyword prevents code points that you have redefined (using the DFNCHR keyword) from being interpreted as SCS printer control commands when your program sends an output operation that prints the field that you are defining.">TRNSPY (Transparency) keyword in printer files</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|