169 lines
10 KiB
HTML
169 lines
10 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="SFLROLVAL (Subfile Roll Value) keyword for display files" />
|
|
<meta name="abstract" content="Use this field-level keyword in the subfile control record format to specify that the workstation user can type a value into this field to tell the i5/OS operating system how many records to page up or down when the appropriate paging key is pressed." />
|
|
<meta name="description" content="Use this field-level keyword in the subfile control record format to specify that the workstation user can type a value into this field to tell the i5/OS operating system how many records to page up or down when the appropriate paging key is pressed." />
|
|
<meta name="DC.subject" content="SFLROLVAL (Subfile Roll Value) keyword, Subfile Roll Value (SFLROLVAL) keyword" />
|
|
<meta name="keywords" content="SFLROLVAL (Subfile Roll Value) keyword, Subfile Roll Value (SFLROLVAL) keyword" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfalwr.htm" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfslend.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="rzakcmstdfsfrol" />
|
|
<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>SFLROLVAL (Subfile Roll Value) keyword for display files</title>
|
|
</head>
|
|
<body id="rzakcmstdfsfrol"><a name="rzakcmstdfsfrol"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">SFLROLVAL (Subfile Roll Value) keyword for display files</h1>
|
|
<div><p>Use this field-level keyword in the subfile control record format
|
|
to specify that the workstation user can type a value into this
|
|
field to tell the <span class="keyword">i5/OS™</span> operating
|
|
system how many records to page up or down when the appropriate paging key
|
|
is pressed.</p>
|
|
<div class="section"><p>This field must have the keyboard shift attribute of signed numeric
|
|
with zero decimal positions. It can be up to 4 digits in length, and it must
|
|
be defined as an input/output or input-only field.</p>
|
|
<p>This keyword has
|
|
no parameters.</p>
|
|
<p>The workstation user can page through the data being
|
|
displayed up or down by first typing in the number of records to page through
|
|
and then pressing the Page Up or the Page Down key. (On subsequent pages,
|
|
the SFLROLVAL value stays the same unless a new number is typed in before
|
|
paging.) If a negative number or zero is typed into this field and a Page
|
|
key is pressed, an error message is displayed at the workstation.</p>
|
|
<p>This
|
|
keyword is valid only for the subfile control record format. You must specify
|
|
it if the <span class="keyword">i5/OS</span> operating
|
|
system is to support the page-by-record function.</p>
|
|
<p>If this keyword is
|
|
not specified, the <span class="keyword">i5/OS</span> operating
|
|
system pages through the display by the SFLPAG value except for subfiles using
|
|
the SFLDROP keyword. If using 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>If subfile size equals subfile page, SFLROLVAL is
|
|
ignored. When several display sizes are used (DSPSIZ keyword specified), SFLROLVAL
|
|
is ignored only for display sizes for which subfile size equals subfile page.
|
|
If the subfile record format contains field selection, SFLROLVAL is not valid.</p>
|
|
<p>This
|
|
field is returned to your program as part of the input for this subfile control
|
|
record.</p>
|
|
<div class="p">If pressing the Page Up key pages beyond the first page of records
|
|
of the subfile, one of the following conditions occurs: <ul><li>If the first page of records is not currently displayed, paging up will
|
|
display it.</li>
|
|
<li>If the first page of records is currently displayed, paging up will cause
|
|
a message to be displayed.</li>
|
|
</ul>
|
|
</div>
|
|
<div class="p">If pressing the Page Down key pages beyond the last active record
|
|
of the subfile, one of the following conditions occurs: <ul><li>If the last full page of records is not already displayed, typing Page
|
|
Down will display it.</li>
|
|
<li>If the last full page of records is already displayed, typing Page Down
|
|
will cause a message to be displayed. One exception to this rule is that when
|
|
the SFLROLVAL value is less than the SFLPAG value, the <span class="keyword">i5/OS</span> operating
|
|
system pages through the subfile again and no message is displayed.</li>
|
|
</ul>
|
|
</div>
|
|
<div class="p">Certain keywords are helpful when specified with SFLROLVAL: <ul><li>The SFLEND keyword notifies the workstation user when the last subfile
|
|
record is displayed.</li>
|
|
<li>The PAGEUP or PAGEDOWN keywords cause control to return to the program
|
|
when pressing a Page Up or a Page Down key can page beyond the end of the
|
|
subfile. Without PAGEUP(ROLLDOWN) or PAGEDOWN(ROLLUP), a message is displayed
|
|
(as described previously).</li>
|
|
</ul>
|
|
<div class="note"><span class="notetitle">Note:</span> The ROLLUP keyword is the same as the PAGEDOWN keyword and the
|
|
ROLLDOWN keyword is the same as the PAGEUP keyword.</div>
|
|
</div>
|
|
<div class="p">The following
|
|
examples illustrate the use of SFLROLVAL: <ul><li>Paging Up. Assume that the value specified for SFLPAG is 3, and there
|
|
are 11 active records in the subfile. If records 8 through 10 are currently
|
|
being displayed, and the user types a page value greater than 7, pressing
|
|
the Page Up key displays records 1 through 3. <p>If records 1 through 3 are
|
|
currently displayed, and a Page Up key is entered with a SFLROLVAL value greater
|
|
than 0, either a message is sent to the workstation user (PAGEUP not specified)
|
|
or control is returned to the user program (PAGEUP specified; the program
|
|
has responsibility for paging down).</p>
|
|
</li>
|
|
<li>Paging Down. Assume that the value specified for SFLPAG is 3, and there
|
|
are 11 active records in the subfile. If records 8 through 10 are currently
|
|
being displayed, and the user enters a 3 into the SFLROLVAL field, pressing
|
|
the Page Down key displays record 11 in the uppermost page area of the display.
|
|
Any lines not occupied by that record are blank. If the Page Down key is pressed
|
|
again, the last full page of subfile records (records 9 through 11) are displayed.
|
|
Finally, if the Page Down key is pressed a third time, either a message is
|
|
sent to the workstation user (PAGEDOWN not specified) or control is returned
|
|
to the user program (PAGEDOWN specified; the program has responsibility for
|
|
paging down).</li>
|
|
</ul>
|
|
</div>
|
|
<div class="p">The following shows the conditions that occur when paging beyond
|
|
the ends of the subfile (when the SFLROLVAL value is greater than the SFLPAG
|
|
value). <ul><li>On pressing the Page Down key: <ul><li>If the last full page of records is not already displayed, then it is
|
|
displayed.</li>
|
|
<li>If the last full page of records is already displayed, then a message
|
|
is displayed.</li>
|
|
</ul>
|
|
</li>
|
|
<li>On pressing the Page Down key a second time: <ul><li>If PAGEDOWN is specified, control returns to your program.</li>
|
|
<li>If PAGEDOWN is not specified, a message is displayed.</li>
|
|
</ul>
|
|
</li>
|
|
<li>On pressing the Page Up key: <ul><li>If the first page of the subfile is not already displayed, then it is
|
|
displayed.</li>
|
|
<li>If the first page of the subfile is already displayed, then: <ul><li>If PAGEUP is specified, control returns to your program.</li>
|
|
<li>If PAGEUP is not specified, a message is displayed.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<p>You cannot specify both the SFLROLVAL and the SFLRCDNBR keywords
|
|
for the same field.</p>
|
|
<p>Option indicators are not valid for this keyword.</p>
|
|
</div>
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the SFLROLVAL 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
|
|
00080A ROLVAL 4S 0B 1 47SFLROLVAL
|
|
A</pre>
|
|
</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="rzakcmstdfalwr.htm" title="Use this record-level keyword to allow your program to page through data in a window on the display when displaying the record format you are defining.">ALWROL (Allow Roll) keyword for display files</a></div>
|
|
<div><a href="rzakcmstdfslend.htm" title="Use this record-level keyword on the subfile control record format to permit the display of a plus sign (+) or text (More… or Bottom) in the lower-right display location occupied by the subfile or a scroll bar.">SFLEND (Subfile End) keyword for display files</a></div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |