134 lines
7.7 KiB
HTML
134 lines
7.7 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="POSITION (Position) keyword in printer files" />
|
|
<meta name="abstract" content="Use this field-level keyword to define the location of a named field on the page." />
|
|
<meta name="description" content="Use this field-level keyword to define the location of a named field on the page." />
|
|
<meta name="DC.subject" content="POSITION (Position) keyword" />
|
|
<meta name="keywords" content="POSITION (Position) keyword" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstafprsc.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstptbox.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstptgdf.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstptline.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstptoverl.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakdmstptpagse.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="rzakdmstpositn" />
|
|
<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>POSITION (Position) keyword in printer files</title>
|
|
</head>
|
|
<body id="rzakdmstpositn"><a name="rzakdmstpositn"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">POSITION (Position) keyword in printer files</h1>
|
|
<div><p>Use this field-level keyword to define the location of a named
|
|
field on the page.</p>
|
|
<div class="section"><p>The format of the keyword is:</p>
|
|
<pre>POSITION(position-down | &position-down-field
|
|
position-across | &position-across-field)</pre>
|
|
<p>The position-down
|
|
parameter is required and defines the vertical starting point of the field
|
|
relative to the margins specified on the FRONTMGN or BACKMGN parameter on
|
|
the CRTPRTF command. Valid values are 0 to 57.790 cm (0 to 22.750 in.).</p>
|
|
<p>The
|
|
position-across parameter is required and defines the horizontal starting
|
|
point of the field relative to the margins specified on the FRONTMGN or BACKMGN
|
|
parameter on the CRTPRTF command. Valid values are 0 to 57.790 cm (0 to 22.750
|
|
in.).</p>
|
|
<p>You can specify the position-down and position-across
|
|
parameters as constants, program-to-system fields, or a combination of both,
|
|
as shown in the following examples:</p>
|
|
<ul><li>POSITION(3.56 6.24)</li>
|
|
<li>POSITION(&field1 9.625)</li>
|
|
<li>POSITION(0.5 &field2)</li>
|
|
<li>POSITION(&field3 &field4)</li>
|
|
</ul>
|
|
<p>Field1, field2, field3, and field4 are the names of program-to-system
|
|
fields. The fields must exist in the same record format as the POSITION keyword
|
|
and be defined as having length 5 with 3 decimal positions, data type S (zoned
|
|
decimal), and usage P (program-to-system).</p>
|
|
<div class="note"><span class="notetitle">Note:</span> The UOM parameter on the
|
|
CRTPRTF command determines the units of measure for the position-down and
|
|
position-across parameter values. If the value specified for a parameter is
|
|
outside the valid range, it is flagged when the spooled file is created.</div>
|
|
<p>An
|
|
error message is issued at print time if the field does not fit on the page.</p>
|
|
<p>An
|
|
error message is issued at create time if line and position values, columns
|
|
39 through 44, are also specified.</p>
|
|
<p>Because the POSITION keyword allows
|
|
a field to be positioned anywhere on the page, a new page is not generated
|
|
by the use of the position keyword. The ENDPAGE keyword should be used to
|
|
end the current page and proceed to the next page.</p>
|
|
<p>If the POSITION keyword
|
|
is specified for a field, all fields in the record format must also have the
|
|
POSITION keyword specified. Location entries in positions 39 through 44 are
|
|
not allowed.</p>
|
|
<p><img src="./delta.gif" alt="Start of change" />You can specify constant fields where the
|
|
POSITION keyword is also specified. You just need to use a special name (*NONE).<img src="./deltaend.gif" alt="End of change" /></p>
|
|
<p>Specify
|
|
DEVTYPE(*AFPDS) on the CRTPRTF command when POSITION is specified in the file.
|
|
If DEVTYPE is changed to anything other than *AFPDS, the keyword is ignored
|
|
and a warning message is issued at print time.</p>
|
|
<p>You cannot specify POSITION
|
|
with the following keywords:</p>
|
|
<ul><li>SPACEA</li>
|
|
<li>SPACEB</li>
|
|
<li>SKIPA</li>
|
|
<li>SKIPB</li>
|
|
</ul>
|
|
<p>Option indicators are valid for this keyword.</p>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the POSITION keyword.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
A*
|
|
A R REC1
|
|
A FLD1 6S 2 POSITION(2.0 1.983)
|
|
A*
|
|
A FLD2 42A POSITION(&FLD2A &FLD2B)
|
|
A FLD2A 5S 3P
|
|
A FLD2B 5S 3P
|
|
A*</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> The UOM parameter on the CRTPRTF command determines
|
|
the units of measure for the parameter values.</div>
|
|
<p>In REC1, FLD1 prints
|
|
2.0 units down and 1.983 units across from the margins specified on the FRONTMGN
|
|
or BACKMGN parameter on the CRTPRTF command.</p>
|
|
<p>The application program
|
|
determines the position of FLD2 by assigning values to program-to-system variables
|
|
FLD2A and FLD2B.</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 class="relconcepts"><strong>Related concepts</strong><br />
|
|
<div><a href="rzakdmstafprsc.htm" title="Use this record-level keyword to specify an AFP or non-AFP resource stored in the integrated file system.">AFPRSC (AFP Resource) keyword in printer files</a></div>
|
|
<div><a href="rzakdmstptbox.htm" title="Use this record-level keyword to print a rectangle.">BOX (Box) keyword in printer files</a></div>
|
|
</div>
|
|
<div class="relref"><strong>Related reference</strong><br />
|
|
<div><a href="rzakdmstptgdf.htm" title="Use this record-level keyword to print a graphic data file.">GDF (Graphic Data File) keyword in printer files</a></div>
|
|
<div><a href="rzakdmstptline.htm" title="Use this record-level keyword to print a horizontal or vertical line.">LINE (Line) keyword in printer files</a></div>
|
|
<div><a href="rzakdmstptoverl.htm" title="Use this record-level keyword to print an overlay.">OVERLAY (Overlay) keyword in printer files</a></div>
|
|
<div><a href="rzakdmstptpagse.htm" title="Use this record-level keyword to print a page segment.">PAGSEG (Page Segment) keyword in printer files</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |