130 lines
7.1 KiB
HTML
130 lines
7.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="DFNLIN (Define Line) keyword" />
|
||
|
<meta name="abstract" content="Use this record-level keyword to draw a horizontal or a vertical line." />
|
||
|
<meta name="description" content="Use this record-level keyword to draw a horizontal or a vertical line." />
|
||
|
<meta name="DC.subject" content="DFNLIN (Define Line) keyword, Define Line (DFNLIN) keyword" />
|
||
|
<meta name="keywords" content="DFNLIN (Define Line) keyword, Define Line (DFNLIN) keyword" />
|
||
|
<meta name="DC.Relation" scheme="URI" content="prtkwd.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="rzakdmstdbdfnl" />
|
||
|
<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>DFNLIN (Define Line) keyword</title>
|
||
|
</head>
|
||
|
<body id="rzakdmstdbdfnl"><a name="rzakdmstdbdfnl"><!-- --></a>
|
||
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
<h1 class="topictitle1">DFNLIN (Define Line) keyword</h1>
|
||
|
<div><p>Use this record-level keyword to draw a horizontal or a vertical
|
||
|
line.</p>
|
||
|
<div class="section"><p>A horizontal line is drawn at the bottom of the character spaces
|
||
|
from left to right. A vertical line is drawn on the right edge of the character
|
||
|
spaces from top to bottom.</p>
|
||
|
<p>The format of this keyword is:</p>
|
||
|
<pre>DFNLIN(direction start_line start_position length)</pre>
|
||
|
<p>The direction parameter specifies whether the defined line
|
||
|
is horizontal or vertical. The value specified must be one of the following
|
||
|
ones:</p>
|
||
|
<ul><li>*VRT</li>
|
||
|
<li>*HRZ</li>
|
||
|
</ul>
|
||
|
<p>The start line parameter specifies the line number, from the top of
|
||
|
the page, where the defined line starts. The possible values are 1 through
|
||
|
255, but the value specified must not exceed the page length value specified
|
||
|
on the PAGESIZE parameter of the Create Printer File (CRTPRTF) command.</p>
|
||
|
<p>The
|
||
|
start position parameter specifies the position number, from the left margin
|
||
|
of the page, where the defined line starts. The possible values are 1 through
|
||
|
378, but the value specified should not exceed the page width value specified
|
||
|
on the PAGESIZE parameter of the CRTPRTF command.</p>
|
||
|
<p>The length parameter
|
||
|
specifies the length in number of lines when the defined line is vertical
|
||
|
or in number of characters when the defined line is horizontal.</p>
|
||
|
<p>The
|
||
|
length specified must be greater than zero. For a vertical line, the sum of
|
||
|
the length and the value of the start line parameter cannot exceed 255. Although
|
||
|
255 is the maximum value of this sum, valid values must not exceed the page
|
||
|
length specified on the PAGESIZE parameter of the CRTPRTF command.</p>
|
||
|
<p>For
|
||
|
a horizontal line, the sum of the length and the value of the start position
|
||
|
parameter cannot exceed 378. Although 378 is the maximum value of this sum,
|
||
|
valid values must not exceed the page width specified on the PAGESIZE parameter
|
||
|
of the CRTPRTF command.</p>
|
||
|
<p>All parameters are required.</p>
|
||
|
<p>A warning
|
||
|
message will be issued at create time if:</p>
|
||
|
<ul><li>The start line value specified is larger than the page length value specified
|
||
|
on the PAGESIZE parameter of the CRTPRTF command.</li>
|
||
|
<li>The start position value specified is larger than the page width value
|
||
|
specified on the PAGESIZE parameter of the CRTPRTF command.</li>
|
||
|
<li>The sum of the length and the start line value for a vertical line is
|
||
|
larger than the page length specified on the PAGESIZE parameter of the CRTPRTF
|
||
|
command.</li>
|
||
|
<li>The sum of the length and the start position value for a horizontal line
|
||
|
is larger than the page width specified on the PAGESIZE parameter of the CRTPRTF
|
||
|
command.</li>
|
||
|
</ul>
|
||
|
<p>The DFNLIN keyword can be specified more than once at the record level.</p>
|
||
|
<p>Option
|
||
|
indicators are allowed for this keyword.</p>
|
||
|
<p>The DFNLIN keyword cannot be
|
||
|
specified on a record that also contains keywords that are valid only on IPDS™ printers
|
||
|
(such as COLOR, BARCODE, and LPI). If DFNLIN is specified with any of those
|
||
|
keywords, a severe error (severity 30) message will be issued.</p>
|
||
|
<p>If the
|
||
|
DFNLIN keyword is specified when a printer file is created with DEVTYPE(*IPDS),
|
||
|
a warning (severity 10) message is issued but the keyword is not ignored at
|
||
|
creation time. However, the keyword is ignored and a message is issued when
|
||
|
the printer file is used.</p>
|
||
|
<p>If the DFNLIN keyword is specified with a
|
||
|
printer file created with DEVTYPE(*AFPDS), the keyword is ignored and a warning
|
||
|
message is issued.</p>
|
||
|
</div>
|
||
|
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
||
|
the DFNLIN keyword on the DDS coding form.</p>
|
||
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
00010A*
|
||
|
00020A*
|
||
|
00030A R RECORD1 DFNLIN(*HRZ 4 12 20)
|
||
|
00040A DFNLIN(*VRT 5 12 6)
|
||
|
00050A DFNLIN(*HRZ 10 12 20)
|
||
|
00060A DFNLIN(*VRT 5 32 6)
|
||
|
A</pre>
|
||
|
<p>The output of RECORD1 format is a box.</p>
|
||
|
<p>The output
|
||
|
of the first DFNLIN keyword is a horizontal line. The line is drawn to the
|
||
|
right from the twelfth character position on the fourth line for a length
|
||
|
of 20 characters.</p>
|
||
|
<p>The output of the second DFNLIN keyword is a vertical
|
||
|
line. The line is drawn down from the twelfth character position on the fifth
|
||
|
line for a length of 6 lines.</p>
|
||
|
<p>The output of the third DFNLIN keyword
|
||
|
is a horizontal line. The line is drawn to the right from the ending point
|
||
|
of the second line (10 = 4 + 6) for a length of 20 characters.</p>
|
||
|
<p>The output
|
||
|
of the fourth DFNLIN keyword is a vertical line. The line is drawn down from
|
||
|
the ending point of the first line (32 = 12 + 20) for a length of 6 lines.</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>
|
||
|
</body>
|
||
|
</html>
|