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

96 lines
5.9 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="SFLRCDNBR (Subfile Record Number) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword on the subfile control record format to specify that the page of the subfile to be displayed is the page containing the record whose relative record number is in this field." />
<meta name="description" content="Use this field-level keyword on the subfile control record format to specify that the page of the subfile to be displayed is the page containing the record whose relative record number is in this field." />
<meta name="DC.subject" content="SFLRCDNBR (Subfile Record Number) keyword, Subfile Record Number (SFLRCDNBR) keyword" />
<meta name="keywords" content="SFLRCDNBR (Subfile Record Number) keyword, Subfile Record Number (SFLRCDNBR) keyword" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfalwr.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="rzakcmstdfsfrnm" />
<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>SFLRCDNBR (Subfile Record Number) keyword for display files</title>
</head>
<body id="rzakcmstdfsfrnm"><a name="rzakcmstdfsfrnm"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">SFLRCDNBR (Subfile Record Number) keyword for display files</h1>
<div><p>Use this field-level keyword on the subfile control record format
to specify that the page of the subfile to be displayed is the page containing
the record whose relative record number is in this field.</p>
<div class="section"><p>If you do not specify this keyword, the <span class="keyword">i5/OS™</span> operating system
displays the first page of the subfile by default.</p>
<div class="p">The format of the
keyword is: <pre>SFLRCDNBR[([CURSOR] [*TOP])]</pre>
</div>
<p>If
CURSOR is specified, the cursor is placed in the subfile record whose relative
record number is identified by the contents of this field. The cursor is positioned
at the first input-capable field in the subfile record. If there is no input-capable
field, the cursor is positioned at the first output-only or constant field.
For example, if a page can contain three records, and nine records are contained
in the subfile, a SFLRCDNBR field value of 8 causes records 7, 8, and 9 to
be displayed. If CURSOR is specified, the cursor appears in record 8.</p>
<p>If
*TOP is specified, the subfile record whose relative record number is identified
by the contents of this field will display as the first record of the page
of the subfile records being displayed.</p>
<p>This field must be a zoned decimal
field with zero decimal positions. It must have the keyboard shift attribute
of signed numeric (S in position 35), and it can be up to 4 digits in length.
It must be defined as an output-only, an input/output, or a hidden field.
If a value less than 1 or a value greater than the number of records in the
subfile is contained in this field on an output operation to the subfile control
record format, an error is returned to your program.</p>
<p>This optional keyword
is valid only for the subfile control record format.</p>
<p>You cannot specify
both SFLRCDNBR and SFLROLVAL for the same field.</p>
<p>If the subfile record
format contains field selection, this keyword is not allowed.</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 SFLRCDNBR 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 DSPREC 4S 0B 4 12SFLRCDNBR(CURSOR)
A</pre>
<p>In this example, either the program or the workstation
user can set the value of the field before displaying the subfile.</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="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>
</div>
</body>
</html>