ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakd_5.4.0.1/rzakdmstptbarco.htm

676 lines
42 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="BARCODE (Bar Code) keyword in printer files" />
<meta name="abstract" content="Use this field-level keyword to print a field as a user-specified bar code. BARCODE is valid only for Intelligent Printer Data Stream (IPDS) printers and only for printer files with device type *IPDS or *AFPDS specified." />
<meta name="description" content="Use this field-level keyword to print a field as a user-specified bar code. BARCODE is valid only for Intelligent Printer Data Stream (IPDS) printers and only for printer files with device type *IPDS or *AFPDS specified." />
<meta name="DC.subject" content="BARCODE (Bar Code) keyword" />
<meta name="keywords" content="BARCODE (Bar Code) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
<meta name="DC.Relation" scheme="URI" content="../dds/rbafpmstsyntax.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="rzakdmstptbarco" />
<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>BARCODE (Bar Code) keyword in printer files</title>
</head>
<body id="rzakdmstptbarco"><a name="rzakdmstptbarco"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">BARCODE (Bar Code) keyword in printer files</h1>
<div><p>Use this field-level keyword to print a field as a user-specified
bar code. BARCODE is valid only for Intelligent Printer
Data Stream™ (IPDS™) printers and only for printer files with device
type *IPDS or *AFPDS specified.</p>
<div class="p">The format of the keyword is: <pre>BARCODE(bar-code-ID [height] [[*HRZ | *VRT]
[*HRI | *HRITOP | *NOHRI] [*AST | *NOAST]
[modifier] [unit-width]
[wide/narrow-ratio]
[PDF417 data]
[Data Matrix data]
[Maxicode data]])</pre>
</div>
<p>The bar-code-ID parameter is required. You can specify
the bar-code-ID parameter as a special alphanumeric value up to 10 characters
long, or as a numeric ID. Valid special values for the bar-code ID are listed
in <a href="#rzakdmstptbarco__zbarcode">Table 1</a>. If you specify a numeric
value for the bar-code ID, then you also must specify the bar-code modifier
parameter. See the documentation for your printer for the bar-code IDs and
modifiers that it supports.</p>
<div class="p">The height parameter is optional, but if you specify it, it must be the
second parameter following the keyword. You can specify the height in one
of two ways: <ul><li>Specify the height in number of print lines. Valid values for the bar-code
height are 1 through 9 lines.</li>
<li><img src="./delta.gif" alt="Start of change" />Specify the height in inches or centimeters. When you specify
the height in this way, the valid format is <samp class="codeph">(height *UOM)</samp>.
Valid values are 0.25 to 25.40 cm (0.10 to 10.00 inches). For PDF417 bar-code
type, valid values are 0.02 to 25.40 cm (0.01 to 10.00 inches). The UOM parameter
on the Create Printer File (CRTPRTF) command determines the unit of measure
for the height.<img src="./deltaend.gif" alt="End of change" /></li>
</ul>
</div>
<p>The value you specify for the bar-code height does not include the human
readable interpretation below the bar code. If you do not specify the height
parameter, the printer uses a default height.</p>
<p>You can specify the last 9 parameters (all optional) in any order. Using
these parameters, you can specify that BARCODE: </p>
<ul><li>Print the bar code horizontally or vertically. The default is horizontal
printing (*HRZ).</li>
<li>Include or exclude the human readable interpretation of the bar code.
The default is to include the human readable interpretation printed at the
bottom of the bar code (*HRI).</li>
<li>Indicate that the human readable interpretation should be printed at the
top (*HRITOP) of the bar code. (Check individual printer manuals for different
bar code support of *HRITOP.)</li>
<li>Include or exclude asterisks around the human readable interpretation
for CODE3OF9 barcodes. The default is to exclude the asterisks (*NOAST).</li>
<li>Select the bar-code modifier. This is a 1-character hexadecimal value
that cannot be hex FF.</li>
<li>Specify the width (in inches) of the narrow bar/space. It is specified
as an expression of the form (*WIDTH value). For more information about how
to specify expressions, in the DDS Concepts information. The valid values
for the parameter are 0.007 through 0.208.</li>
<li>Specify the ratio of the wide bar/space to the narrow bar/space. It is
specified as an expression of the form: (*RATIO value). The valid values for
the parameter are 2.00 through 3.00.</li>
<li>Specify additional barcode information for the two-dimensional barcodes
PDF417, Maxicode, and Data Matrix. You can specify only one of these barcodes.
See <a href="#rzakdmstptbarco__twodbar">Specify two-dimensional barcodes</a> for
more information.</li>
</ul>
<div class="note"><span class="notetitle">Note:</span> The overall barcode width is dependent on: <ul><li>Ratio or width parameter in user DDS.</li>
<li>Actual customer data in the barcode.</li>
<li>Limitations of printer hardware, such as PEL density, pins and so on.</li>
</ul>
</div>
<p>The width and ratio parameters are ignored for the 4234 and 4224 printer
models.</p>
<p>For more information about the 4224 printer models, see the <cite>4224
Printer Models 1xx and 2xx Product and Programming Descriptions</cite>, GC31-2551.</p>
<p>If you specify an optional parameter that does not apply to the bar-code
ID you have specified, the printer ignores the optional parameter.</p>
<p>If you attempt to print a bar code on a printer that does
not support bar codes, the digits in the code are treated as text, and a diagnostic
message results in stating that the bar code might not print.</p>
<p>The line and position you specify for the field is used as the upper left
corner of the bar code. Because the line specified in the DDS is the base
line (the imaginary line on which characters are printed) and this is used
as the upper edge of the bar code, the bar code appears to extend down from
the bottom of the line you specify.</p>
<p>The following table describes valid data types, field lengths, and the
numeric IDs for the BARCODE field.</p>
<div class="tablenoborder"><a name="rzakdmstptbarco__zbarcode"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzakdmstptbarco__zbarcode" width="100%" frame="border" border="1" rules="all"><caption>Table 1. Valid bar-code definitions</caption><thead align="left"><tr><th align="left" valign="bottom" width="25%" id="d0e101">Bar Code ID</th>
<th align="left" valign="bottom" width="25%" id="d0e103">Data type</th>
<th align="left" valign="bottom" width="25%" id="d0e105">Field length</th>
<th valign="top" width="25%" id="d0e107">Numeric ID</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="25%" headers="d0e101 ">MSI</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 31</td>
<td valign="top" width="25%" headers="d0e107 ">2</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">UPCA</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">11</td>
<td valign="top" width="25%" headers="d0e107 ">3</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">UPCE</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">10</td>
<td valign="top" width="25%" headers="d0e107 ">5</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">UPC2</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">2</td>
<td valign="top" width="25%" headers="d0e107 ">6</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">UPC5</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">5</td>
<td valign="top" width="25%" headers="d0e107 ">7</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">EAN8</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">7</td>
<td valign="top" width="25%" headers="d0e107 ">8</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">EAN13</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">12</td>
<td valign="top" width="25%" headers="d0e107 ">9</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">EAN2</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">2</td>
<td valign="top" width="25%" headers="d0e107 ">22</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">EAN5</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">5</td>
<td valign="top" width="25%" headers="d0e107 ">23</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">CODEABAR</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 50</td>
<td valign="top" width="25%" headers="d0e107 ">13</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">CODE128</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 50</td>
<td valign="top" width="25%" headers="d0e107 ">17</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">CODE3OF9</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 50</td>
<td valign="top" width="25%" headers="d0e107 ">1</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">INTERL2OF5</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 31</td>
<td valign="top" width="25%" headers="d0e107 ">12</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">INDUST2OF5</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 31</td>
<td valign="top" width="25%" headers="d0e107 ">10</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">MATRIX2OF5</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 31</td>
<td valign="top" width="25%" headers="d0e107 ">11</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">POSTNET</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 31</td>
<td valign="top" width="25%" headers="d0e107 ">24</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">POSTNET (PLANET) <sup>5</sup></td>
<td align="left" valign="top" width="25%" headers="d0e103 ">S</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 31</td>
<td valign="top" width="25%" headers="d0e107 ">24</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">RM4SCC</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 50</td>
<td valign="top" width="25%" headers="d0e107 ">26</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e101 ">AP4SCC</td>
<td valign="top" width="25%" headers="d0e103 ">A</td>
<td valign="top" width="25%" headers="d0e105 ">8 through 39</td>
<td valign="top" width="25%" headers="d0e107 ">31</td>
</tr>
<tr><td valign="top" width="25%" headers="d0e101 ">DUTCHKIX</td>
<td valign="top" width="25%" headers="d0e103 ">A</td>
<td valign="top" width="25%" headers="d0e105 ">1 through 50</td>
<td valign="top" width="25%" headers="d0e107 ">26</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">JPBC</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">7 through 50</td>
<td valign="top" width="25%" headers="d0e107 ">27</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">PDF417</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 1850</td>
<td valign="top" width="25%" headers="d0e107 ">30</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">MAXICODE</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 138</td>
<td valign="top" width="25%" headers="d0e107 ">29</td>
</tr>
<tr><td align="left" valign="top" width="25%" headers="d0e101 ">DATAMATRIX</td>
<td align="left" valign="top" width="25%" headers="d0e103 ">A</td>
<td align="left" valign="top" width="25%" headers="d0e105 ">1 through 3116</td>
<td valign="top" width="25%" headers="d0e107 ">28</td>
</tr>
</tbody>
</table>
</div>
<p>The following table describes the supported bar codes.</p>
<div class="tablenoborder"><a name="rzakdmstptbarco__tbar"><!-- --></a><table cellpadding="4" cellspacing="0" summary="" id="rzakdmstptbarco__tbar" width="100%" frame="border" border="1" rules="all"><caption>Table 2. Bar codes supported by
DDS</caption><thead align="left"><tr><th align="left" valign="bottom" width="20.2020202020202%" id="d0e342">BARCODE</th>
<th align="left" valign="bottom" width="15.151515151515152%" id="d0e344">Digits per code</th>
<th align="left" valign="bottom" width="19.94949494949495%" id="d0e346">Range of characters allowed</th>
<th align="left" valign="bottom" width="15.404040404040403%" id="d0e348">Default bar code modifier generated</th>
<th align="left" valign="bottom" width="15.151515151515152%" id="d0e350">Default bar code modifier printed</th>
<th align="left" valign="bottom" width="14.14141414141414%" id="d0e352">Valid bar code modifier</th>
</tr>
</thead>
<tbody><tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">MSI (changed Plessey)</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">31<sup>1</sup></td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">2 Modulus 10</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">01 through 09</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">UPC-A</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">11</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">UPC-E</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">10</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">UPC-2 digit add on (must follow a UPC A or
E bar code)</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">2</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">UPC-5 digit add on (must follow a UPC A or
E bar code)</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">5</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">EAN-8</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">7</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">EAN-13</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">12</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">EAN-2 digit add on (must follow an EAN 8
or 13 bar code)</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">2</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">EAN-5 digit add on (must follow an EAN 8
or 13 bar code)</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">5</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">INDUST2OF5 or industrial 2 of 5</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">31</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">01 02</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">MATRIX2OF5 or matrix 2 of 5</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">31</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">01 02</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">INTERL2OF5 or interleaved 2 of 5</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">31</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">01 02</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">CODEABAR</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 50 characters</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 "> <p>0 through 9,<br />
A through D<br />
(begin/end only),<br />
-, ., $, /, +, and :</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">01 02</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">CODE128</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 50 characters</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">Refer to <a href="code128.htm#code128">CODE128 character set in DDS</a></td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">01<sup>2</sup> 02</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">CODE3OF9 or code 3 of 9</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 50 characters</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 "> <p>0 through 9,<br />
A through Z<br />
(upper case only),<br />
-, ., $, /, +, %,<br />
and a blank</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">01 02</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">POSTNET</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 31 characters</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">Ignored</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">POSTNET (PLANET)<sup>5</sup></td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 31 characters</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">04</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">RM4SCC</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 50 characters</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 "> <p>0 through 9<br />
A through Z</p>
</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td valign="top" width="20.2020202020202%" headers="d0e342 ">AP4SCC</td>
<td valign="top" width="15.151515151515152%" headers="d0e344 ">13 through 39</td>
<td valign="top" width="19.94949494949495%" headers="d0e346 "> <p>0 through 9<br />
A through Z<br />
a through z<br />
space, #</p>
</td>
<td valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td valign="top" width="14.14141414141414%" headers="d0e352 ">01 through 08</td>
</tr>
<tr><td valign="top" width="20.2020202020202%" headers="d0e342 ">DUTCHKIX</td>
<td valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 50 characters</td>
<td valign="top" width="19.94949494949495%" headers="d0e346 "> <p>0 through 9<br />
A through Z<br />
a through z</p>
</td>
<td valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td valign="top" width="14.14141414141414%" headers="d0e352 ">01</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">JPBC</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 50 characters</td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">0 through 9, A through Z, and -</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">1</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">Yes</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00 01<sup>3</sup></td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">PDF417</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 1850 characters <sup>4</sup></td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">Any one-byte character</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00 01</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">MAXICODE</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 138 characters <sup>4</sup></td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">Any one-byte character</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td align="left" valign="top" width="20.2020202020202%" headers="d0e342 ">DATAMATRIX</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e344 ">Up to 3116 characters <sup>4</sup></td>
<td align="left" valign="top" width="19.94949494949495%" headers="d0e346 ">Any one-byte character</td>
<td align="left" valign="top" width="15.404040404040403%" headers="d0e348 ">No</td>
<td align="left" valign="top" width="15.151515151515152%" headers="d0e350 ">No</td>
<td align="left" valign="top" width="14.14141414141414%" headers="d0e352 ">00</td>
</tr>
<tr><td colspan="6" align="left" valign="top" headers="d0e342 d0e344 d0e346 d0e348 d0e350 d0e352 "> <div class="note"><span class="notetitle">Notes:</span> <ol><li>The 4234 Printer only supports 14 digits.</li>
<li>The value 01 for the bar code modifier is not valid for some printers.</li>
<li>The value 01 provides migration support for application programs that
use an AFP™ font
to print Japan Postal Bar Codes. Data written into the field must be valid
characters in the AFP font. The application program must also write the
start, stop, and bar code modifier characters.</li>
<li>For PDF417, up to 1850 text characters, or 1108 bytes of binary data,
per symbol, depending on the security level; refer to the symbology specification.
For Maxicode, up to 93 alphanumeric characters per symbol, depending on the
encoding overhead, or up to 138 numeric characters per symbol; refer to the
symbology specification. For Data Matrix, up to 3116, depending on whether
the data is character or numeric; refer to the symbology specification.</li>
<li>The PLANET bar code is selected by specifying the POSTNET bar-code-id
and a bar code modifier of 04.</li>
</ol>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<p>CODEABAR field data must begin with an A, B, C, or D and must end with
an A, B, C, or D. For example, A11224455C or D33447799D.</p>
<p>Do not specify BARCODE in the same field with the CHRSIZ, CHRID, CVTDTA,
DATE, EDTCDE, EDTWRD, FONT, HIGHLIGHT, PAGNBR, TIME, or UNDERLINE keywords.</p>
<p>See the CVTDTA keyword for information about coding IPDS bar code commands.</p>
<p>If you specify CHRSIZ at the record level, it applies to all fields in
that record. If you specify BARCODE in one of those fields, the BARCODE keyword
is not allowed.</p>
<p>You cannot specify BARCODE on the same record format with BLKFOLD, CPI,
or DFNCHR.</p>
<p>When you specify BARCODE on a numeric field, the number of decimal positions
must be zero.</p>
<p>When you specify BARCODE on a constant field, the only valid bar code IDs
are CODEABAR, CODE128, and CODE3OF9, and you must also specify the DFT keyword
either implicitly or explicitly.</p>
<p>You should specify DEVTYPE (*IPDS) or DEVTYPE(*AFPDS) on the CRTPRTF command
when BARCODE is specified in the file.</p>
<p>BARCODE is allowed only on data types S and A (see <a href="#rzakdmstptbarco__tbar">Table 2</a> for
restrictions).</p>
<p>Option indicators are not valid for this keyword.</p>
<p>Japan Postal Bar Codes (bar-code-ID = JPBC) uses only the bar-code-ID parameter,
the bar code print orientation parameter ([*HRZ | *VRT]), and the bar code
modifier parameter. All other parameters have predetermined values, so any
input for them is ignored.</p>
<p>User-specified bar code modifiers are not checked for their
validity, and might cause bar code errors if they are not valid. The <cite>Intelligent
Printer Data Stream™ Reference</cite> manual contains more information
about bar codes and valid bar code modifiers.</p>
<div class="section" id="rzakdmstptbarco__twodbar"><a name="rzakdmstptbarco__twodbar"><!-- --></a><h4 class="sectiontitle">Specify two-dimensional barcodes</h4><p>You
can specify additional parameters for the two-dimensional barcodes PDF417,
Maxicode, and Data Matrix.</p>
<div class="p"><strong>PDF417:</strong> The additional data is specified
as an expression of the form: <pre>(*PDF417 row-size number-rows security
[escape-indicator] [*MACRO(&amp;data-field-name)])</pre>
</div>
<dl><dt class="dlterm">row-size</dt>
<dd>This required parameter for PDF417 barcode specifies the number of data
symbol characters per row. Valid values are in the range of 1 through 30.</dd>
<dt class="dlterm">number-rows</dt>
<dd>This required parameter for PDF417 barcode specifies the number of rows.
Valid values are in the range of 3 through 90. You can specify a special value
of *MIN (minimum) to instruct the printer to generate the minimum number of
rows that are necessary.</dd>
<dt class="dlterm">security</dt>
<dd>This required parameter for PDF417 barcode specifies the security level.
Valid values are in the range of 0 through 8. Each higher security level causes
more error correction code words to be added to the symbol. At a particular
security level, a number of code words can be missing or erased, and the symbol
can still be recovered.</dd>
<dt class="dlterm">escape-indicator</dt>
<dd>This optional parameter for PDF417 barcode specifies whether the backslash
character within the barcode data is treated as an escape character according
to the PDF417 symbology specification. Escape characters (started with backslash)
allow reader programming to be specified within the barcode data. Valid values
for the escape-indicator are: <ul><li>*NOESCAPE indicates that each backslash character found in the barcode
data is treated as a normal data character and therefore all escape sequences
are ignored. Specify *NOESCAPE if the barcode data is an image or binary data.
*NOESCAPE is the default value if no escape indicator is specified.</li>
<li>*ESCAPE indicates that each backslash character found in the barcode data
is treated as an escape character according to the PDF417 symbology specification.</li>
</ul>
</dd>
<dt class="dlterm">*MACRO(&amp;data-field-name)</dt>
<dd>This optional parameter allows PDF417 Control Block coding to be specified
(as defined in section G.2 of the Uniform Symbology Specification PDF417).
The macro-data must be specified as a program-to-system field. The field must
exist in the same record format as the BARCODE keyword. The length of the
macro data is limited by the rules for a record format; that is, the maximum
combined length of all named fields and indicators in a record format is 32
767 bytes. The data type must be A (character), and usage P (program-to-system).</dd>
</dl>
<div class="p"><strong>Maxicode:</strong> The additional data is specified as an
expression of the form: <pre>(*MAXICODE symbol-mode [zipper-indicator] [sequence-data])</pre>
</div>
<dl><dt class="dlterm">symbol-mode</dt>
<dd>This required parameter for Maxicode barcode specifies the symbol-mode
for the MaxiCode barcode. Valid values are in the range of 2 through 6: <ul><li>2 Structured Carrier Message, numeric postal code</li>
<li>3 Structured Carrier Message, alphanumeric postal code</li>
<li>4 Standard code</li>
<li>5 Full ECC symbol</li>
<li>6 Reader program, SEC. No data is transmitted.</li>
</ul>
</dd>
<dt class="dlterm">zipper-indicator</dt>
<dd>This optional parameter for Maxicode barcode specifies whether to print
a zipper pattern and contrast block. The valid values for the zipper-indicator
are: <ul><li>*NOZIPPER indicates that a zipper pattern is not to be printed with the
barcode. *NOZIPPER is the default value if no zipper-indicator is specified.</li>
<li>*ZIPPER indicates that a zipper pattern is to be printed with the barcode.</li>
</ul>
</dd>
<dt class="dlterm">sequence-indicator</dt>
<dd>This optional parameter for Maxicode barcode specifies whether this barcode
is part of a structured append. The Maxicode barcode can be logically linked
together to encode large amounts of data. The logically linked symbols can
be presented on the same or different media and are logically recombined after
they are scanned. The sequence data for the Maxicode consists of two parts
of the following form: <pre>*SEQUENCE(sequence-indicator total-symbols)</pre>
<p><em>sequence-indicator</em> specifies
the structured append sequence indicator. Valid values are 0 - 8.</p>
<p><em>total-symbols</em> specifies
the total number of structured append symbols. Valid values are 2 - 8.</p>
</dd>
</dl>
<div class="p"><strong>Data Matrix:</strong> The additional data is specified as
an expression of the form: <pre>(*DATAMATRIX row-size number-rows [alternate-data-type] [reader]
[header-trailer] [sequence-indicator]) </pre>
You
can specify the following parameters for the Data Matrix barcode, in the following
order:</div>
<dl><dt class="dlterm">row-size</dt>
<dd>This required parameter for Data Matrix barcode specifies the row size.
Data Matrix barcodes are square symbols or rectangle symbols. The square symbols
are 10 by 10 to 144 by 144 and the rectangle symbols are 8 by 18 to 16 by
48. A special value of *DFT can be specified to have the printer select the
row size based on the amount of symbol data.</dd>
<dt class="dlterm">number-rows</dt>
<dd>This required parameter for Data Matrix barcode specifies the number of
rows. Data Matrix barcodes are square symbols or rectangle symbols. The square
symbols are 10 by 10 to 144 by 144 and the rectangle symbols are 8 by 18 to
16 by 48. A special value of *DFT can be specified to have the printer select
the number of rows based on the amount of symbol data.</dd>
<dt class="dlterm">alternate-data-type</dt>
<dd>This optional parameter for the Data Matrix barcode specifies the data
type for the defined symbol. Valid values are: <ul><li>*USRDEF indicates that this is a user defined symbol. *USRDEF is the default
value if no alternate-data-type is specified.</li>
<li>*AIMSTD indicates that the symbol conforms to the specific industry standards
as authorized by AIM international.</li>
<li>*UCCEAN indicates that the symbol conforms to the UCC/EAN application
identifier standard format.</li>
</ul>
</dd>
<dt class="dlterm">reader</dt>
<dd>This optional parameter for Data Matrix barcode specifies whether this
barcode encodes a message used to program the reader system. Valid values
are: <ul><li>*DATA indicates that barcode data is supplied. *DATA is the default value
if no reader indicator is specified.</li>
<li>*RDRPRG indicates that the symbol contains a message used to program the
barcode reader.</li>
</ul>
</dd>
<dt class="dlterm">header-trailer</dt>
<dd>This optional parameter for Data Matrix barcode specifies whether header
and trailers instructions to the barcode reader are to be included. Valid
values are: <ul><li>*NO indicates that no header or trailers are to be inserted. *NO is the
default value if no header-trailer value is specified.</li>
<li>*HEADER5 indicates that the barcode reader will insert a 05 Macro codeword.</li>
<li>*HEADER6 indicates that the barcode reader will insert a 06 Macro codeword.</li>
</ul>
</dd>
<dt class="dlterm">sequence-indicator</dt>
<dd>This optional parameter for Data Matrix barcode specifies whether this
barcode is part of a structured append. The Data Matrix barcode can be logically
linked together to encode large amounts of data. The logically linked symbols
can be presented on the same or different media and are logically recombined
after they are scanned. The sequence data for the Data Matrix consists of
three parts of the following form <pre>*SEQUENCE(sequence-indicator total-symbols file-id)</pre>
<p><em>sequence-indicator</em> specifies
the structured append sequence indicator. Valid values are in the range of
1 through 16.</p>
<p><em>total-symbols</em> specifies the total number of symbols
that is logically linked in a sequence of symbols. Valid values are in the
range of 2 through 16.</p>
<p><em>file-id</em> specifies a 2-byte unique file
identification for a set of structured-append symbols. When specifying the
file-id, the format is <samp class="codeph">X'nnnn'</samp>, where <samp class="codeph">nnnn</samp> is
the two byte file id in hexadecimal.</p>
</dd>
</dl>
<div class="note"><span class="notetitle">Note:</span> When a structured append is specified, you must specify
*NO for the header and trailer, and you must specify *DATA for the reader.
For valid combinations of row-size and number-rows, see the symbology specification.</div>
</div>
<div class="section"><h4 class="sectiontitle">EBCDIC-to-ASCII translation of two-dimensional barcodes</h4><p>The
two-dimensional barcodes PDF417, Maxicode, and Data Matrix are ASCII barcodes.
The system extracts the CCSID of the job that generates the spool file and
translates EBCDIC data to code page 500. The printer then translates the data
from code page 500 to the appropriate ASCII code page.</p>
<p>Maxicode and
Data Matrix barcodes are assumed to start in ISO 8859-1 code page. The IBM<sup>®</sup> equivalent
is ASCII code page 819. ASCII code page 437 is used for PDF417.</p>
</div>
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the BARCODE keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A FIELD1 11S O 2 4BARCODE(UPCA 6)
A FIELD2 3A 10 6BARCODE(CODE30F9 4 *NOHRI-
A *AST X'02')
A FIELD3 10S O 4 5BARCODE(UPCE 6 (*RATIO 2.75) *HRZ +
A X'00' (*WIDTH .02))
A FIELD4 10A O 5 5BARCODE(CODEABAR 1 (*RATIO 2.1) +
A *HRITOP)
A 6 5'01234567'
A BARCODE(CODE128 2 *HRITOP *HRZ +
A (*WIDTH 0.1) (*RATIO 2) X'01')
A FIELD5 10A 0 12 5BARCODE(CODEABAR (2.0 *UOM))
A FIELD6 10S 0 15 5BARCODE(10 X'01')</pre>
</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="reltasks"><strong>Related tasks</strong><br />
<div><a href="../dds/rbafpmstsyntax.htm">Rules for DDS keywords and parameter values</a></div>
</div>
</div>
</body>
</html>