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

171 lines
11 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="RELPOS (Relative Position) keyword in printer files" />
<meta name="abstract" content="Use this file-level keyword to indicate that when the +n form of positioning a field is used, the fields subsequent to the first field in the line are positioned relative to the end of the previous field. Without the RELPOS keyword, the column number calculated at compile time is generally relative to the beginning of the line." />
<meta name="description" content="Use this file-level keyword to indicate that when the +n form of positioning a field is used, the fields subsequent to the first field in the line are positioned relative to the end of the previous field. Without the RELPOS keyword, the column number calculated at compile time is generally relative to the beginning of the line." />
<meta name="DC.subject" content="RELPOS (Relative Position) keyword in printer files, Relative Position (RELPOS) keyword" />
<meta name="keywords" content="RELPOS (Relative Position) keyword in printer files, Relative Position (RELPOS) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.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="rzakdmstptrelpo" />
<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>RELPOS (Relative Position) keyword in printer files</title>
</head>
<body id="rzakdmstptrelpo"><a name="rzakdmstptrelpo"><!-- --></a>
<img src="./delta.gif" alt="Start of change" /><!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">RELPOS (Relative Position) keyword in printer files</h1>
<div><p>Use this file-level keyword to indicate that when the <tt>+n</tt> form
of positioning a field is used, the fields subsequent to the first field in
the line are positioned relative to the end of the previous field. Without
the RELPOS keyword, the column number calculated at compile time is generally
relative to the beginning of the line.</p>
<div class="section"><p>This keyword has no parameters.</p>
<p>The <em>+n positioning</em> means
that, if you specify a location of a field in a record and the field is not
ignored, you can specify the location of subsequent fields within that record
by leaving the line number blank and specifying a plus value (<tt>+n</tt>)
for position entry 42 through 44. The plus value indicates the number of spaces
to be left between the end of the previous field and the beginning of the
field you are defining. The plus value must be in the range of 0 through 99.
If you specify a plus value, the line number entry must be blank. As soon
as the positions are calculated, the real values are stored and treated as
if they were hard-coded. This is a compile time function.</p>
<p>Specify DEVTYPE
(*AFPDS) on the CRTPRTF command when RELPOS is specified at the file level.
If DEVTYPE is changed to anything other than *AFPDS, the keyword is ignored
and a warning message is issued at print time.</p>
<p>Option indicators are
not valid for this keyword.</p>
<div class="note"><span class="notetitle">Note:</span> The Print Services Facility™ (PSF)
feature is required for printing DEVTYPE (*AFPDS) files on an IPDS™ printer.</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><caption>Table 1. </caption><thead align="left"><tr><th rowspan="2" align="center" valign="top" width="45.4014598540146%" id="d0e55">Condition</th>
<th colspan="6" align="center" valign="top" id="d0e57">Cases</th>
</tr>
<tr valign="bottom"><th valign="bottom" width="9.05109489051095%" id="d0e60">1</th>
<th valign="bottom" width="9.197080291970803%" id="d0e62">2</th>
<th valign="bottom" width="9.05109489051095%" id="d0e64">3</th>
<th valign="bottom" width="9.197080291970803%" id="d0e66">4</th>
<th valign="bottom" width="9.05109489051095%" id="d0e68">5</th>
<th valign="bottom" width="9.05109489051095%" id="d0e70">Else</th>
</tr>
</thead>
<tbody><tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">Was the file-level keyword RELPOS used?</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">N</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">N</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">&nbsp;</td>
</tr>
<tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">Was <tt>+n</tt> positioning used?</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">N</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">N</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">&nbsp;</td>
</tr>
<tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">Was the file-level font width not known?<sup>1</sup></td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">&nbsp;</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">&nbsp;</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">&nbsp;</td>
</tr>
<tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">Did the previous field on the line use a file-level
font?</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">&nbsp;</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">&nbsp;</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">&nbsp;</td>
</tr>
<tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">Were there no DBCS characters in the previous field?</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">&nbsp;</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">&nbsp;</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">&nbsp;</td>
</tr>
<tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">Is the new column number greater than the current column
number?</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">N</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">&nbsp;</td>
</tr>
<tr><td colspan="7" valign="top" headers="d0e55 d0e57 d0e60 d0e62 d0e64 d0e66 d0e68 d0e70 "><strong>Runtime result:</strong></td>
</tr>
<tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">The new field is offset from the end of the previous
field.</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">&nbsp;</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">Y</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">&nbsp;</td>
</tr>
<tr><td valign="top" width="45.4014598540146%" headers="d0e55 ">The new field is positioned from the beginning of the
line.</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e60 ">&nbsp;</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e62 ">Y</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e64 ">&nbsp;</td>
<td valign="top" width="9.197080291970803%" headers="d0e57 d0e66 ">&nbsp;</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e68 ">&nbsp;</td>
<td valign="top" width="9.05109489051095%" headers="d0e57 d0e70 ">Y</td>
</tr>
<tr><td colspan="7" valign="top" headers="d0e55 d0e57 d0e60 d0e62 d0e64 d0e66 d0e68 d0e70 "><sup>1</sup>If the printer file FONT parameter
is *DEVD, or the printer file has a FNTCHRSET or CDEFNT specified at the file
level, the file-level font width is not known.</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the RELPOS keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A*
A RELPOS
A R REC1 FONT(1051)
A* (1051 specifies Sonoran Serif)
A FLD1 5A 1 10
A FLD2 5A +2
A* </pre>
<p>FLD2
is placed two spaces to the right of the end of FLD1. Depending on the width
of the characters used in FLD1, the start of FLD2 might vary. Without the
RELPOS keyword, FLD2 is placed in column 17 of the line; the exception to
this statement is noted in columns 3 through 5 of the previous table.</p>
</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>
<img src="./deltaend.gif" alt="End of change" /></body>
</html>