241 lines
15 KiB
HTML
241 lines
15 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="SFLEND (Subfile End) keyword for display files" />
|
||
|
|
<meta name="abstract" content="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." />
|
||
|
|
<meta name="description" content="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." />
|
||
|
|
<meta name="DC.subject" content="SFLEND (Subfile End) keyword, Subfile End (SFLEND) keyword" />
|
||
|
|
<meta name="keywords" content="SFLEND (Subfile End) keyword, Subfile End (SFLEND) keyword" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
|
||
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsfrol.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="rzakcmstdfslend" />
|
||
|
|
<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>SFLEND (Subfile End) keyword for display files</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzakcmstdfslend"><a name="rzakcmstdfslend"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">SFLEND (Subfile End) keyword for display files</h1>
|
||
|
|
<div><p>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.</p>
|
||
|
|
<div class="section"><p>The plus sign or More… text indicates that the workstation user
|
||
|
|
can move the text lines on the subfile to display more records by pressing
|
||
|
|
the Page Up key.</p>
|
||
|
|
<div class="p">The format of the keyword is: <pre>SFLEND[(*PLUS | *MORE | {*SCRBAR [*SCRBAR | *PLUS |*MORE ]})]</pre>
|
||
|
|
</div>
|
||
|
|
<div class="p">The
|
||
|
|
scroll bar indicates different types of information about the subfile: <ul><li>Where the user is at in the subfile</li>
|
||
|
|
<li>How big the subfile is</li>
|
||
|
|
<li>What proportion of the subfile the user is viewing</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<p>The parameter values *PLUS, *SCRBAR, and *MORE are optional. If
|
||
|
|
no parameter is specified, *PLUS is used. The second set of *PLUS, *MORE,
|
||
|
|
and *SCRBAR can only be specified if *SCRBAR is specified as the first parameter.
|
||
|
|
*SCRBAR is the default for the second parameter.</p>
|
||
|
|
<p>*PLUS tells the system
|
||
|
|
to use the plus sign to indicate that you can use the Page Down key to see
|
||
|
|
more records.</p>
|
||
|
|
<p>*MORE tells the system to use the More… text to indicate
|
||
|
|
that you can use the Page Down key to see more records. *MORE also tells the
|
||
|
|
system to use the Bottom text to indicate that the last subfile record is
|
||
|
|
displayed.</p>
|
||
|
|
<p>When *MORE is specified, the subfile takes up one more line
|
||
|
|
on the screen (SFLPAG + 1). This line is needed for the text, More… and Bottom.
|
||
|
|
If there is not room for the extra line on the display or in a window, a message
|
||
|
|
is issued at file creation time and the file is not created.</p>
|
||
|
|
<p>*SCRBAR
|
||
|
|
tells the system to use a graphical scroll bar for a graphical display. When
|
||
|
|
*SCRBAR is specified, the last 3 columns of the lines that the subfile is
|
||
|
|
using is reserved for the scroll bar. When *SCRBAR is used, a second parameter
|
||
|
|
can be specified. The second parameter tells the system what scrolling indicator
|
||
|
|
should be used for nongraphical displays. *SCRBAR is the default for those
|
||
|
|
displays. *MORE and *PLUS can be used for the second parameter. When *SCRBAR
|
||
|
|
is used the subfile must occupy at least 3 lines. SFLFOLD or SFLDROP will
|
||
|
|
work with scroll bars. Both versions of the subfile (folded or truncated)
|
||
|
|
must occupy three lines.</p>
|
||
|
|
<p>If the device configuration that is being used
|
||
|
|
supports a pointer device, the scroll bar can also navigate through the subfile.
|
||
|
|
For more information about how to support different device configurations
|
||
|
|
and how scroll bars are controlled using the PAGEUP, PAGEDOWN, and SFLSIZ
|
||
|
|
keywords, see the <a href="../books/sc415715.pdf" target="_blank">Application
|
||
|
|
Display Programming book</a><img src="wbpdf.gif" alt="Link to PDF" />.</p>
|
||
|
|
<p>An option indicator must be specified for this keyword.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Page through your program (SFLPAG equals SFLSIZ)</h4><p>Your program controls the display of the plus sign or the
|
||
|
|
More… or Bottom text through the use of the indicators on SFLEND. Set the
|
||
|
|
indicators off to display the plus sign or the More text. Set the indicators
|
||
|
|
on to remove the plus sign from the display or to display the Bottom text.
|
||
|
|
When the Page Up key is pressed, your program handles the processing. For
|
||
|
|
instance, it reads the subfile, clears it, rewrites the subfile with new records,
|
||
|
|
and displays it again. If your program does this, the display shows the plus
|
||
|
|
sign or the More text. If not, the plus sign disappears from the display or
|
||
|
|
the Bottom text appears.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> *SCRBAR can be used when SFLPAG equals SFLSIZ.
|
||
|
|
The scroll bar will be displayed with buttons, a shaft, and a scroll box which
|
||
|
|
covers the entire shaft.</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Page through <span class="keyword">i5/OS™</span> (SFLPAG
|
||
|
|
does not equal SFLSIZ)</h4><p>The <span class="keyword">i5/OS</span> operating
|
||
|
|
system displays the plus sign as long as there are more records in the subfile
|
||
|
|
to be displayed, no matter how the option indicator is set. The scroll bar
|
||
|
|
will display with the scroll box placed on the placed at a position on the
|
||
|
|
scroll bar that best represents where the user is in the subfile. When the
|
||
|
|
last page of the subfile is displayed, the <span class="keyword">i5/OS</span> operating
|
||
|
|
system displays the plus sign, the More... text, or the scroll bar with the
|
||
|
|
scroll box one page size above the scroll button if the indicator is off.
|
||
|
|
It does not display the plus sign, the Bottom text, or the scroll bar with
|
||
|
|
the scroll box on top of the bottom scroll button if the indicator is on.</p>
|
||
|
|
<p>Your
|
||
|
|
program must set the indicator on or off when displaying the subfile. (Your
|
||
|
|
program cannot find out, when the <span class="keyword">i5/OS</span> operating
|
||
|
|
system is paging through the subfile, which page of the subfile is displayed.)</p>
|
||
|
|
<p>If
|
||
|
|
your program sets off the indicator for SFLEND when displaying the subfile,
|
||
|
|
either the plus sign, the More text, or the scroll bar with the scroll box
|
||
|
|
one page size above, the scroll button is displayed with the last page of
|
||
|
|
the subfile. Because the plus sign is displayed but the <span class="keyword">i5/OS</span> operating
|
||
|
|
system cannot page the subfile any further, your program must provide for
|
||
|
|
any further paging. Specify the PAGEDOWN keyword on the subfile control record
|
||
|
|
format so that control is passed to your program when the Page Down key is
|
||
|
|
pressed again. When your program receives control, it can add more records
|
||
|
|
to the end of the subfile and use the SFLRCDNBR keyword to display a new page.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> If
|
||
|
|
the PAGEDOWN keyword is specified with a scroll bar, then control is passed
|
||
|
|
back to the program when a PAGEDOWN key is pressed or a manipulation of the
|
||
|
|
graphical scroll bar will display a partial page.</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Position of plus sign with *PLUS option</h4><p>For the
|
||
|
|
24 x 80 display size, positions 78 through 80 of the last line occupied by
|
||
|
|
the subfile are used for the beginning attribute character, plus sign, and
|
||
|
|
ending attribute character. For the 27 x 132 display size, positions 130 through
|
||
|
|
132 of the last line occupied by the subfile are used for the beginning attribute
|
||
|
|
character, plus sign, and ending attribute character.</p>
|
||
|
|
<div class="note"><span class="notetitle">Note:</span> If an input
|
||
|
|
field occupies the location of the plus sign and the field is changed, the
|
||
|
|
plus sign and its attribute characters are returned to the program as data
|
||
|
|
in the field. For selection lists, the plus will be positioned to the right
|
||
|
|
of the choices for the list.</div>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Position of More... and Bottom text with *MORE option</h4><p>For
|
||
|
|
the 24 x 80 display size, positions 67 through 80 of the line immediately
|
||
|
|
following the last line occupied by the subfile are used for the beginning
|
||
|
|
attribute character, right justified More… or Bottom text, and ending attribute
|
||
|
|
character. For the 27 x 132 display size, positions 119 through 132 of the
|
||
|
|
line immediately following the last line occupied by the subfile are used
|
||
|
|
for the beginning attribute character, right aligned More… or Bottom text,
|
||
|
|
and ending attribute character. For selection lists, the more and bottom text
|
||
|
|
will be positioned to the right of the choices for the list.</p>
|
||
|
|
</div>
|
||
|
|
<div class="section"><h4 class="sectiontitle">Position of the scroll bar with *SCRBAR option</h4><p>For
|
||
|
|
the 24 x 80 display size, positions 77 through 80 of every line of the subfile
|
||
|
|
will be reserved for the scroll bar. No fields of the subfile can use those
|
||
|
|
columns. Thus no fields can occupy more than one line of the subfile. Multiple
|
||
|
|
line subfiles can be used. For the 27 x 132 display size, positions 129 through
|
||
|
|
132 of every line of the subfile will be reserved for the scroll bar. For
|
||
|
|
selection lists, the scroll bar will be positioned to the right of the choices
|
||
|
|
for the list. For other subfiles, the scroll bar will be positioned on column
|
||
|
|
79.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example 1</h4><p>The following example shows how to specify
|
||
|
|
the SFLEND keyword without parameters.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A R SETSFL1 SFL
|
||
|
|
00020A 50 SFLNXTCHG
|
||
|
|
00030A SETSEL 1Y 0B 6 2VALUES(1 2 9) CHECK(AB)
|
||
|
|
00040A SETNAME 10A O 6 4
|
||
|
|
00050A R SETCTL1 SFLCTL(SETSFL1)
|
||
|
|
00060A SFLSIZ(34)
|
||
|
|
00070A SFLPAG(17)
|
||
|
|
00080A 40 SFLDSP
|
||
|
|
00090A 41 SFLDSPCTL
|
||
|
|
00100A 42 SFLDLT
|
||
|
|
00110A 43 SFLCLR
|
||
|
|
00120A 49 SFLEND
|
||
|
|
00130A N49 ROLLUP(26)
|
||
|
|
00140A SETRRN 4S 0H SFLRCDNBR(CURSOR)
|
||
|
|
A</pre>
|
||
|
|
<p>Paging is provided by the <span class="keyword">i5/OS</span> operating
|
||
|
|
system and the plus sign (+) appears in the lower right corner of the display.
|
||
|
|
When the last record is written to the subfile, indicator 49 is set on, which
|
||
|
|
disables the Page Down key and omits the plus sign from the display.</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example 2</h4><p>The following example shows how to specify
|
||
|
|
the SFLEND keyword with *MORE as a parameter.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A R SETSFL2 SFL
|
||
|
|
00020A 50 SFLNXTCHG
|
||
|
|
00030A SETSEL 1Y 0B 6 2VALUES(1 2 9) CHECK(AB)
|
||
|
|
00040A SETNAM 10A O 6 4
|
||
|
|
00050A R SETCTL2 SFLCTL(SETSFL2)
|
||
|
|
00060A SFLSIZ(34)
|
||
|
|
00070A SFLPAG(17)
|
||
|
|
00080A 40 SFLDSP
|
||
|
|
00090A 41 SFLDSPCTL
|
||
|
|
00100A 42 SFLDLT
|
||
|
|
00110A 43 SFLCLR
|
||
|
|
00120A 49 SFLEND(*MORE)
|
||
|
|
00130A N49 ROLLUP(26)
|
||
|
|
00140A SETRRN 4S 0H SFLRCDNBR(CURSOR)
|
||
|
|
A</pre>
|
||
|
|
<p>Paging is provided by the <span class="keyword">i5/OS</span> operating
|
||
|
|
system. The More… text appears at the lower right corner of the display on
|
||
|
|
the line immediately following the subfile if there are more records to see
|
||
|
|
in the subfile. When the last record is written to the subfile, indicator
|
||
|
|
49 is set on, which disables the Page Down key and causes the Bottom text
|
||
|
|
to appear instead of More….</p>
|
||
|
|
</div>
|
||
|
|
<div class="example"><h4 class="sectiontitle">Example 3</h4><p>The following example shows how to specify
|
||
|
|
the SFLEND keyword with *SCRBAR as a parameter.</p>
|
||
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
||
|
|
00010A R SETSFL2 SFL
|
||
|
|
00020A 50 SFLNXTCHG
|
||
|
|
00030A SETSEL 1Y 0B 6 2VALUES(1 2 9) CHECK(AB)
|
||
|
|
00040A SETNAM 10A O 6 4
|
||
|
|
00050A R SETCTL2 SFLCTL(SETSFL2)
|
||
|
|
00060A SFLSIZ(34)
|
||
|
|
00070A SFLPAG(17)
|
||
|
|
00080A 40 SFLDSP
|
||
|
|
00090A 41 SFLDSPCTL
|
||
|
|
00100A 42 SFLDLT
|
||
|
|
00110A 43 SFLCLR
|
||
|
|
00120A 49 SFLEND(*SCRBAR *MORE)
|
||
|
|
00130A N49 ROLLUP(26)
|
||
|
|
00140A SETRRN 4S 0H SFLRCDNBR(CURSOR)
|
||
|
|
A</pre>
|
||
|
|
<p>Paging is provided by the <span class="keyword">i5/OS</span> operating
|
||
|
|
system. The scroll bar will be displayed for graphical displays. If a graphical
|
||
|
|
display is not used, then the More…. text appears at the lower right corner
|
||
|
|
of the display on the line immediately following the subfile if there are
|
||
|
|
more records to see in the subfile. When the last record is written to the
|
||
|
|
subfile, indicator 49 is set on, which disables the Page Down key and causes
|
||
|
|
the Bottom text to appear instead of the More…. text. The scroll bar will
|
||
|
|
be displayed with the scroll box just above the bottom scroll button.</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="rzakcmstdfsfrol.htm" title="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.">SFLROLVAL (Subfile Roll Value) keyword for display files</a></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|