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

94 lines
6.0 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="PAGNBR (Page Number) keyword in printer files" />
<meta name="abstract" content="Use this field-level keyword to specify the location of an unnamed, 4-digit, zoned decimal field to contain the page number." />
<meta name="description" content="Use this field-level keyword to specify the location of an unnamed, 4-digit, zoned decimal field to contain the page number." />
<meta name="DC.subject" content="PAGNBR (Page Number) keyword, Page Number (PAGNBR) keyword" />
<meta name="keywords" content="PAGNBR (Page Number) keyword, Page Number (PAGNBR) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakdmstprkey.htm" />
<meta name="DC.Relation" scheme="URI" content="constantfields.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="rzakdmstptpagnb" />
<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>PAGNBR (Page Number) keyword in printer files</title>
</head>
<body id="rzakdmstptpagnb"><a name="rzakdmstptpagnb"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">PAGNBR (Page Number) keyword in printer files</h1>
<div><p>Use this field-level keyword to specify the location of an unnamed,
4-digit, zoned decimal field to contain the page number.</p>
<div class="section"><p><img src="./delta.gif" alt="Start of change" />Specify only the PAGNBR keyword, the location of
the field (the location of the field can be either position only, or line
number and position), or name the field with the special name *NONE if the
POSITION (Position) keyword is used in the record to specify the location
of the fields. Optionally, you can specify the CHRSIZ, COLOR, FONT, HIGHLIGHT,
UNDERLINE, or TEXT keyword.<img src="./deltaend.gif" alt="End of change" /></p>
<p>This keyword has no parameters.</p>
<p>When
the printer file is opened, the <span class="keyword"><font color="Purple">i5/OS™</font></span> operating system sets the page
count to zero and increases it by one before it prints each new page. This
is done even if you do not specify the PAGNBR keyword. The page number is
printed each time any field for which the PAGNBR keyword is specified is printed.
The page number does not increase beyond 9999; it stays 9999 until it is reset.
To reset the page count, condition PAGNBR with option indicators. The <span class="keyword"><font color="Purple">i5/OS</font></span> operating
system resets the page number when your program selects PAGNBR (see the following
examples).</p>
<p>You can also specify EDTCDE or EDTWRD with the PAGNBR keyword.</p>
<p>Option
indicators are valid for this keyword.</p>
<p>You can specify the field (location
only) and the keyword on one line with no indicators or on separate lines
with separate indicators. The following sections explain the differences.</p>
</div>
<div class="section"><h4 class="sectiontitle">Example 1: Specify on one line with no indicators in printer
files</h4><p>The page number is always printed, and you cannot reset the
page number to one, as shown in the following example.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00100A R RECORD
00110A 1 60'PAGE:'
00120A +1PAGNBR
A</pre>
<div class="note"><span class="notetitle">Note:</span> On lines 110 and 120 two constant fields are specified:
'PAGE:' and the page number itself (location specified as +1).</div>
</div>
<div class="section"><h4 class="sectiontitle">Example 2: Specify on separate lines with separate indicators
in printer files</h4><p>If the field indicator (01 in the following example)
is off, the field is not printed, even if the keyword indicator (02 in the
following example) is set on. If the field indicator is on, the field is printed.
The page count is increased when the keyword indicator is off. The page count
is reset to one when the keyword indicator is on. The page number prints whether
the keyword indicator is off or on.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00100A R RECORD
00110A 01 1 60'PAGE'
00120A 01 +1
00130A 02 PAGNBR
A</pre>
</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="constantfields.htm" title="Constant fields are unnamed fields (positions 19 through 28 must be blank), or fields with a special name (*NONE) when POSITION (Position) keyword is used in the record.">Constant fields in printer files</a></div>
</div>
</div>
</body>
</html>