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

120 lines
6.4 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="PAGRTT (Page Rotation) keyword in printer files" />
<meta name="abstract" content="Use this record-level keyword to specify the degree of rotation of the text with respect to the way the page is loaded into the printer." />
<meta name="description" content="Use this record-level keyword to specify the degree of rotation of the text with respect to the way the page is loaded into the printer." />
<meta name="DC.subject" content="PAGRTT (Page Rotation) keyword, Page Rotation (PAGRTT) keyword" />
<meta name="keywords" content="PAGRTT (Page Rotation) keyword, Page Rotation (PAGRTT) 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="rzakdmstptpagrt" />
<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>PAGRTT (Page Rotation) keyword in printer files</title>
</head>
<body id="rzakdmstptpagrt"><a name="rzakdmstptpagrt"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">PAGRTT (Page Rotation) keyword in printer files</h1>
<div><p>Use this record-level keyword to specify the degree of rotation
of the text with respect to the way the page is loaded into the printer.</p>
<div class="section"><p>The PAGRTT keyword is valid only for the 3812, 3816, 3820, 3825,
3827, 3835, and 4028 printers. If you do not specify a PAGRTT keyword for
a record, the page rotation is set from the value specified on the Create
Printer File (CRTPRTF), Change Printer File (CHGPRTF), or Override Printer
File (OVRPRTF) commands.</p>
<p>The format of the keyword is:</p>
<pre>PAGRTT(0 | 90 | 180 | 270)</pre>
<p>The
valid parameter values for the keyword are 0, 90, 180, and 270. Zero indicates
no rotation. The other values specify the number of degrees rotation clockwise
from the 0 degree rotation column.</p>
<div class="note"><span class="notetitle">Note:</span> For the 3835 Printer using landscape
paper, a counterclockwise rotation is used for a DDS file.</div>
<p>The PAGRTT
keyword does not cause an implicit page eject. If the paper is not on a page
boundary, the keyword is not used, and a diagnostic message is issued.</p>
<p>The
PAGRTT, SKIP, and SPACE keywords are processed in the following order:</p>
<p>SKIPB<br />
SPACEB<br />
PAGRTT<br />
SPACEA<br />
SKIPA</p>
<p>The PAGRTT keyword remains in effect for the duration of the
record format. If a PAGRTT keyword is not used on the next record format,
it reverts back to the PAGRTT value specified at the command level.</p>
<div class="note"><span class="notetitle">Notes:</span> <ol><li>The PAGRTT keyword remains in effect for the entire page.
At the end of a record format that specifies PAGRTT, the file is not changed
back to the file-level rotation until the next page is processed. For example,
the file does not return to rotation 0 until record E is written if the file-level
parameter specifies PAGRTT(0) and you write one of the following record formats:
<ul><li>Record format A (PAGRTT (90))</li>
<li>Record format B (same page as record A)</li>
<li>Record format C (same page as record A)</li>
<li>Record format D (same page as record A)</li>
<li>Record format E (next page)</li>
</ul>
</li>
<li>For files created with DEVTYPE(*SCS), if the PAGRTT keyword is specified
on a record format that spans several pages, it remains in effect only for
the page on which it is specified.</li>
</ol>
</div>
<p>When a page rotates, the page length and page width are exchanged
so that the length becomes the width and the width becomes the length. This
exchange cannot be done under the following conditions:</p>
<ul><li>PAGRTT on the CRTPRTF, CHGPRTF, or OVRPRTF command is *DEVD or *COR.</li>
<li>The font on the CRT/CHG/OVRPRTF command is *DEVD.</li>
</ul>
<p>When the length and width cannot be exchanged, a diagnostic message
is issued.</p>
<p>Folding and truncation support is not performed when pages
rotate. That is, the BLKFOLD DDS keyword and the FOLD parameter on the CRTPRTF,
CHGPRTF, or OVRPRTF commands are not used.</p>
<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 PAGRTT keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R RECORD1
A 02 SKIPB(1)
A 02 PAGRTT(270)
A FIELD1 3A 2 01
A R RECORD2
A FIELD1 3A 6 01
A R RECORD3
A FIELD1 3A 5 01
A</pre>
<p>If indicator 02 is on, RECORD1 is rotated 270 degrees.
SKIPB(1) is specified so that the record starts on a new page.</p>
<p>When
RECORD2 is printed, it will also be rotated 270 degrees because it is on the
same page as RECORD1.</p>
<p>RECORD3 uses the PAGRTT value specified on the
CRTPRTF, CHGPRTF, or OVRPRTF commands, because it is on a new
page.</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>
</body>
</html>