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

107 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="SFLSCROLL (Subfile Scroll) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword in the subfile control record format to return the relative record number of the subfile record that is at the top of the subfile when control is given back to your program." />
<meta name="description" content="Use this field-level keyword in the subfile control record format to return the relative record number of the subfile record that is at the top of the subfile when control is given back to your program." />
<meta name="DC.subject" content="SFLSCROLL (Subfile Scroll) keyword, Subfile Scroll (SFLSCROLL) keyword" />
<meta name="keywords" content="SFLSCROLL (Subfile Scroll) keyword, Subfile Scroll (SFLSCROLL) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.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="rzakcmstdfsflsc" />
<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>SFLSCROLL (Subfile Scroll) keyword for display files</title>
</head>
<body id="rzakcmstdfsflsc"><a name="rzakcmstdfsflsc"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLSCROLL (Subfile Scroll) keyword for display files</h1>
<div><p>Use this field-level keyword in the subfile control record format
to return the relative record number of the subfile record that is at the
top of the subfile when control is given back to your program.</p>
<div class="section"><p>This keyword has no parameters.</p>
<p>This field must have the
keyboard shift attribute of signed numeric with zero decimal positions. It
has to be 5 digits in length, and it must be defined as a hidden field. The
hidden field will not display an input field on the screen.</p>
<p>This field
is returned to your program as part of the input for this subfile control
record. If control is returned to your program by pressing the enter key,
then the value returned will be the relative record number of the top subfile
record currently displayed.</p>
<p>With the ROLLUP or ROLLDOWN keywords, control
is returned to the program when pressing a Page Up or a Page Down key will
page beyond the end of the subfile. Without ROLLUP or ROLLDOWN, a message
is displayed. If control is returned to your program because of the ROLLUP
keyword, then the value returned will be the relative record number of the
top subfile record on the next page. If control is returned to your program
because of the ROLLDOWN keyword then a 1 will be returned in the relative
record number field.</p>
<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>
<p>SFLSCROLL
is not allowed when SFLSIZ equals SFLPAG.</p>
<p>This keyword is valid only
for the subfile control record format.</p>
<p>This keyword is helpful when
scroll bars are used. (When SFLEND(*SCRBAR) is specified.) When the user interacts
with the scroll bar, the hidden field that contains SFLSCROLL contains the
relative record number of the record the user wants displayed. Control will
only be returned to your program when the user attempts to scroll into parts
of the subfile that are not written to or if the enter key is pressed. Another
keyword that might be useful is SFLRCDNBR will *TOP as a parameter. After
you have added records to the subfile, redisplay the subfile with the SFLRCDNBR
in effect. Use the same number for this keyword that was returned to the SFLSCROLL
keyword.</p>
<p>You cannot specify the SFLROLVAL, the SFLSCROLL and the SFLRCDNBR
keywords for the same field.</p>
<p>Only one SFLSCROLL keyword is allowed in
the subfile control record.</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 SFLSCROLL keyword.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R SFLRCD SFL
A CTLFLD 1Y 0H SFLCHCCTL
A F1 4A O 6 10
A R SFLCTLRCD SFLCTL(SFLRCD)
A SFLSNGCHC
A SFLPAG(5) SFLSIZ(&amp;SFLSIZ);
A SFLDSP SFLDSPCTL
A ROLLUP(10)
A 10 SFLEND(*SCRBAR)
A F3 5S 0H SFLSCROLL
A F2 4S 0H SFLRCDNBR(CURSOR *TOP)
A SFLSIZ 5S 0P
A 1 30'Panel Title'
A 4 5'Multiple selection list:'</pre>
<p>In
this example, field F3 contains the relative record number of the subfile
record that is at the top of the subfile when control is given back to the
program.</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>
</body>
</html>