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

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>