ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstdfsfpag.htm

129 lines
7.7 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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="SFLPAG (Subfile Page) keyword for display files" />
<meta name="abstract" content="Use this record-level keyword on the subfile control record format to specify the number of records in the subfile to be displayed at the same time." />
<meta name="description" content="Use this record-level keyword on the subfile control record format to specify the number of records in the subfile to be displayed at the same time." />
<meta name="DC.subject" content="SFLPAG (Subfile Page) keyword, Subfile Page (SFLPAG) keyword" />
<meta name="keywords" content="SFLPAG (Subfile Page) keyword, Subfile Page (SFLPAG) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfl.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="rzakcmstdfsfpag" />
<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>SFLPAG (Subfile Page) keyword for display files</title>
</head>
<body id="rzakcmstdfsfpag"><a name="rzakcmstdfsfpag"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLPAG (Subfile Page) keyword for display files</h1>
<div><p>Use this record-level keyword on the subfile control record format
to specify the number of records in the subfile to be displayed at the same
time.</p>
<div class="section"><p>For an exception to this rule, see <a href="#rzakcmstdfsfpag__sfldsel">Field
selection</a>.</p>
<div class="p">The format of the keyword is: <pre>SFLPAG(number-of-records-to-be-displayed)</pre>
</div>
<p>The
SFLPAG parameter value and the number of lines required by each subfile record
determine the number of actual lines required to display the page of records.
Not all records within a subfile must be displayed at the same time, and not
all lines of the display are required to display a page of subfile records.</p>
<p>This
keyword is required for the subfile control record format.</p>
</div>
<div class="section"><h4 class="sectiontitle">Subfile page equals subfile size</h4><p>When you specify
the same parameter values for SFLPAG and SFLSIZ, the maximum number of records
that can be contained in the subfile equals the maximum number of subfile
records that can appear on the display at one time. For this condition, the <span class="keyword">i5/OS™</span> program does not automatically
page through the subfile when the Page Up or the Page Down key is pressed.
If the ROLLUP and ROLLDOWN keywords are specified and one of the Page keys
is pressed, the <span class="keyword">i5/OS</span> operating
system returns control to your program instead. If ROLLUP and ROLLDOWN are
not specified, a message is sent to the workstation user, indicating that
a key is not supported on the display.</p>
<div class="p">If subfile size equals subfile
page, the following keywords are not allowed: <p>SFLDROP<br />
SFLFOLD<br />
SFLROLVAL</p>
</div>
<p>When several display sizes are used (DSPSIZ keyword
specified), these keywords are ignored only for display sizes for which subfile
size equals subfile page.</p>
</div>
<div class="section" id="rzakcmstdfsfpag__sfldsel"><a name="rzakcmstdfsfpag__sfldsel"><!-- --></a><h4 class="sectiontitle">Field selection</h4><p>When subfile page equals
subfile size, you can specify option indicators for fields in the subfile
record format. This is called <dfn class="term">field selection</dfn>. When field selection
is used in the subfile record, SFLPAG(value) specifies the number of display
lines available to display the records of this subfile. (Without field selection,
SFLPAG(value) specifies the number of subfile records that can be displayed
at one time.) This specification must be considered when a subfile record
occupies more than one display line. The value of SFLPAG must be greater than
or equal to the number of display lines occupied by the subfile.</p>
<div class="p">If
the subfile record format contains field selection, the following keywords
are not valid on the subfile control record format: <p>SFLDROP<br />
SFLFOLD<br />
SFLINZ<br />
SFLLIN<br />
SFLRCDNBR<br />
SFLRNA (because SFLINZ is not valid)<br />
SFLROLVAL</p>
</div>
</div>
<div class="section"><h4 class="sectiontitle">Subfile page does not equal subfile size</h4><p>When you
specify different parameter values for SFLPAG and SFLSIZ, the <span class="keyword">i5/OS</span> operating
system recognizes the Page Up and Page Down keys and automatically pages through
the subfile according to the value specified in the field for which the SFLROLVAL
keyword is specified. If you do not specify the SFLROLVAL keyword, the <span class="keyword">i5/OS</span> program pages through the
subfile by the parameter value specified for the SFLPAG keyword except for
subfiles using SFLDROP. If you use the SFLDROP keyword, more
records are displayed than the SFLPAG value when records are displayed in
the truncated format. For truncated records, the <span class="keyword">i5/OS</span> operating
system pages through the display by the number of records displayed in the
truncated format.</p>
<p>Option indicators are not valid for this keyword.
Display size condition names are valid. Display size condition names are required
if you want the number of records that can be displayed at one time to change,
based on the size of the display.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
the SFLPAG keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A R SFLR SFL
A*
A* (at least one displayable field)
A*
00040A R SFLCTLR SFLCTL(SFLR)
00050A SFLPAG(17)
00060A SFLSIZ(17)
00070A SFLDSP SFLDSPCTL
A</pre>
<p>Because the value specified for the SFLPAG keyword equals
the value specified for SFLSIZ(17), subfile page equals subfile size.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstkeyent.htm" title="You type the keyword entries that define display files in positions 45 through 80 (functions).">DDS keyword entries for display files (positions 45 through 80)</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="rzakcmstdfsfl.htm" title="Use this record-level keyword to specify that this record format is to be a subfile record format.">SFL (Subfile) keyword for display files</a></div>
</div>
</div>
</body>
</html>